客户端接入

如何填写 API

密钥、三个接入地址、Codex 的 config.toml、TUTUJING API 的模型与分组对照和报错处理。

拿密钥三个地址 Codex 配置模型与分组计费报错继续阅读

一、先拿密钥

打开控制台：api.tutujing.com/dashboard。
进入「API 密钥」→ 新建密钥，分组要包含你要用的模型。
复制行末的完整 sk- 密钥；页面关闭只是不再明文展示，之后仍可重新复制。
建议每个客户端 / 每个项目各用一把密钥，日志可区分、泄露可单独禁用。

密钥 = 账号余额

不要发到聊天、截图、公开仓库或写进前端代码。

二、按客户端选地址

三个客户端协议不同，地址写法也不同；写错一般表现为 404 或连不上，而不是「密钥无效」。

客户端	协议	填这个地址	不要写成
Codex（App/CLI/IDE）	OpenAI Responses	`https://api.tutujing.com/v1`	`https://api.tutujing.com`
Claude Code	Anthropic Messages	`https://api.tutujing.com`	`https://api.tutujing.com/v1`
Gemini CLI	Gemini Native	`https://api.tutujing.com`	`https://api.tutujing.com/v1beta`
脚本 / 自建程序	OpenAI 兼容	`https://api.tutujing.com/v1`	—

先用一条自检请求确认密钥与分组可用：

bash

curl https://api.tutujing.com/v1/models \
  -H "Authorization: Bearer sk-你的密钥"

返回模型列表 = 密钥与分组可用；401 是密钥问题；503 / model_not_found 是分组里没有这个模型。

三、Codex 的配置写法

Codex 用「供应商 + config.toml」接入自定义 API。用 CC Switch 或 Codex++ 可以图形化写这份配置，手工配置则按下面填：

TOML · ~/.codex/config.toml

model_provider = "custom"
model = "gpt-6-astra"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.custom]
name = "custom"
base_url = "https://api.tutujing.com/v1"
wire_api = "responses"
requires_openai_auth = true
experimental_bearer_token = "sk-你的密钥"

base_url 必须带 /v1，wire_api 固定 responses。
密钥写在 config.toml 的 experimental_bearer_token，不是 ~/.codex/auth.json（那是官方登录用的）。
改完重启终端或桌面应用，模型列表才会刷新。

四、模型与分组对照

下表按实例化时的线上 /api/pricing 整理，分组名以控制台实际可选为准。分组和模型对不上会返回 503 / model_not_found，不会扣费后返回空结果。

用途	可用分组
Claude Code	Claude 官转满血、Claude 满血稳定一哥、Claude Max满血贵族全穿透、Claude CCMax 0.4企业级、CCMax 企业蒸馏组、CCMax 特价（可蒸馏）、Claude kiro 专用
Codex（GPT）	GPT官Key、GPT Pro专用、GPT 企业级、GPT不降智、GPT(no Pro)专用、GPT 不降智（仅6 Astra）
Gemini CLI	Gemini 反重力、Gemini 满血分组
图像	GPT Image、GPT-Image-Cheap、MiniMax Image 2.5、Gemini 香蕉出图
视频	H3 视频生成、视频A组、Seedance 分组

常用模型名（必须与模型广场完全一致）：gpt-6-astra、gpt-6.1-sol、gpt-5.6-sol、claude-sonnet-4-6、gemini-4-argon、gpt-image-2。

五、计费口径

文本模型：按「模型倍率 × 分组倍率」计费，分组不同单价不同，实时价看模型广场。
图像模型：按张 / 按请求（如 gpt-image-2、IMG-2.5S）。
视频模型：H3 按输出秒数 × 分辨率档（480P / 720P / 768P / 960P / 1080P 逐档递增），Wan 3.0 按秒，Seedance mini 与 Grok 按次。详细参数见视频 API 设置。

价格以模型广场与账单为准

本页不硬编码单价，避免调价后不一致；以控制台显示为准即可。

六、常见报错对照

返回	含义	怎么处理
`401` Invalid token	密钥错误 / 已禁用 / 末尾带空格	重新复制密钥，核对状态
`404`	地址路径错（少写或多写 `/v1`）	按第二节地址表改回
`503` / `model_not_found`	分组不含该模型，或该分组暂无可用渠道	换分组，或换该分组里有的模型
`400`	参数不合法、上下文超限、模型不支持该请求	以日志里的原始报错为准
余额不足	额度用完	钱包充值后再试

七、继续阅读

Codex++：图形化供应商配置，图文步骤。
CCSwitch 配置：多客户端一键导入与切换。
Codex下载与安装：还没装客户端先看这页。