开发工具接入¶
支持自定义「OpenAI 兼容」地址的工具，可以按以下方式尝试接入腾讯公益推理平台。具体功能取决于工具版本和模型能力。不同工具的设置界面不同，需要填的只有三项：
设置项 |
填写 |
|---|---|
Base URL（API 地址） |
|
API Key |
|
模型 |
模型 ID，例如 |
小技巧
Cline、Roo Code、Kilo Code 这类编程助手每次请求都带有很长的系统提示和工具定义，并依赖工具调用来读写文件。请在模型列表里选择支持工具调用、上下文尽量长的模型；上下文较短的模型很快就会触发长度限制。
使用 Claude Code 请看单独的 Claude Code 页面，它走的是 Anthropic 兼容接口。
Cline¶
Cline 是 VS Code 中的自主编程助手。
在 VS Code 扩展市场安装 Cline。
打开侧边栏中的 Cline 面板，点击设置（齿轮图标）。
API Provider 选择 OpenAI Compatible。
填写：
Base URL：
https://freeinference.qq.com/v1API Key：你的 API Key
Model ID：
deepseek-v4.1-flash
保存后发送一条简短的消息，确认能收到回复。
Roo Code 与 Kilo Code¶
在 IDE 中安装扩展，打开扩展的设置。
API Provider 选择 OpenAI Compatible。
填写 Base URL
https://freeinference.qq.com/v1和你的 API Key。模型填写
deepseek-v4.1-flash。如果模型下拉列表为空，直接粘贴模型 ID。保存设置，开启一个新会话验证连接。
Continue¶
Continue 是 VS Code 和 JetBrains 上的开源编程助手。打开 Continue 的配置文件（命令面板中执行 Continue: Open Config），在 models 下加入一项，与已有配置合并，不要整体覆盖：
models:
- name: 腾讯公益推理平台
provider: openai
model: deepseek-v4.1-flash
apiBase: https://freeinference.qq.com/v1
apiKey: 你的 API Key
保存后，模型会出现在 Continue 的模型下拉列表中。
Cursor¶
Cursor 可以用自定义的 OpenAI 兼容地址调用模型。
打开 Cursor 设置（macOS：
Cmd + ,；Windows / Linux：Ctrl + ,），进入 Models。在 OpenAI API Key 中填入你的 API Key，并打开该开关。
打开 Override OpenAI Base URL，填入
https://freeinference.qq.com/v1。添加自定义模型
deepseek-v4.1-flash并选中它。
备注
Cursor 的请求由 Cursor 自己的服务器转发，而不是从你的电脑直接发出，因此只能使用公网可以访问的服务地址。
Cherry Studio¶
Cherry Studio 是常用的桌面对话客户端。
打开 设置 → 模型服务，点击 添加，提供商类型选择 OpenAI。
API 密钥填你的 API Key。
API 地址填
https://freeinference.qq.com，不带/v1：Cherry Studio 会自动补全路径。填好后，输入框下方预览的完整地址应为https://freeinference.qq.com/v1/chat/completions。在 模型 中添加
deepseek-v4.1-flash，然后点击 检查 测试连接。
Aider¶
Aider 是命令行编程助手，通过环境变量配置：
export OPENAI_API_BASE="https://freeinference.qq.com/v1"
export OPENAI_API_KEY="你的 API Key"
aider --model openai/deepseek-v4.1-flash
模型名前的 openai/ 前缀告诉 Aider 使用 OpenAI 兼容接口，不属于模型 ID 的一部分。
在代码中使用¶
任何 OpenAI SDK 或兼容库都可以直接使用，只需设置 base URL、API Key 与模型 ID。以 Python 版 LangChain 为例：
import os
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(
base_url="https://freeinference.qq.com/v1",
api_key=os.environ["TENCENT_INFERENCE_API_KEY"],
model="deepseek-v4.1-flash",
)
print(llm.invoke("你好").content)
OpenAI 官方 SDK 的 Python、Node.js 示例见快速开始。
常见问题¶
- 提示 401
Missing API key表示请求没有带上密钥；Invalid or expired API key表示密钥无效，或已在控制台删除、重新生成。检查 API Key 是否完整复制；使用环境变量时，确认当前终端里已经设置，使用 FAQ 中的检查命令，不要直接打印密钥。- 提示 404，或请求地址里出现
/v1/v1 Base URL 应当恰好以一个
/v1结尾：https://freeinference.qq.com/v1。Cherry Studio 这类会自动补全路径的工具，填不带/v1的https://freeinference.qq.com。- 提示模型不存在
模型 ID 必须与模型列表或
GET /v1/models返回的 ID 完全一致（区分大小写），并且对你的账号开放。- 提示 429
最常见的是
Too many concurrent requests：编程助手同时发出的请求超过了账号的并发上限，稍后重试或减少同时运行的会话即可。其他情况见 API 参考。- 模型列表为空或没有刷新
重新打开工具的设置面板，或手动粘贴模型 ID。
更多错误码见 API 参考。
工具官方文档¶
界面名称可能随版本变化；核心配置始终是 API 地址、API Key 和账号可用的模型 ID。