中文 ▾
获取 API 密钥

uncensoredqwen.com指南

Qwen API 密钥用于 VS Code:自定义接口设置

要使用用于 VS Code 的 qwen API 密钥,你不需要阿里巴巴特定的插件。任何支持 OpenAI 兼容提供商的扩展都接受三个值:Base URL、密钥和模型名称。本指南提供精确值以及用于捕获常见错误的检查步骤。

更新于

等距代码编辑器面板,金色密钥插入链接到服务器的接口插座

打开 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 密钥你账户中的密钥
模型 IDuncensored

读取 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

编辑器很少告诉你哪个服务器做出了响应。两个快速检查可以消除疑虑。

  1. 关注余额。 从终端运行 /v1/models 或简短的补全请求,记录 X-Balance-USD 响应头,在编辑器中发送三条聊天消息,然后再次运行终端请求。数字应减少一小部分。该数值也可通过 GET /v1/balance 获取。
  2. 请求默认设置会拒绝或不同处理的内容。 一个微小且无害的测试是请求回复恰好五个单词。如果回答遵循指令并以流式输出到达,则连接健康。

如果余额没有变化,打开扩展的输出面板或开发者控制台。大多数扩展记录请求 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 错误的早期文章列出了更多错误模式及修复方法。

问答

我如何获取 VS Code 的 Qwen API 密钥?

在网站上注册,打开 API 密钥页面并创建一个密钥。你还可以通过该页面领取一键 $0.50 免费试用额度,无需绑定银行卡。

我在扩展程序中应输入什么 Base URL?

使用 https://api.uncensoredqwen.com/v1 并去掉 /chat/completions。模型 ID 为 uncensored。

为什么我的扩展程序返回 401?

密钥通常有误、包含多余空格或属于其他账户。请重新复制密钥,并使用 curl 调用 /v1/models 进行测试。

我可以将其用于 Tab 自动补全吗?

它可通过 OpenAI 兼容的自动补全设置工作,但频繁请求可能会达到每分钟 60 次的试用限制。完整密钥允许每分钟 300 次。

只差一张表单,即可获得密钥

创建账户,复制密钥,更改基础 URL。这就是全部设置。

获取 API 密钥