DataRoute

接入指引

注册充值 → 创建令牌 → 点「使用密钥」复制各客户端配置。大多数客户端只需填 API 地址、Key、模型名;文中配置与代码块均可一键复制。

进阶:Codex 用 model_catalog_json + /model 切换多模型

0. 必看

在本站购买商品到账的是额度(或运营发给你的兑换码),不是 API Key。 请先注册登录,再到令牌管理自己创建密钥,点「使用密钥」按客户端(含 Python / SDK)复制配置即可。

客户端的 base_url 一律填本页「API 地址」中的网关, 模型名从模型价格复制。配置均可一键复制。下方红框图为界面示意(截图里若出现本地地址,请以本页「API 地址」为准)。

客服微信:___WooW___

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.1 注册账号

打开本站首页,点击「登录」→「注册新账号」。填写邮箱与密码(至少 8 位)完成注册。 若站点启用了邮箱验证码 / 人机验证,按提示完成即可。

注册页标注:填写邮箱、设置密码、点击注册
线上注册页 · 红框为必填步骤

去注册 →

1.2 登录

登录页标注:邮箱、密码、登录
登录后进入用户控制台

1.3 充值或使用兑换码

  • 在线购买:控制台钱包充值或首页「额度商店」下单支付,支付成功后获得兑换码,再到控制台兑换入账。
  • 兑换码:左侧导航兑换码,把完整卡密粘贴到输入框后点「兑换」(区分大小写)。
兑换码页标注
界面示意 · 左侧「兑换码」→ 粘贴卡密 → 兑换

1.4 确认额度到账

兑换 / 支付成功后,打开数据看板查看余额(含「赠送 · 直充」分桶)与近期消耗。也可在我的订单核对发货状态。

数据看板标注
界面示意 · 左侧导航 + 看板余额区

2. 令牌(API Key)使用

2.1 进入令牌管理并新建

令牌管理入口
界面示意 · 左侧「令牌管理」→ 右上「新建令牌」

2.2 创建令牌

  1. 填写名称(如「本机 Codex」)
  2. 在「分组」中选择要用的业务分组(有多个时选一个即可;也可用「自动」)
  3. 按需设置额度上限 / 有效期,点创建
创建令牌表单标注
界面示意 · 名称 + 分组是最少必填项

2.3 复制密钥并打开「使用密钥」

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

创建成功后复制密钥与使用密钥
界面示意 · 绿色提示条:复制完整 Key → 使用密钥

2.4 切换分组(换套餐)

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

令牌操作列:编辑 / 使用密钥 / CC Switch
界面示意 · 编辑改分组 · 使用密钥看配置 · CC Switch 一键导入

3. Codex(CLI / VS Code 插件 / App)

推荐:令牌行点「使用密钥」→ Codex,按系统复制。也可手动写入配置目录。

使用密钥弹窗 · Codex
界面示意 · 使用密钥 → Codex → 选系统 → 复制 config.toml 与 auth.json(网关以本页 API 地址为准)

3.1 安装 CLI(可选)

npm
npm i -g @openai/codex

3.2 打开配置目录

Windows:按 Win + R,输入 %USERPROFILE%\.codex 回车。若没有 config.toml / auth.json,可先新建文本文件再改名。macOS / Linux 目录为 ~/.codex/

3.3 写入 config.toml(base_url 必须带 /v1)

~/.codex/config.toml
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 = true

3.4 写入 auth.json

~/.codex/auth.json
{
  "OPENAI_API_KEY": "sk-你的令牌"
}

3.5 启动

启动
codex

总被要求点 Yes、想以最高权限跑?见 常见问题 · Codex 免确认。关掉终端后想接着上次上下文?见 常见问题 · Codex 恢复会话。想一个中转挂多个模型、进会话后用 /model 随时切换?见文末 进阶玩法 · Codex 多模型切换

4. Claude Code(CLI / VS Code 插件)

使用密钥弹窗 · Claude Code
界面示意 · 使用密钥 → Claude Code → 终端临时变量或 settings.json

4.1 安装(任选其一)

npm
npm i -g @anthropic-ai/claude-code
官方脚本
curl -fsSL https://claude.ai/install.sh | bash

4.2 终端临时环境变量(不要加 /v1)

macOS / Linux
export ANTHROPIC_BASE_URL="https://api.dataroute.cc"
export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
claude
Windows PowerShell
$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。没有则新建。

~/.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

使用密钥弹窗 · OpenCode
界面示意 · 使用密钥 → OpenCode → 复制到 opencode.json(baseURL 含 /v1)

5.1 配置文件位置

编辑 ~/.config/opencode/opencode.json(或 opencode.jsonc)。Windows 一般为 %USERPROFILE%\.config\opencode\opencode.json。没有则新建。

5.2 写入配置(baseURL 必须带 /v1)

opencode.json
{
  "provider": {
    "openai": {
      "options": {
        "baseURL": "https://api.dataroute.cc/v1",
        "apiKey": "sk-你的令牌"
      },
      "models": {
        "从模型价格页复制": {
          "name": "DataRoute 模型",
          "options": {
            "store": false
          }
        }
      }
    }
  }
}

模型 id 以模型价格与令牌分组权限为准;也可在客户端内用 /connect 补填 Key。

6. OpenClaw

使用密钥弹窗 · OpenClaw
界面示意 · 使用密钥 → OpenClaw → 云面板 JSON 或本地 openclaw.json

6.1 云主机 / 面板(如腾讯云应用管理)

  1. 打开应用管理 → 找到 OpenClaw →「模型」
  2. 选择「自定义模型」→「JSON 输入」
  3. 粘贴下方 JSON,把 Key 换成你的令牌,点击「添加并应用」
自定义模型 JSON
{
  "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

~/.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 Keysk-你的令牌

3. 开始使用

保存后 Check → 拉取模型 → 开聊。

8. Gemini CLI

1. 配置网关

GOOGLE_GEMINI_BASE_URL
export GOOGLE_GEMINI_BASE_URL="https://api.dataroute.cc"
GEMINI_API_KEY
export GEMINI_API_KEY="sk-你的令牌"

2. 启动

启动
gemini

9. 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_urlhttps://api.dataroute.cc/v1
API Keysk-你的令牌

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_urlhttps://api.dataroute.cc/v1
HeaderAuthorization: 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
HeaderAuthorization: Bearer sk-你的令牌
modelgpt-image-2
默认 size2048x2048(2K 方形)

档位与尺寸

档位价格1:116:99:16
1K$0.1051024×10241376×768768×1376
2K$0.212048×20482560×14401440×2560
4K$0.3852880×28803840×21602160×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,例如 1024x10243840x2160

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

Key 无效 / 余额不足

令牌钱包检查状态;某一分组用尽可编辑令牌切换分组,无需换 Key。泄露则禁用后重建。

如何少花钱 / 降低 Token 消耗?

选小模型、缩小上下文、少重试、新话题新开会话。完整指南见常见问题 · 如何降低 Token 消耗

充值未到账

查看我的订单;已支付未发货会自动重试。

进阶玩法

Codex:model_catalog_json + /model 切换中转模型

目标:只配一个 DataRoute 中转(同一 Key / 同一 Provider),在目录里挂多个模型;进入 Codex 后输入 /model 随时切换,无需改配置、无需重启。

1. 生成模型目录(推荐:克隆官方模板,避免缺字段整表失效)

生成 ~/.codex/model-catalogs/dataroute.json
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.*])

~/.codex/config.toml
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 步的「克隆模板」脚本即可。