基礎 URL 與驗證
使用提供的基礎 URL 和有效的 API 金鑰連接您的客戶端。端點為 https://api.qwencodeapikey.com/v1. 您必須在 Authorization 每次請求的標頭。這確保服務能正確識別您的預付信用額度帳戶。
curl https://api.qwencodeapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Check my api key validity status"}]
}'
您可以在註冊頁面透過 Google 或電子郵件生成金鑰。金鑰將立即顯示。請妥善保管，因為它控制著您的支出。
聊天完成端點
發送訊息至 /v1/chat/completions 用於取得文字回應的端點。這是大多數 OpenAI SDK 的標準介面。您定義 model 作為 uncensored 並在請求主體中提供訊息列表。 messages 陣列。API 會處理您的輸入並返回生成的補全內容。
from openai import OpenAI
client = OpenAI(base_url="https://api.qwencodeapikey.com/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)
確保您的客戶端程式庫指向正確的基礎 URL。模型 ID uncensored 觸發經過微調、拒絕率較低的開放權重模型。它處理對話輪次的方式與其他聊天 API 完全相同。
模型端點
查詢 GET /v1/models 驗證可用的模型及其詳細資訊。此端點回傳您的金鑰可存取的所有模型列表。這有助於您確認 uncensored 該模型處於活躍狀態，可接受請求。在發送完整負載之前，請使用此功能除錯客戶端配置。
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.qwencodeapikey.com/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);
檢查回應結構，以確保您的 SDK 能正確解析模型列表。此端點不消耗信用額度，因此非常適合用於初始化檢查。
請求參數與流式傳輸
支援標準參數，例如 temperature, top_p, stop，以及 seed. 透過設定 stream: true. API 透過伺服器發送事件（SSE）傳送 token。Token 使用統計資料出現在串流的最後一個區塊中。這允許即時顯示生成的文字。
stream = 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)
設定 max_tokens 用於控制輸出長度。預設值為 2,048 個 token。您可以將此值增加至每個請求 16,000 個 token。調整參數以平衡回應中的創意與精確度。
速率限制與限制條件
每個金鑰允許每分鐘 300 次請求與 8 個併發請求。最大請求主體大小為 8 MB。這些限制可防止濫用並確保穩定的效能。若超出速率限制，您將收到 429 錯誤。請調整客戶端邏輯，以指數退避方式處理重試。
上下文視窗支援 100,000 個 token 總量。這包括提示詞與補全。大型上下文需要謹慎的 token 管理以保持在限制內。
JSON 模式與函式呼叫
使用 response_format: {"type": "json_object"} 用於結構化輸出。這能確保模型回傳有效的 JSON，有助於程式化整合。函式呼叫透過 tools 參數。以標準 OpenAI 格式定義工具。模型將根據需要呼叫函式。
錯誤與拒絕不消耗信用額度。即使模型因硬性內容限制而拒絕請求，此規則仍適用。您只需為實際 token 使用量付費。信用額度永不過期，因此您可以隨時方便時充值。
錯誤處理與使用
優雅地處理 HTTP 錯誤。401 錯誤表示無效或過期的 API 金鑰。402 錯誤表示您的預付餘額已耗盡。429 錯誤表示超出速率限制。請檢查回應主體以獲取詳細的錯誤訊息。
用量按金鑰追蹤。每個帳戶一個活躍金鑰簡化了計費。如果您犯錯，例如重複扣款，請使用支援頁面。餘額不會退還，但保持有效。錯誤是免費的，因此失敗的請求不會消耗您的餘額。
摘要與最佳實踐
以基礎 URL 和有效金鑰開始。使用 uncensored 模型 ID 以減少拒絕回應。串流回應以獲得更好的使用者體驗。監控速率限制以避免中斷。使用 JSON 模式處理結構化資料。處理錯誤以維持可靠性。信用額度為預付且永不過期。需要時使用加密貨幣儲值。此 API 可無縫整合至現有的 OpenAI 程式碼庫。無需新的 SDK。只需更改 Base URL 和金鑰。
