接入指引
注册充值 → 创建令牌 → 点「使用密钥」复制各客户端配置。大多数客户端只需填 API 地址、Key、模型名;文中配置与代码块均可一键复制。
0. 必看
API 地址
| 字段 | 填什么 |
|---|---|
| OpenAI 兼容 | https://api.dataroute.cc/v1 |
| Claude 原生 | https://api.dataroute.cc |
| Gemini 原生 | https://api.dataroute.cc |
常见坑:Cherry Studio、Claude Code、Gemini CLI、OpenClaw 云面板 不要 加 /v1;Codex、OpenCode、OpenAI SDK、OpenClaw 本地 baseUrl 必须 加 /v1。
1. 注册与充值 / 兑换
1.2 登录

1.3 充值或使用兑换码

2. 令牌(API Key)使用
2.1 进入令牌管理并新建

2.2 创建令牌
- 填写名称(如「本机 Codex」)
- 在「分组」中选择要用的业务分组(有多个时选一个即可;也可用「自动」)
- 按需设置额度上限 / 有效期,点创建

2.3 复制密钥并打开「使用密钥」
新建成功后会展示完整密钥(以 sk- 开头)。立刻复制保存,再点「使用密钥」查看 Codex / Claude / OpenCode / OpenClaw / Python·SDK 等配置。也可用「CC Switch」一键导入。

2.4 切换分组(换套餐)
某一分组额度用尽或想换线路时,点「编辑」改分组即可,不必更换密钥本身,客户端配置可保持不变。

3. Codex(CLI / VS Code 插件 / App)
推荐:令牌行点「使用密钥」→ Codex,按系统复制。也可手动写入配置目录。

3.1 安装 CLI(可选)
npm i -g @openai/codex3.2 打开配置目录
Windows:按 Win + R,输入 %USERPROFILE%\.codex 回车。若没有 config.toml / auth.json,可先新建文本文件再改名。macOS / Linux 目录为 ~/.codex/。
3.3 写入 config.toml(base_url 必须带 /v1)
model_provider = "dataroute"
model = "从模型价格页复制"
model_reasoning_effort = "medium"
disable_response_storage = true
[model_providers.dataroute]
name = "DataRoute"
base_url = "https://api.dataroute.cc/v1"
wire_api = "responses"
requires_openai_auth = true3.4 写入 auth.json
{
"OPENAI_API_KEY": "sk-你的令牌"
}3.5 启动
codex总被要求点 Yes、想以最高权限跑?见 常见问题 · Codex 免确认。关掉终端后想接着上次上下文?见 常见问题 · Codex 恢复会话。想一个中转挂多个模型、进会话后用 /model 随时切换?见文末 进阶玩法 · Codex 多模型切换。
4. Claude Code(CLI / VS Code 插件)

4.1 安装(任选其一)
npm i -g @anthropic-ai/claude-codecurl -fsSL https://claude.ai/install.sh | bash4.2 终端临时环境变量(不要加 /v1)
export ANTHROPIC_BASE_URL="https://api.dataroute.cc"
export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
claude$env:ANTHROPIC_BASE_URL="https://api.dataroute.cc"
$env:ANTHROPIC_AUTH_TOKEN="sk-你的令牌"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"
claude环境变量仅对当前终端会话生效。也可写成系统/用户环境变量后重开终端。
4.3 持久配置 settings.json(推荐,VS Code 插件同此文件)
Windows:%USERPROFILE%\.claude\settings.json;macOS / Linux:~/.claude/settings.json。没有则新建。
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.dataroute.cc",
"ANTHROPIC_AUTH_TOKEN": "sk-你的令牌",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
"CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
}
}5. OpenCode

5.1 配置文件位置
编辑 ~/.config/opencode/opencode.json(或 opencode.jsonc)。Windows 一般为 %USERPROFILE%\.config\opencode\opencode.json。没有则新建。
5.2 写入配置(baseURL 必须带 /v1)
{
"provider": {
"openai": {
"options": {
"baseURL": "https://api.dataroute.cc/v1",
"apiKey": "sk-你的令牌"
},
"models": {
"从模型价格页复制": {
"name": "DataRoute 模型",
"options": {
"store": false
}
}
}
}
}
}模型 id 以模型价格与令牌分组权限为准;也可在客户端内用 /connect 补填 Key。
6. OpenClaw

