Qwen AI API 快速上手

驗證與 Base URL 設定

在儀表板生成您的 API 金鑰。基礎 URL 為 https://api.qwenaiapi.com/v1 且您在 Authorization 標頭。此設定適用於任何標準 OpenAI SDK 客戶端，無需更改程式碼。每個帳戶僅提供一個有效金鑰；生成新金鑰會立即使舊金鑰失效。註冊時無需提供手機號碼。

首次請求

向以下網址發送 POST 請求 /v1/chat/completions 搭配您的金鑰和模型 ID。模型識別碼為 uncensored 並回應標準的聊天訊息。您可以使用簡單的系統提示來測試連線，以驗證延遲和回應格式。401 錯誤表示金鑰無效，而 402 表示您的預付額度已耗盡。

Copycurl https://api.qwenaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize this pull request diff"}]
  }'

Python SDK 集成

使用官方 Python 客戶端與端點互動。在初始化參數中設定 base URL 和 API 金鑰。SDK 會自動處理分詞和 JSON 序列化。此方法在切換底層模型提供者的同時，保持現有應用程式邏輯不變。該客戶端支援同步和非同步操作。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.qwenaiapi.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 SDK 用法

使用您的基礎 URL 與金鑰初始化 Node.js 用戶端。套件支援標準的聊天完成請求。您可以設定模型 ID，以確保連接到 uncensored 端點。此整合非常適合需要程式化存取權的伺服器端應用程式。SDK 會為高流量請求有效管理連線集區。

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.qwenaiapi.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);

串流回應

透過設定 stream 設為 true。您會隨著 token 生成收到 server-sent events (SSE)。最後一個區塊包含用於計費目的的總 token 用量。這透過漸進式顯示文字來降低使用者的感知延遲。您必須正確處理串流以捕捉最終的使用數據。

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)

上下文視窗 & 限制

該模型支援 100,000 token 的上下文視窗，用於提示詞與補全的總和。每個請求最多可發送 16,000 個輸出 token。速率限制為每分鐘 300 個請求，每個金鑰最多 8 個併發請求。請求主體上限為 8 MB。了解這些限制有助於您有效批次處理請求，避免觸發 429 錯誤。錯誤不會消耗您的預付額度。