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以获取 Server-Sent Events (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 密钥