6.1 云主机 / 面板(如腾讯云应用管理)
- 打开应用管理 → 找到 OpenClaw →「模型」
- 选择「自定义模型」→「JSON 输入」
- 粘贴下方 JSON,把 Key 换成你的令牌,点击「添加并应用」
{
"provider": "openai",
"base_url": "https://api.dataroute.cc",
"api": "openai-completions",
"api_key": "sk-你的令牌",
"model": {
"id": "从模型价格页复制",
"name": "DataRoute 模型"
}
}6.2 本地配置 openclaw.json
Windows:按 Win + R,输入 %USERPROFILE%\.openclaw 回车,编辑或新建 openclaw.json。
{
"models": {
"mode": "merge",
"providers": {
"dataroute": {
"baseUrl": "https://api.dataroute.cc/v1",
"api": "openai-responses",
"apiKey": "sk-你的令牌",
"models": [
{
"id": "从模型价格页复制",
"name": "从模型价格页复制",
"reasoning": false,
"input": ["text"],
"contextWindow": 128000,
"maxTokens": 4096
}
]
}
}
}
}本地 baseUrl 一般带 /v1;云面板「自定义模型」示例里的 base_url 通常不带。以面板校验结果为准。
7. Cherry Studio
1. 下载
cherry-ai.com → 设置 → 服务商 → 添加
2. 填写服务商
| 字段 | 填什么 |
|---|---|
| 服务商类型 | OpenAI 兼容 |
| API 地址 | https://api.dataroute.cc |
| API Key | sk-你的令牌 |
3. 开始使用
保存后 Check → 拉取模型 → 开聊。
8. Gemini CLI
1. 配置网关
export GOOGLE_GEMINI_BASE_URL="https://api.dataroute.cc"export GEMINI_API_KEY="sk-你的令牌"2. 启动
gemini9. Grok
Grok 走 OpenAI 兼容接口。创建令牌时分组请选 grok-basic,请求里的 model 填 grok-4.5(以模型价格为准)。分组不对会报「No available channel for model … under group …」。
也可在令牌管理点「使用密钥 → Python / SDK」直接复制(会带上你的完整 Key)。
1. 创建令牌
| 字段 | 填什么 |
|---|---|
| 分组 | grok-basic |
| 模型 | grok-4.5 |
| base_url | https://api.dataroute.cc/v1 |
| API Key | sk-你的令牌 |
2. Python(OpenAI SDK)
pip install openai
from openai import OpenAI
client = OpenAI(
api_key="sk-你的令牌",
base_url="https://api.dataroute.cc/v1",
)
resp = client.chat.completions.create(
model="grok-4.5",
messages=[{"role": "user", "content": "ping, reply with pong only"}],
max_tokens=32,
)
print(resp.choices[0].message.content)3. Python(requests)
pip install requests
import requests
url = "https://api.dataroute.cc/v1/chat/completions"
headers = {
"Authorization": "Bearer sk-你的令牌",
"Content-Type": "application/json",
}
payload = {
"model": "grok-4.5",
"messages": [{"role": "user", "content": "ping, reply with pong only"}],
"max_tokens": 32,
}
r = requests.post(url, headers=headers, json=payload, timeout=90)
r.raise_for_status()
print(r.json()["choices"][0]["message"]["content"])4. curl
curl https://api.dataroute.cc/v1/chat/completions \
-H "Authorization: Bearer sk-你的令牌" \
-H "Content-Type: application/json" \
-d '{"model":"grok-4.5","messages":[{"role":"user","content":"ping, reply with pong only"}],"max_tokens":32}'10. Python / SDK / curl
任意 OpenAI 兼容客户端:把官方 Base URL 换成下方地址,Key 用本站令牌,model 从价格页复制。Grok 专用步骤见 §9 Grok;控制台「使用密钥 → Python / SDK」可一键复制带真实 Key 的脚本。
常用地址与鉴权
| 字段 | 填什么 |
|---|---|
| base_url | https://api.dataroute.cc/v1 |
| Header | Authorization: Bearer sk-你的令牌 |
base_url 必须带 /v1;不要漏 Bearer 前缀。
1. Python · OpenAI SDK
pip install openai
from openai import OpenAI
client = OpenAI(
api_key="sk-你的令牌",
base_url="https://api.dataroute.cc/v1",
)
resp = client.chat.completions.create(
model="从模型价格页复制",
messages=[{"role": "user", "content": "ping, reply with pong only"}],
max_tokens=32,
)
print(resp.choices[0].message.content)2. Python · requests
pip install requests
import requests
url = "https://api.dataroute.cc/v1/chat/completions"
headers = {
"Authorization": "Bearer sk-你的令牌",
"Content-Type": "application/json",
}
payload = {
"model": "从模型价格页复制",
"messages": [{"role": "user", "content": "ping, reply with pong only"}],
"max_tokens": 32,
}
r = requests.post(url, headers=headers, json=payload, timeout=90)
r.raise_for_status()
print(r.json()["choices"][0]["message"]["content"])3. curl
curl https://api.dataroute.cc/v1/chat/completions \
-H "Authorization: Bearer sk-你的令牌" \
-H "Content-Type: application/json" \
-d '{"model":"从模型价格页复制","messages":[{"role":"user","content":"ping, reply with pong only"}],"max_tokens":32}'11. 生图 API
任意已有令牌都能生图,不用改分组、不用选生图组。对话组倍率不影响生图价。也可在控制台生图页直接画。
按张按档扣美元:1K $0.105、2K $0.21、4K $0.385。未充值账户全站只能出 1 张,且不能 4K。
接口
| 字段 | 填什么 |
|---|---|
| 方法 / 路径 | POST https://api.dataroute.cc/v1/images/generations |
| Header | Authorization: Bearer sk-你的令牌 |
| model | gpt-image-2 |
| 默认 size | 2048x2048(2K 方形) |
档位与尺寸
| 档位 | 价格 | 1:1 | 16:9 | 9:16 |
|---|---|---|---|---|
| 1K | $0.105 | 1024×1024 | 1376×768 | 768×1376 |
| 2K | $0.21 | 2048×2048 | 2560×1440 | 1440×2560 |
| 4K | $0.385 | 2880×2880 | 3840×2160 | 2160×3840 |
curl
curl https://api.dataroute.cc/v1/images/generations \
-H "Authorization: Bearer sk-你的令牌" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-image-2","prompt":"a cat sitting on a windowsill","size":"2048x2048"}'示例默认 2K 方形。1K / 4K 改 size,例如 1024x1024、3840x2160。
CC Switch
用 CC Switch 在 Claude Code / Codex / Gemini CLI 间一键切换 Provider。本站支持一键导入:到令牌管理点击「CC Switch」,选择应用后打开即可(需本机已安装)。也可手动填:Claude / Gemini 用上方「Claude 原生 / Gemini 原生」地址,Codex 用「OpenAI 兼容」地址(含 /v1),Key 用本站令牌。
常见问题
买了商品却没有 Key?
到账的是额度或兑换码,不是 API Key。请到令牌管理自行创建,再用「使用密钥」接入客户端。
404 / 连不上
核对是否多写或少写了 /v1(见上方「API 地址」说明)。
模型不存在 / 列表空
模型名从模型价格复制;并确认令牌分组有对应权限。
生图要换分组吗?怎么计价?
不用。任意有效令牌都能调 /v1/images/generations。按张按档:$0.105 / $0.21 / $0.385。未充值只能 1 张且不能 4K。详见生图 API。
如何少花钱 / 降低 Token 消耗?
选小模型、缩小上下文、少重试、新话题新开会话。完整指南见常见问题 · 如何降低 Token 消耗。
充值未到账
查看我的订单;已支付未发货会自动重试。
进阶玩法
Codex:model_catalog_json + /model 切换中转模型
目标:只配一个 DataRoute 中转(同一 Key / 同一 Provider),在目录里挂多个模型;进入 Codex 后输入 /model 随时切换,无需改配置、无需重启。
1. 生成模型目录(推荐:克隆官方模板,避免缺字段整表失效)
mkdir -p ~/.codex/model-catalogs
# 用官方内置模型当模板(带齐 base_instructions 等必填字段)
codex debug models --bundled > /tmp/_codex_tpl.json
# 拉取本站可调用模型(把 sk-你的令牌 换成真实 Key)
curl -sS -H "Authorization: Bearer sk-你的令牌" \
"https://api.dataroute.cc/v1/models" > /tmp/_dataroute_models.json
python3 - <<'PY' > ~/.codex/model-catalogs/dataroute.json
import json, sys
tpl = json.load(open("/tmp/_codex_tpl.json"))["models"][0]
api = json.load(open("/tmp/_dataroute_models.json")).get("data") or []
# 跳过明显非对话模型,可按需改过滤条件
skip = ("image", "tts", "whisper", "embedding", "moderation")
out = []
for i, m in enumerate(api):
slug = (m.get("id") or "").strip()
if not slug or any(s in slug.lower() for s in skip):
continue
e = dict(tpl)
e["slug"] = slug
e["display_name"] = slug
e["description"] = f"{slug} (via DataRoute)"
e["visibility"] = "list"
e["supported_in_api"] = True
e["priority"] = i
e["availability_nux"] = None
e["upgrade"] = None
out.append(e)
json.dump({"models": out}, sys.stdout, ensure_ascii=False, indent=2)
print(f"generated {len(out)} models", file=sys.stderr)
PY模型名以模型价格/ 令牌分组权限为准。目录是「整表替换」不是合并:只写进 JSON 的才会出现在 /model 列表。
2. 在 config.toml 根级挂上目录(不要写进 [model_providers.*])
model = "gpt-5.4-mini"
model_provider = "dataroute"
model_catalog_json = "~/.codex/model-catalogs/dataroute.json"
model_reasoning_effort = "medium"
[model_providers.dataroute]
name = "DataRoute"
base_url = "https://api.dataroute.cc/v1"
wire_api = "responses"model 必须是目录里已有的 slug;Key 仍用前面的 ~/.codex/auth.json。
3. 启动后用 /model 切换
codex/model在 TUI 里输入 /model,用方向键选择模型并回车;还可继续选 reasoning effort(low / medium / high)。建议用终端 codex,Desktop 对非官方 slug 的列表展示可能不完整。
4. 校验(可选)
codex debug models若报 missing field ... / unknown variant ...,说明 JSON 字段不完整或用了错误命名——重新跑第 1 步的「克隆模板」脚本即可。

