文档说明

这份文档写给第一次使用图漾API的用户。你不需要先理解 Sub2API 的后台架构，也不需要会部署服务器。先把一条可用的 AI 请求跑通，再慢慢理解每个概念。

你最终要完成三件事：

1. 登录图漾API。
2. 创建一个 API Key。
3. 把 API Key 和接口地址填进你的 AI 工具。

图漾API 的平台地址是：

https://codex.tuyoung.com

先看懂整体流程

当你在 Codex、Cursor、ChatBox 里提问时，请求大致会这样走：

flowchart LR
  A["你的 AI 工具"] --> B["图漾API"]
  B --> C["账号和 API Key 校验"]
  C --> D["分组规则"]
  D --> E["可用模型"]
  E --> F["返回回答"]

你需要配置的其实只有两类信息：

• API Key：证明这次请求是谁发的。
• Base URL：告诉工具要把请求发到哪里。

你会用到两个信息

名称	示例	用途
API Key	sk-xxxxxxxx	你的访问凭证，像一把钥匙
Base URL	https://codex.tuyoung.com 或 https://codex.tuyoung.com/v1	AI 工具调用图漾API的入口

新手最容易混淆的 4 个词

词	可以这样理解	常见错误
API Key	一把只属于你的调用钥匙	把别人的 Key、旧 Key、少复制一截的 Key 填进去
Base URL	服务入口地址	OpenAI 兼容客户端忘记加 /v1
模型名	你要使用的 AI 模型	凭印象写了平台不存在的模型名
分组	管理员给你的模型和额度规则	Key 没有绑定可用分组，导致 403

先不要急着复制网上的配置

不同工具对 Base URL 的要求不完全一样。有的要填根地址，有的要填 /v1。本教程会在每个工具页面单独说明。

最推荐的新手路线

如果你主要想用编程 Agent，推荐按这个顺序读：

1. 先看 注册与登录。
2. 再看 创建 API Key。
3. 看 Base URL 怎么填。
4. 然后配置 Codex。
5. 如果还要用 Claude Code，再看 Claude Code。

如果你只是想聊天或日常问答，可以直接看 ChatBox 或 Cherry Studio。

第一次跑通的验收标准

不要一开始就测试复杂任务。推荐先在目标工具里发送：

请只回复：配置成功

如果工具能正常回复，说明账号、Key、Base URL、模型名这几项已经基本正确。后续再调整模型、额度和高级参数。