千支API 接入文档

开始前准备

1. 登录本站控制台，进入“令牌”或“Token”页面。
2. 创建一个新的 API 令牌并复制保存。令牌只显示一次，请勿公开分享。
3. 进入模型列表，复制你要使用的模型名称，填写到客户端的 Model ID。
4. 如果客户端要求 Provider，优先选择 OpenAI Compatible 或 OpenAI API Compatible。

通用填写规则

Cursor

1. 打开 Cursor Settings，进入 Models。
2. 在 API Keys 区域启用或添加 OpenAI API Key，填入本站令牌。
3. 启用 Override OpenAI Base URL，填入 https://qianzhiapi.com/v1。
4. 点击 Add Custom Model，填入本站模型名，并确保该模型已启用。
5. 在聊天或 Agent 面板的模型选择器中选择刚添加的模型。

如果 Cursor 内置模型还能用，但自定义中转报错，优先检查：模型名是否正确、Base URL 是否只到 /v1、令牌额度是否充足。

VS Code：Cline

1. 打开 Cline 面板，点击设置齿轮。
2. API Provider 选择 OpenAI Compatible。
3. Base URL 填 https://qianzhiapi.com/v1。
4. API Key 填本站令牌。
5. Model ID 填本站模型名，点击 Verify 或保存后测试。

VS Code：Roo Code

1. 打开 Roo Code 侧边栏，进入设置。
2. API Provider 选择 OpenAI Compatible。
3. Base URL 填 https://qianzhiapi.com/v1。
4. API Key 填本站令牌，Model ID 填本站模型名。
5. 保存后发一条简单消息测试，例如“你好”。

VS Code / JetBrains：Continue

在 Continue 的 config.yaml 中添加模型配置：

name: My Config
version: 0.0.1
schema: v1

models:
  - name: 千支API
    provider: openai
    model: gpt-4o-mini
    apiBase: https://qianzhiapi.com/v1
    apiKey: sk-你的令牌

部分 Continue 版本或迁移后的配置会把 apiBase 称为 baseUrl。 如果当前版本提示字段无效，请按扩展内配置提示调整字段名。

Kilo Code / 其他 OpenAI 兼容 Agent

1. Provider 选择 OpenAI Compatible。
2. Base URL 填 https://qianzhiapi.com/v1。
3. API Key 填本站令牌。
4. Models 手动添加本站模型名，或使用客户端自动拉取的模型列表。

中国国产 Agent / IDE 接入

下列工具按“是否能自定义 OpenAI 兼容接口”来整理。能填写 Base URL 或完整 /chat/completions 地址的工具，可以直接接本站； 只能登录官方账号、不能改接口地址的工具，不能直接接中转站。

Qwen Code（阿里开源编码 Agent）

Qwen Code 支持通过 settings.json 配置 OpenAI-compatible 模型服务商。 编辑 ~/.qwen/settings.json：

{
  "modelProviders": {
    "openai": {
      "protocol": "openai",
      "models": [
        {
          "id": "gpt-4o-mini",
          "name": "千支API",
          "baseUrl": "https://qianzhiapi.com/v1",
          "envKey": "QIANZHI_API_KEY"
        }
      ]
    }
  },
  "env": {
    "QIANZHI_API_KEY": "sk-你的令牌"
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "gpt-4o-mini"
  }
}

启动后可用 /model 切换模型。

腾讯 CodeBuddy IDE / CodeBuddy Code

CodeBuddy 的自定义模型使用 models.json。注意它通常要求填写完整 /v1/chat/completions 地址，而不是只填 /v1。

{
  "models": [
    {
      "id": "gpt-4o-mini",
      "name": "千支API gpt-4o-mini",
      "vendor": "OpenAI",
      "apiKey": "sk-你的令牌",
      "url": "https://qianzhiapi.com/v1/chat/completions",
      "supportsToolCall": true,
      "supportsImages": false
    }
  ],
  "availableModels": ["gpt-4o-mini"]
}

常见路径：macOS / Linux 为 ~/.codebuddy/models.json， Windows 为 C:\Users\你的用户名\.codebuddy\models.json。 保存后重启 CodeBuddy，使用 /model 检查模型是否出现。

TRAE / Trae CN

1. 进入模型管理，添加自定义模型。
2. 服务商优先选择 OpenAI、OpenAI 协议 或 OpenAI Compatible。
3. 如果界面要求 Base URL，填 https://qianzhiapi.com/v1。
4. 如果界面要求 完整请求地址，填 https://qianzhiapi.com/v1/chat/completions。
5. API Key 填本站令牌，模型 ID 填本站模型名。

TRAE 不同版本的自定义模型界面差异较大。若当前版本没有 API 地址、Base URL、 自定义请求地址等字段，就无法直接接本站中转；可在 TRAE 中安装 Cline / Roo Code 类插件，再按插件的 OpenAI Compatible 方式接入。

华为 CodeArts Agent / AgentArts

1. 进入企业设置或平台后台的 模型配置、自定义模型 页面。
2. 新建 OpenAI 协议或 OpenAI 兼容模型。
3. 模型 ID 填本站模型名，例如 gpt-4o-mini。
4. 模型 URL / API 基础路径填 https://qianzhiapi.com/v1。
5. API Key 填本站令牌，保存后先做连通性测试。

Dify（国产 Agent / 工作流平台）

1. 进入 设置 → 模型供应商。
2. 添加 OpenAI-API-compatible 供应商。
3. API Base URL 填 https://qianzhiapi.com/v1。
4. API Key 填本站令牌，并添加需要使用的模型名。
5. 点击测试，通过后即可在 Chatflow / Workflow / Agent 中选择该模型。

FastGPT

FastGPT 的“自定义请求地址”通常要求完整接口地址：

• 对话模型：https://qianzhiapi.com/v1/chat/completions
• 向量模型：https://qianzhiapi.com/v1/embeddings

自定义请求 Key 填本站令牌，模型名称填本站模型名。

MaxKB

1. 模型供应商选择 OpenAI。
2. API 域名填 https://qianzhiapi.com/v1。
3. API Key 填本站令牌。
4. 基础模型填写本站模型名，保存后测试。

扣子 Coze / Coze Studio

如果你的版本支持“自定义模型”或“OpenAI 兼容模型”，填写： Base URL 为 https://qianzhiapi.com/v1， API Key 为本站令牌，Model 为本站模型名。若在线版界面没有自定义模型入口， 则不能直接接本站中转。

通义灵码、文心快码、CodeGeeX、MarsCode 等

这些工具的公开版本多以官方账号和官方模型为主；是否支持任意 OpenAI-compatible Base URL 取决于具体版本和企业配置。文档中不建议承诺“必定可接入”。 判断标准很简单：设置页里能填写 自定义 API 地址 / Base URL / OpenAI Compatible 就按通用规则配置；找不到该字段，就不能直接接中转站。

SDK 与命令行

curl

curl https://qianzhiapi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      { "role": "user", "content": "你好，介绍一下你自己" }
    ]
  }'

Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的令牌",
    base_url="https://qianzhiapi.com/v1",
)

resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "你好"}],
)

print(resp.choices[0].message.content)

Node.js / TypeScript

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-你的令牌",
  baseURL: "https://qianzhiapi.com/v1",
});

const resp = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [{ role: "user", content: "你好" }],
});

console.log(resp.choices[0].message.content);

常见错误

安全建议

• 不要把 API Key 发到群聊、截图、公开仓库或前端代码里。
• 给不同工具创建不同令牌，方便单独限额和停用。
• 如果怀疑泄露，立即删除旧令牌并创建新令牌。