Qwen AI API 快速入门

认证与基础 URL 设置

在仪表板生成您的 API 密钥。基础 URL 为 https://api.qwenaiapi.com/v1 并且你将密钥传递到 Authorization header. 此配置适用于任何标准 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。您接收生成的令牌时的服务器发送事件 (SSE)。最后一个数据块包含用于计费的总令牌使用情况。这通过渐进式显示文本降低了用户的感知延迟。您必须正确处理流以捕获最终的使用数据。

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 错误。错误不会消耗你的预付费额度。