一、先拿到密钥
- 打开控制台：api.tutujing.com/dashboard（也支持
/console路径）。 - 进入「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 | — |
同一把密钥可以走 OpenAI 兼容接口，例如：
bash · 自检请求
curl https://api.tutujing.com/v1/models \ -H "Authorization: Bearer sk-你的密钥"
返回模型列表说明密钥和分组可用；返回 401 是密钥问题，返回 503/model_not_found 是分组里没有这个模型。
三、Codex 的写法
Codex 用「供应商 + config.toml」的方式接入自定义 API。用 CC Switch 可以一键导入（见 CC Switch 绑定）；手工配置时按下面填：
TOML · ~/.codex/config.toml
model_provider = "custom" model = "gpt-5.6-sol" 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。- Codex 的密钥写在
config.toml的experimental_bearer_token，不是~/.codex/auth.json（那是 OpenAI 官方登录用的）。 - 改完重启终端或桌面应用，模型列表才会刷新。
模型名必须真实存在写错模型名会返回 model_not_found，而不是自动回落。下面第三节是当前线上的真实模型名，或用「获取模型列表」从接口里选。
四、真实模型名与分组对照
下表按 2026-10-26 线上 /api/pricing 的实际数据整理。分组决定密钥能调用哪些模型，两边必须对得上。
OpenAI / Codex 系
| 模型 | 可用分组 | 用途 |
|---|---|---|
gpt-5.6-sol、gpt-5.6-terra | GPT官Key、GPT Pro专用、GPT 企业级、GPT不降智、GPT(no Pro)专用 | Codex 主力，长任务与重构 |
gpt-6-astra、gpt-6-sol、gpt-6.1-sol | GPT官Key、GPT Pro专用、GPT 企业级、GPT不降智、GPT 不降智（仅6 Astra） | 最新一代，推理更强 |
gpt-5.5 | GPT官Key、GPT Pro专用 | 兼容旧配置 |
Claude 系
| 模型 | 可用分组 | 用途 |
|---|---|---|
claude-sonnet-4-6、claude-sonnet-5 | Claude 官转满血、Claude 满血稳定一哥、Claude Max满血 贵族全穿透、CCMax 特价（可蒸馏）、Claude kiro 专用 | Claude Code 主力 |
claude-opus-5、claude-opus-5-5 | 同上（并非所有分组都有 Opus） | 重推理 |
claude-haiku-4-5 | Claude Max满血 贵族全穿透、Claude kiro 专用、CCMax 特价（可蒸馏） | 后台小任务 / 快速响应 |
Gemini 系
| 模型 | 可用分组 | 用途 |
|---|---|---|
gemini-4-argon（及 -low / -medium / -high） | Gemini 反重力、Gemini 满血分组 | 知识与视频理解 |
gemini-3.8-flash、gemini-3.7-flash、gemini-3.1-pro-preview | Gemini 反重力 | 快速响应 |
图像 / 视频
| 模型 | 分组 | 计费口径 |
|---|---|---|
gpt-image-2、gpt-image-2.5、gpt-image-2-2k、gpt-image-2-4k | GPT Image、GPT-Image-Cheap | 按张 / 按请求 |
IMG-2、IMG-2.5S、IMG-2.5F | MiniMax Image 2.5 | 按张 |
H3 Video、H3 Frames | H3 视频生成 | 按输出秒数 × 分辨率档：480P ¥0.03/秒、720P ¥0.05/秒、768P ¥0.08/秒、960P ¥0.24/秒、1080P ¥0.32/秒 |
wan30-720p | 视频A组 | 按秒 |
seedance-2.0-mini | Seedance 分组、视频A组 | 按次 |
grok-imagine-video-1.5-preview | 视频A组 | 按次，¥2/次 |
价格以模型广场实时显示为准文本模型按「模型倍率 × 分组倍率」计费，分组不同单价不同。上面的视频/次价来自后台计费配置，调整价格后以 模型广场 与账单为准。
五、常见报错对照
| 返回 | 含义 | 怎么处理 |
|---|---|---|
401 Invalid token | 密钥错误 / 已禁用 / 末尾带空格 | 重新复制密钥，核对密钥状态 |
404 | 地址路径错（少写或多写 /v1） | 按第二节地址表改回 |
503 / model_not_found | 分组不含该模型，或该分组暂无可用渠道 | 换分组，或换该分组里有的模型 |
400 | 参数不合法、上下文超限、模型不支持该请求 | 以日志里的原始报错为准 |
| 余额不足 | 额度用完 | 钱包充值后再试 |
排错顺序：先看地址 → 再看密钥 → 再看模型名/分组 → 最后看余额。控制台「日志」里能看到每次请求的模型、令牌和分组，是定位问题最快的地方。
六、继续阅读
- CC Switch 绑定：把 Claude Code / Codex / Gemini CLI 一键接到本站。
- 完整文档站：注册登录、密钥、日志与异步任务、钱包订阅、模型广场。
- 视频 API 设置：H3 / Wan / Seedance / Grok 的提交、轮询、取片与参数限制。
- 模型广场：实时价格、能力标签与分组。