快速开始
TokenFlux 是统一的大语言模型接口：通过统一的 API Key 在各类客户端中调用主流大模型。
For AGENTS
批量读取 Markdown 文档时，可直接使用 markdown-sitemap.xml。单页读取时，直接在不以 / 结尾的文档 URL 后追加 .md 即可，例如 /docs/quickstart.md。
接入流程
- 在下方选择客户端，到 模型广场 确认目标模型所在分组支持所需协议和客户端。
- 查看 计费说明，确认价格后 充值或订阅，获得推理积分。
- 创建 API Key，选择已确认的分组。
- 按下方客户端教程填入 Key、端点和模型 ID。
- 发送一条消息，核对回复和使用记录，确认接入成功。
分组、号池、推理积分等术语见 核心概念。
客户端选型
适合在终端工作、有编程需求或希望使用 AI Agent 辅助开发的用户。
按所用客户端查看对应教程。需要统一管理 Key 和模型时，可选用 tf-cli，在终端通过 tf 启动客户端；偏好图形界面管理供应商配置时，可选用 CC-Switch。两者都不是接入的前置条件。
| 客户端教程 | 适用场景 |
|---|---|
| Claude Code | Anthropic 官方 CLI，终端编程 |
| Codex | OpenAI 官方 CLI 与桌面端 |
| Codex++ | 给 Codex 加装增强能力 |
| OpenCode | 开源终端 Agent，多模型切换 |
| Pi | 可扩展的终端编程 Agent |
| DeepSeek Harness | 支持自定义模型接口的桌面端与 Web UI |
| Hermes | 轻量终端 Agent |
确认接入成功
- 在客户端中选择目标模型，新建对话并发送「只回复 OK」。这会产生推理费用。
- 确认收到模型的文本回复，而不只是看到模型列表或「配置已保存」。
- 在 使用记录 中找到本次请求，核对使用的 Key、模型及扣费；分组与创建 Key 时的选择一致。
这只能确认本次文本对话成功。需要工具调用、图片或其他能力时，再验证对应功能。没有回复或记录与预期不符时，见 排障。
进阶用法
接入完成后可按需使用：
- 创作台 — 无需客户端与 API 配置，网页端在线生成图片
- 复合 Key — 一个 Key 绑定多个分组，用前缀切换
- Fast 模式 — 在 Key 上强制开启高优先级通道
- 团队 — 多人共用所有者的余额，各自建 Key
- 邀请返利 — 邀请好友获得推理积分