1快速开始

注册并登录控制台，创建 API 密钥，然后使用以下三个要素发起任意请求：

模型 ID 自带提供商前缀（厂商标识）：qwen3. 通义千问（注意 qwen 系列 ID 无连字符，如 qwen3.8-flash） · deepseek- DeepSeek · glm- 智谱 AI · doubao- 豆包/火山方舟 · kimi- 月之暗面。请求时直接填完整模型 ID 即可，无需额外传 provider 参数；完整模型列表见 模型广场。

curl -X POST "https://api.zhuohuo.cn/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的Key" \
  -d '{
    "model": "deepseek-v4-pro",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": true
  }'

✔ 支持 stream 流式、tools 函数调用、prefix cache 前缀缓存（命中自动省钱）。

2常用工具配置

2.0 客户端下载（官方）

先下载安装你常用的 Agent 客户端，再按下方对应小节填入 Base URL 与 Key（配置也可一键下载）。

工具	类型	官方下载 / 安装
Cherry Studio	桌面客户端（Windows exe）	GitHub Releases 下载
Cursor	桌面客户端（Windows exe）	cursor.com 下载
Windsurf	桌面客户端（Windows exe）	windsurf.com 下载
CC Switch	桌面工具（Windows exe）	GitHub Releases 下载
Claude Code	命令行（npm）	claude.com/code · 安装：npm install -g @anthropic-ai/claude-code
Codex CLI	命令行（npm）	OpenAI 官方页 · 安装：npm install -g @openai/codex
Cline	VS Code 插件	VS Code 市场安装
Roo Code	VS Code 插件	VS Code 市场安装
DeepSeek Harness（dsh）	Agent / CLI（官方）	deepseek-ai/deepseek-harness 官方仓库
DeepSeek Harness 桌面版	桌面客户端（Windows exe，约 5MB）	GitHub Releases 下载 · DSHDesktop 备用下载

2.1 Cherry Studio

设置 → 模型服务 → OpenAI 兼容

API 地址: https://api.zhuohuo.cn/v1
API Key : sk-你的Key
模型    : deepseek-v4-pro（或任意已开通模型）

2.2 Cline / Roo Code

API Provider: OpenAI Compatible
Base URL    : https://api.zhuohuo.cn/v1
API Key     : sk-你的Key
Model ID    : deepseek-v4-pro

2.3 Claude Code

export ANTHROPIC_BASE_URL="https://api.zhuohuo.cn/v1"
export ANTHROPIC_AUTH_TOKEN="sk-你的Key"
export ANTHROPIC_MODEL="claude-sonnet-4.5"
export ANTHROPIC_SMALL_FAST_MODEL="claude-haiku-4.5"

2.4 Codex

export OPENAI_API_BASE="https://api.zhuohuo.cn/v1"
export OPENAI_API_KEY="sk-你的Key"
export OPENAI_MODEL="deepseek-v4-pro"

2.5 CC Switch / WorkBuddy

选择 OpenAI 兼容 Provider，填入 Base URL 与 Key 即可全局生效。

2.6 DeepSeek Harness

BASE_URL=https://api.zhuohuo.cn/v1
API_KEY=sk-你的Key
MODEL=deepseek-v4-pro

DeepSeek Harness（dsh）及各类桌面版均支持 OpenAI 兼容协议：Provider 选 OpenAI Compatible，Base URL 填 https://api.zhuohuo.cn/v1，Key 填上方配置；CLI 版填入上方三个环境变量即可。

2.7 OpenCode（自定义 Provider）

OpenCode 添加第三方服务时，会要求输入一个「提供商 ID」（Provider ID）：它是你在配置里给该服务商起的唯一标识键，用来区分不同的供应商，可任意命名但需易记（字母 / 数字 / 中划线）。推荐直接填 zhuohuo（本平台域名缩写，好记且不与常见厂商冲突），整台电脑全局唯一即可。

# 方式一：交互式添加（终端里执行 /connect）
opencode
/connect            → 滚动选择 Other
Enter provider id   → 输入 zhuohuo（推荐值；如提示"已存在"换 zhuohuo2 等）
Enter API key       → 粘贴你的 sk-你的Key
Enter base URL      → https://api.zhuohuo.cn/v1

