Kimicode 用戶快速上手指南

前置條件

在編寫程式碼之前，請使用 Google 或電子郵件在 kimicode.cc 建立帳戶。您將立即收到單一 API 金鑰。無需電話驗證，也無需信用卡。您的帳戶將獲得 $0.50 的免費試用額度，有效期為七天。如果需要更多容量，請透過加密貨幣（TRC20 上的 USDT 或 Base 上的 USDC）進行儲值，最低金額為 $10。額度永不過期，且錯誤或拒絕不會消耗 token。

確保您的開發環境已安裝 Node.js (v18+) 或 Python 3.8+。此 API 嚴格遵循 openai 客戶端規範，這意味著您可以在不更改程式庫邏輯的情況下將端點替換為我們的端點。我們提供一個 ID 為 uncensored 的無審查模型。

安裝 SDK

為您偏好的語言安裝官方 OpenAI SDK。這可確保與我們的串流輸出、函式呼叫和 JSON 模式功能相容。

對於 Python，請使用 pip 安裝標準程式庫：

• pip install openai

對於 Node.js，請安裝 npm 套件：

• npm install openai

這些程式庫會自動處理 HTTP 格式化。您不需要供應商專屬的客戶端。kimicode API 接受標準參數，如 temperature、top_p 和 max_tokens。

初始化客戶端

使用 kimicode 基礎 URL 和您的 API 金鑰配置客戶端物件。基礎 URL 為 https://api.kimicode.cc/v1。將 api_key 設定為您註冊時收到的值。此設定將取代預設的 api.openai.com 端點。

• 基礎 URL： https://api.kimicode.cc/v1
• 模型： uncensored
• 驗證： 透過 api_key 的 Bearer token

不要將此金鑰與其他供應商混用。它僅適用於 kimicode 端點。客戶端將在第一次請求時驗證金鑰。如果金鑰無效，您將立即收到 401 錯誤。

發送請求

發送標準的聊天完成請求。模型 ID 必須為 uncensored。您可以將 max_tokens 調整至多 32,000。如果省略，預設值為 2,048。上下文視窗總共為 100,000 token，包含提示詞和補全內容。

• 輸入： messages 陣列中的文字訊息。
• 輸出： choices[0].message.content 中的文字回應。

此端點支援透過 response_format: {"type": "json_object"} 的 JSON 模式。它不支援嵌入、影像或音訊。專注於無內容拒絕的高品質文字生成，適用於合法成人主題。

串流回應

設定 stream: true 以啟用串流輸出。API 會傳回伺服器發送事件（SSE）。每個區塊包含部分文字。Token 使用統計資訊包含在串流的最後一個區塊中。這允許即時顯示輸出，無需等待完整回應。

• 串流旗標： 在請求主體中設定為 true。
• 事件類型： chat.completion.chunk
• 資料： 包含文字部分的 delta.content。

串流不會改變定價。您為處理的總 token 付費。串流期間的錯誤會得到妥善處理。如果連線中斷，您可以重新啟動請求。無審查模型在 100k 限制內的長串流中仍能保持連貫性。

限制、錯誤與上下文

監控您的使用限制：每支金鑰每分鐘 300 個請求、8 個並行請求，以及 8 MB 的請求主體。如果您超過速率限制，將收到 429 錯誤。如果您的預付額度已耗盡，將收到 402 錯誤；請透過加密貨幣儲值以恢復使用。401 錯誤表示 API 金鑰無效或缺失。請注意，失敗的請求和拒絕不會消耗 token。硬性內容限制會封鎖涉及未成年人的性內容。所有其他合法的成人內容均允許。

函式呼叫

在 tools 參數中定義工具。模型會在回應中傳回工具呼叫。使用 tool_choice 強制執行特定行為。此功能與 OpenAI 標準完全相同。在程式碼中解析工具呼叫並執行它們。將結果傳回後續訊息中。kimicode API 能有效處理工具定義。確保您的 JSON 結構描述有效。函式呼叫除了 token 使用外，不需要額外額度。這非常適合建構代理程式或結構化資料擷取工作流程。

cURL

Copycurl https://api.kimicode.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.kimicode.cc/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.kimicode.cc/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

串流輸出

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)