Qwen 用戶快速上手
將您現有的 OpenAI 相容客戶端連接到我們的無審查端點。更改基礎 URL,注入您的金鑰,即可開始發送請求。
uncensoredhttps://api.qwenapi.cc/v1
認證與基礎 URL
我們的 API 使用標準 Bearer token 認證。透過 Google 或電子郵件註冊後,您會立即獲得金鑰。請妥善保管此金鑰;它可存取您的預付額度。所有請求的基礎 URL 為 https://api.qwenapi.cc/v1。請更新您的客戶端設定,指向此端點而非預設的 OpenAI URL。
認證是透過在每個請求中傳遞 Authorization 標頭來處理。若無 API 金鑰,模型無法驗證您的帳戶餘額,將導致 401 錯誤。無需隱藏標頭或自訂認證機制。
首次請求
發送標準的聊天補全請求以測試連線。將 YOUR_API_KEY 替換為您的實際金鑰。該端點接受包含 model、messages 和 content 欄位的標準 JSON 載荷。
- 模型識別碼:
uncensored - 端點:
POST /v1/chat/completions - 格式:JSON
此請求將從您的餘額中消耗輸入 token。請確保您的客戶端正確處理 JSON 回應,以驗證連線是否正常運作。
Python SDK 整合
使用官方的 OpenAI Python 函式庫。它只需少量設定即可將流量路由至我們的端點。使用您的金鑰和正確的基礎 URL 初始化客戶端。此方法利用現有的程式碼庫,無需重寫請求邏輯。
建立回應時傳遞模型 ID uncensored。該函式庫會自動處理序列化和反序列化。此方法建議用於大多數後端整合和腳本工作流程。
Node SDK 整合
對於 JavaScript 或 TypeScript 環境,請使用 @anthropic-ai/sdk 或標準 OpenAI Node 套件。將基礎 URL 設定為指向我們的 API。這允許您將我們的服務嵌入現有的 Node 應用程式,而無需大幅重構。
請確保您使用的是支援自訂基礎 URL 的最新版本 SDK。傳遞模型識別碼 uncensored 以選擇我們的無審查模型。此設定可與 Express 路由或無伺服器函式無縫運作。
串流回應
在請求中設定 stream: true 以啟用串流。API 會在模型生成文字時返回伺服器發送的事件 (SSE)。這為最終使用者提供較低的延遲,並允許即時顯示輸出。
Token 使用統計資訊包含在串流的最後一個區塊中。請逐步處理每個增量以建立完整的回應。此功能對於聊天介面和需要即時回饋的應用程式至關重要。
限制、錯誤與上下文
請遵守速率限制以避免服務中斷。API 允許每分鐘 300 個請求,且每支金鑰最多允許 8 個並行請求。最大請求主體大小為 8 MB。若超過這些限制,您將收到 429 錯誤。
認證錯誤返回 401,表示金鑰無效或缺失。餘額錯誤返回 402,表示您的預付額度已耗盡。上下文視窗支援總計 100,000 token,每次請求的最大輸出為 32,000 token。錯誤和拒絕不會消耗額度。
cURL
curl https://api.qwenapi.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
from openai import OpenAI
client = OpenAI(base_url="https://api.qwenapi.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
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.qwenapi.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);串流
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)問答
我該如何處理速率限制?
API 限制每分鐘 300 個請求,且每支金鑰最多允許 8 個並行請求。若超過這些限制,API 會返回 429 狀態碼。請在客戶端實作指數退避機制,以優雅地處理重試。
API 支援函式呼叫嗎?
是的,API 支援標準 tools 格式的函式呼叫。您可以在請求中指定 tools 和 tool_choice,以啟用結構化輸出或外部工具整合。此功能與標準 OpenAI 相容架構相容。
如果我超出上下文視窗會發生什麼事?
模型支援總計 100,000 token 的上下文視窗,包含提示詞與補全。若超過此限制,請求將失敗。請確保您的應用程式追蹤 token 使用量,以保持在這些範圍內。
只差一張表單,即可取得金鑰
建立帳戶、複製金鑰、更改基礎 URL。這就是整個設定。
API 技術參數
購買額度前,請先確認介面是否符合你的需求——以下是全部真實參數。
| 項目 | 說明 |
|---|---|
| 介面格式 | 相容 OpenAI:任何 OpenAI SDK 只需更換 base URL 和金鑰 |
| 模型 ID | uncensored |
| Base URL | https://api.qwenapi.cc/v1 |
| 端點 | POST /v1/chat/completions · GET /v1/models |
| 驗證 | Authorization: Bearer YOUR_KEY |
| 最大輸出 | 不另設輸出上限;提示+回覆共 100,000 個 token 視窗內,max_tokens 可選 |
| 函式呼叫 | 支援 tools、tool_choice;回覆包含 tool_calls(串流同樣支援),結果以 role: tool 訊息回傳 |
| 串流輸出 | 支援 SSE,最後一段包含 token 用量 |
| 上下文視窗 | 100,000 tokens(輸入與輸出合計) |
| 取樣參數 | temperature、top_p、stop、seed、presence_penalty、frequency_penalty |
| JSON 模式 | response_format: {"type": "json_object"} |
| 並行請求 | 每把金鑰同時最多 8 個請求 |
| 回應標頭 | X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrency |
| 速率限制 | 每把金鑰每分鐘 300 次請求 |
| 請求大小 | 每次請求不超過 8 MB |
| 免費試用 | $0.50,有效期 7 天,不需信用卡 · 試用金鑰:2 個並行請求,每分鐘 60 次;首次儲值後恢復完整限額(8 和 300) |
| 計費 | 預付額度,按實際 token 用量扣費;錯誤和拒絕不收費 |
| 價格 | 輸入 $0.25 / 百萬 tokens · 輸出 $1.00 / 百萬 tokens |
| 贈送額度 | 滿 $50 送 5%,滿 $100 送 10% |
| 額度效期 | 付費額度永不過期,無訂閱 |
| 儲值 | USDT(TRC20)或 USDC(Base),$10–$500 任意整數金額 |
| 內容政策 | 允許成人內容;涉及未成年人的性內容一律拒絕 |
| 登入 | Google 或電子郵件 + 密碼 |
| 金鑰 | 每個帳戶一把有效金鑰;產生新金鑰後舊金鑰失效 |
錯誤代碼
錯誤以 JSON 回傳,type 欄位固定;失敗或被拒絕的請求不計費。
| 狀態碼 | 類型 | 含義 |
|---|---|---|
400 | bad_request | JSON 無效、訊息為空、參數錯誤或超出上下文視窗 |
401 | missing_key · invalid_key · key_revoked | 缺少金鑰、金鑰錯誤或已被新金鑰取代 |
402 | no_credit | 餘額不足——儲值後立即恢復 |
403 | content_blocked | 涉及未成年人的性內容——拒絕且不計費 |
404 | not_found | 未知端點 |
413 | request_too_large | 請求內容超過 8 MB |
429 | rate_limited · concurrency | 超過每分鐘 300 次或 8 個並行——稍後重試 |
503 | upstream_busy | 模型忙碌——幾秒後重試 |