Qwen 用戶的快速入門
使用我們的 OpenAI 相容 API,將無審查的 Qwen 模型整合至你的應用程式。本指南涵蓋設定、基本請求、串流輸出及錯誤處理,以加速開發。
https://api.uncensoredqwen.com/v1uncensored
前置條件與驗證
開始前,你需要一個 API 金鑰。前往取得 API 金鑰頁面,僅使用電子郵件和密碼即可建立帳戶。開始時不需要信用卡,新帳戶會獲得 7 天有效的 $0.50 試用額度。在您的 API 金鑰頁面一鍵領取此額度。金鑰會在註冊後立即顯示。
所有請求都必須包含Authorization: Bearer <your-api-key>標頭。如果看到 401 錯誤,請確認金鑰是否正確。如果你重新產生金鑰,舊金鑰會立即被撤銷,但你的速率限制計數器不會重置。
基本聊天補全
發送簡單的文字提示詞以生成回應。我們的 API 接受標準的 OpenAI 負載格式。模型 ID 為uncensored,並支援 100,000 token 的上下文視窗,用於合併的輸入與輸出。
- Base URL:
https://api.uncensoredqwen.com/v1 - 端點:
POST /v1/chat/completions
以下是使用 cURL 的基本請求範例:
curl https://api.uncensoredqwen.com/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 SDK 整合
使用官方的 OpenAI Python 用戶端與我們的 API 互動。將用戶端指向我們的 Base URL 並提供你的金鑰。這允許你使用熟悉的chat.completions.create等方法。
- 安裝用戶端:
pip install openai - 將
base_url設定為https://api.uncensoredqwen.com/v1
實作範例:
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredqwen.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)
Node.js SDK 用法
對於 JavaScript 環境,請使用openainpm 套件。使用我們的 Base URL 和 API 金鑰配置用戶端以發送請求。此方法適用於伺服器端和基於瀏覽器的應用程式。
- 安裝:
npm install openai - 配置
baseUrl和apiKey
Node.js 範例程式碼:
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredqwen.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);
串流回應
透過啟用串流即時接收 token。在請求中設定stream: true以獲取伺服器發送事件(SSE)串流。這可降低使用者等待長回應時的感知延遲。
- 以區塊處理串流
- 串接 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)
限制、錯誤與上下文
監控你的使用情況以避免中斷。API 對每個金鑰實施每分鐘 300 次請求的限制。如果超過此限制,你將收到 429 錯誤。請求主體必須在 8 MB 以下。
常見錯誤包括:
- 401 未授權: API 金鑰無效或已撤銷。
- 402 需付款:預付額度不足。請儲值至少 $20。
- 429 請求過多: 超過速率限制。
重新產生金鑰會撤銷舊金鑰,但不會重置速率限制計數器。
API 技術參數
購買額度前,請先確認介面是否符合你的需求——以下是全部真實參數。
| 項目 | 說明 |
|---|---|
| 介面格式 | 相容 OpenAI:任何 OpenAI SDK 只需更換 base URL 和金鑰 |
| 模型 ID | uncensored |
| Base URL | https://api.uncensoredqwen.com/v1 |
| 端點 | POST /v1/chat/completions · GET /v1/models |
| 驗證 | Authorization: Bearer YOUR_KEY |
| 最大輸出 | 不另設輸出上限;提示+回覆共 100,000 個 token 視窗內,max_tokens 可選 |
| 串流輸出 | 支援 SSE,最後一段包含 token 用量 |
| 函式呼叫 | 支援 tools、tool_choice;回覆包含 tool_calls(串流同樣支援),結果以 role: tool 訊息回傳 |
| 取樣參數 | temperature、top_p、stop、seed、presence_penalty、frequency_penalty |
| JSON 模式 | response_format: {"type": "json_object"} |
| 上下文視窗 | 100,000 tokens(輸入與輸出合計) |
| 請求大小 | 每次請求不超過 8 MB |
| 回應標頭 | X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrency |
| 速率限制 | 每把金鑰每分鐘 300 次請求 |
| 並行請求 | 每把金鑰同時最多 8 個請求 |
| 額度效期 | 付費額度永不過期,無訂閱 |
| 儲值 | USDT(TRC20)或 USDC(Base),$20–$500 任意整數金額 |
| 計費 | 預付額度,按實際 token 用量扣費;錯誤和拒絕不收費 |
| 免費試用 | $0.50,有效期 7 天,不需信用卡 · 試用金鑰:2 個並行請求,每分鐘 60 次;首次儲值後恢復完整限額(8 和 300) |
| 價格 | 輸入 $0.15 / 百萬 tokens · 輸出 $0.50 / 百萬 tokens |
| 贈送額度 | 滿 $50 送 5%,滿 $100 送 10%,滿 $200 送 15% |
| 登入 | 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 | 模型忙碌——幾秒後重試 |
問答
上下文視窗的大小是多少?
該模型支援 100,000 token 的上下文視窗,包含提示詞與補全內容。這允許在單一請求中處理大量的輸入與輸出。
重新產生 API 金鑰會重置速率限制嗎?
不會。重新產生金鑰會立即撤銷舊金鑰,但你的速率限制計數器會從原來的狀態繼續。你不會從頭開始。
有內容限制嗎?
該模型對於合法的成人、虛構及爭議性主題是無審查的。然而,包含未成年人性內容的請求一律會被封鎖。
只差一張表單,即可取得金鑰
建立帳戶、複製金鑰、更改 Base URL。這就是整個設定過程。
取得 API 金鑰