打开 VS Code 前你需要什么
用于 VS Code 的 qwen API 密钥只是一个 API 密钥加上扩展中的正确接口设置。首先收集这三个值:
- Base URL:
https://api.uncensoredqwen.com/v1 - 模型 ID:
uncensored - API 密钥: 在你使用 Google 或邮箱密码注册后,在 API 密钥页面 创建
新账户可以在该页面一键领取 $0.50 免费试用额度。无需银行卡,每人限领一次,有效期为 7 天。这足以在几天的实际编码中测试编辑器设置。
关于命名的说明:该服务是由独立提供商托管运行的开放权重模型。它不是阿里巴巴的官方 API,也不是通往其他供应商的路由器。在你的编辑器中,它将显示为你赋予它的任何显示名称。
先用 curl 测试密钥
在更改任何编辑器设置之前,请确认密钥和 URL 能否独立运行。如果这步失败,任何扩展都无法成功,你将知道问题出在密钥而不是插件上。
export API_KEY="paste-your-key-here"
curl https://api.uncensoredqwen.com/v1/models \
-H "Authorization: Bearer $API_KEY"
包含 uncensored 的 JSON 列表表示认证有效。然后发送一次实际的补全请求:
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 Python function that reverses a string."}],"max_tokens":200}'
响应头包括 X-Balance-USD,这是一种在不离开终端的情况下查看剩余额度的快速方法。
在 VS Code 扩展中添加提供商
几种用于 AI 代码辅助的 VS Code 扩展可以与任何 OpenAI 兼容的服务器通信。标签因工具而异,但字段一一对应。寻找名为“OpenAI Compatible”、“OpenAI”(带自定义 Base URL)或“Custom endpoint”的提供商选项。
| 扩展字段 | 输入的值 |
|---|---|
| 提供商 | OpenAI 兼容(或带自定义基础 URL 的 OpenAI) |
| Base URL / API 基础 | https://api.uncensoredqwen.com/v1 |
| API 密钥 | 你账户中的密钥 |
| 模型 ID | uncensored |
读取 JSON 配置文件的扩展通常期望类似这样的结构。具体的密钥名称可能有所不同,因此请查看你的扩展文档并调整字段名称:
{
"models": [
{
"title": "Uncensored API",
"provider": "openai",
"model": "uncensored",
"apiBase": "https://api.uncensoredqwen.com/v1",
"apiKey": "paste-your-key-here"
}
]
}
不要提交此文件。如果你的设置位于仓库内,请使用扩展的密钥存储或环境变量,并将配置路径添加到 .gitignore 中。
保存后,打开扩展的聊天面板并发送一条简短消息,例如“解释此函数”,同时打开一个文件。流式输出答案意味着设置已完成。
修复常见的配置错误
大多数失败的设置归结为一些拼写错误。按顺序检查此列表。
URL 格式错误
Base URL 以 /v1 结束。扩展会自动添加 /chat/completions。如果你粘贴完整路径,会收到 404 错误,因为客户端请求的是 /v1/chat/completions/chat/completions。末尾的斜杠通常无害,但缺少 /v1 则不行。
模型名称错误
某些扩展会从其他服务预填充模型下拉菜单的名称。请将其精确覆盖为小写的 uncensored。如果该字段是下拉菜单且没有自定义输入选项,请查找“自定义模型”或“其他”选项。
密钥包含多余字符
从网页复制可能会添加末尾空格或换行符。粘贴到纯文本编辑器中,去除首尾空格,然后再次粘贴。401 响应几乎总是指向此问题或来自不同账户的密钥。
扩展仍在与其默认服务器通信
如果聊天请求后余额没有变化,编辑器可能正在使用内置提供商。请检查当前激活的模型配置是否为你编辑的那个,并在更改设置后重新加载窗口。
请求因 429 错误失败
这是速率限制,在下一节中介绍。错误正文包含一个指示你触及哪个限制的代码。
检查请求是否真正到达 API
编辑器很少告诉你哪个服务器做出了响应。两个快速检查可以消除疑虑。
- 关注余额。 从终端运行
/v1/models或简短的补全请求,记录X-Balance-USD响应头,在编辑器中发送三条聊天消息,然后再次运行终端请求。数字应减少一小部分。该数值也可通过GET /v1/balance获取。 - 请求默认设置会拒绝或不同处理的内容。 一个微小且无害的测试是请求回复恰好五个单词。如果回答遵循指令并以流式输出到达,则连接健康。
如果余额没有变化,打开扩展的输出面板或开发者控制台。大多数扩展记录请求 URL 和 HTTP 状态,错误的主机会立即显现。修复 Base URL,重新加载窗口并重试。
共享存储库的团队应为每个人提供单独的密钥,而不是一个共享值。这样,一个人触发的速率限制不会阻止其他人,并且泄露的密钥可以在不干扰其他人的情况下替换。
自动补全、聊天和速率限制
聊天对限制很友好:每条消息一个请求。内联自动补全则不同。许多扩展在打字短暂暂停时发送请求,这可能会在你在工作时产生每分钟数十次调用。
了解数字。完整密钥允许 8 个并发请求和每分钟 300 个请求。试用密钥允许 2 个并发和每分钟 60 个请求。超过限制时,API 会回复 HTTP 429 以及代码 rate_limited(每分钟过多)或 concurrency(同时过多)。在临时过载时,你还会收到带有 Retry-After: 5 头的 429 错误。流式补全会占用其并发槽位直到流结束,因此慢速流会占用你更长时间。
有助于的实际设置:
- 将服务用于聊天、编辑和解释,并在试用密钥期间关闭 Tab 自动补全或增加其防抖延迟。
- 将自动补全的最大输出 token 数降低到几十。短补全完成得快并释放槽位。
- 在试用期间避免针对同一密钥运行多个编辑器窗口。
失败或拒绝的请求不会收费,因此错误仅消耗时间,不产生费用。
编码会话的成本
编码提示词输入量较大,因为扩展程序会附加文件内容。输入 token 的定价为每 100 万 token $0.15,输出 token 为每 100 万 token $0.50。考虑一次对话轮次:发送 6,000 个 token 的代码和上下文,并接收 800 个 token 的返回:
- 输入:6,000 x $0.15 / 1,000,000 = $0.0009
- 输出:800 x $0.50 / 1,000,000 = $0.0004
- 总计:每轮 $0.0013
在工作日内进行 100 次此类对话为 $0.13。$0.50 试用额度可覆盖约 380 次此类对话($0.50 / $0.0013 约为 385)。额度为预付额度,永不过期,充值金额为 $20 至 $500 的整数,满 $50 赠 5%,满 $100 赠 10%,满 $200 赠 15%。请参阅 定价页面 了解支付方式。
上下文窗口为 100,000 个 token,包含提示词和补全内容。如果扩展程序将你的整个代码库索引到每个提示词中,大型请求的成本将更高并接近该上限。请将上下文限制在你实际需要的文件范围内。
隐私及更多信息
提示词不用于训练。尽管如此,源代码通常包含密钥,因此请保持 .env 文件和凭据不附加到聊天中。大多数扩展允许你将路径从上下文中排除。
该模型仅支持文本。它可回答编码问题、起草函数、解释错误,并支持函数调用和 JSON 模式,但不生成图像、音频或视频。有关超出此页面的请求字段和示例,请阅读 API 文档。如果经过上述检查后仍有问题,关于 常见 Qwen API 错误的早期文章列出了更多错误模式及修复方法。