# 方式二：配置文件（全局 ~/.config/opencode/opencode.json 或项目根 opencode.json）
# provider 下每个键名就是一个 Provider ID，多个服务商并列书写：
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "acctoken": { ... },            // 你已有的其他服务商（照旧保留）
    "ollama":   { ... },            // 你已有的其他服务商（照旧保留）
    "zhuohuo": {                    // ← 这个键就是 Provider ID
      "npm": "@ai-sdk/openai-compatible",
      "name": "烛火 AI 平台",
      "options": {
        "baseURL": "https://api.zhuohuo.cn/v1",
        "apiKey": "sk-你的Key"
      },
      "models": {
        "qwen3.8-flash":                 { "name": "Qwen 3.8 Flash" },
        "deepseek-v4-pro":               { "name": "DeepSeek V4 Pro" },
        "glm-5.3":                       { "name": "GLM 5.3" },
        "doubao-seed-2-1-turbo-260628":  { "name": "豆包 Seed 2.1 Turbo" }
      }
    }
  }
}

模型 ID 必须用 模型广场 中的真实 ID（前缀即厂商标识），按需增删 models 条目即可。注意：qwen 系列 ID 无连字符（如 qwen3.8-flash，不是 qwen-3.8-flash）；GLM 旗舰为 glm-5.3（点号）；kimi-k3 等未接入模型不要填写。配置完成后重启 opencode，即可在模型列表选择 zhuohuo/qwen3.8-flash 等模型对话。

2.8 模型 ID 与展示名对照（28 个，以网关返回为准）

客户看到的展示名	模型 ID（照抄填写）	厂商	备注
Qwen 3.8 Flash	qwen3.8-flash	通义千问	最新轻量走量，无连字符
Qwen 3.8 Max	qwen3.8-max	通义千问	旗舰
Qwen 3.7 Max	qwen3.7-max	通义千问	旗舰
Qwen 3.7 Plus	qwen3.7-plus	通义千问
Qwen 3.6 Plus	qwen3.6-plus	通义千问	原生视觉语言
Qwen 3.6 Flash	qwen3.6-flash	通义千问
Qwen 3.5 Flash	qwen3.5-flash	通义千问	入门轻量
Qwen 3.5 Plus	qwen3.5-plus	通义千问
Qwen3 Max（2026-01-23 快照）	qwen3-max-2026-01-23	通义千问	带日期快照，原样保留
Qwen3 VL Plus	qwen3-vl-plus	通义千问	视觉理解
Qwen VL Plus	qwen-vl-plus	通义千问	视觉理解
Qwen Plus	qwen-plus	通义千问
Qwen Turbo	qwen-turbo	通义千问
Qwen Long	qwen-long	通义千问	长上下文
Qwen Image 3.0	qwen-image-3.0	通义千问	图像生成
Qwen Image 3.0 Pro	qwen-image-3.0-pro	通义千问	图像生成
DeepSeek V4 Pro	deepseek-v4-pro	DeepSeek	深度思考最强
DeepSeek V4 Pro GA	deepseek-v4-pro-ga-260813	DeepSeek	正式版，带日期
DeepSeek V4 Flash GA	deepseek-v4-flash-ga-260731	DeepSeek	正式版，带日期
DeepSeek V4.1 Flash	deepseek-v4-1-flash-260910	DeepSeek	带日期
GLM 5.3	glm-5.3	智谱 AI	旗舰，点号分隔
GLM 5.2	glm-5.2	智谱 AI	点号分隔；另一渠道 ID 为 glm-5-2-260617（二选一）
GLM 5.3 Flash	glm-5-3-flash-260828	智谱 AI	原生多模态，带日期
豆包 Seed 2.1 Pro	doubao-seed-2-1-pro-260628	火山方舟	旗舰，带日期
豆包 Seed 2.1 Turbo	doubao-seed-2-1-turbo-260628	火山方舟	热门，带日期
豆包 Seed 2.0 Lite	doubao-seed-2-0-lite-260428	火山方舟	轻量，带日期
豆包 Seed 2.0 Mini	doubao-seed-2-0-mini-260428	火山方舟	最低成本，带日期

日期后缀（如 260628）是厂商正式版的上线批次标识，属 ID 一部分，必须保留；不同 ID 即使名字相近也是不同模型，混用会 503。OpenCode 配置时把「展示名」填 name、「模型 ID」填 models 键。

3API 端点

端点	说明
POST /v1/chat/completions	对话补全（流式/非流式）
POST /v1/responses	Responses API（兼容）
POST /v1/embeddings	向量嵌入
GET /v1/models	查询已开通模型列表
POST /v1/images/generations	图像生成（按渠道开放）

4计费与额度

5常见问题