快速开始
开始使用 AllToken。
简介
AllToken 提供统一的 API，让你通过单一接口访问数百个 AI 模型，同时自动处理故障转移并选择最具性价比的选项。
只需几行代码，即可使用你喜欢的 SDK 或框架开始调用。
Base URL： https://api.alltoken.ai/v1
认证方式： Bearer API Key
兼容性： OpenAI 兼容 API
获取 API Key
在开始之前，请先创建一个 API Key：
- 前往 设置 → API Keys
- 点击 创建新 Key
- 复制并安全保存 Key — 它只会显示一次
请妥善保管你的 API Key，不要在客户端代码或公开仓库中暴露它。
作为 agent skill 安装
如果你的现有工作栈已经能使用 AllToken，就可以跳过集成代码。AllToken 为会加载 SKILL.md 的 agent runtime 提供两个官方 skill，一条命令安装后，agent 就能理解完整的 AllToken API 能力。
| Skill | 作用 |
|---|---|
| alltoken | 搭建完整的 TypeScript 或 Python AllToken 项目：chat、异步图片、异步视频、streaming、tool-calling agent core，以及可选 Ink TUI。 |
| alltoken-call | agent 在聊天中可识别的六个 slash-style 命令：/alltoken-chat、/alltoken-image、/alltoken-video、/alltoken-search、/alltoken-models、/alltoken-cost。Stdlib Python recipes，无需 pip install。 |
两者都以 MIT 发布。源码： github.com/alltoken-ai/alltoken-skills.
在你的 runtime 中安装
OpenClaw（通过 ClawHub CLI）：
$clawhub skill install alltoken
clawhub skill install alltoken-callHermes Agent（直接 URL 安装）：
$hermes skills install https://alltoken.ai/skills/alltoken/SKILL.md
hermes skills install https://alltoken.ai/skills/alltoken-call/SKILL.mdClaude Code / Codex CLI / OpenCode - 将 SKILL.md 文件放入项目的 skills/ 目录：
$mkdir -p ./skills/alltoken-call
curl -fsSL https://alltoken.ai/skills/alltoken-call/SKILL.md -o ./skills/alltoken-call/SKILL.mdagent 会在下一次 session 中加载这个 skill。
试用
确保 agent 运行环境中已经设置 ALLTOKEN_API_KEY。然后用自然语言提问：
- "使用 alltoken-call skill 生成一张 1024x1024 的茶壶图片。"
- "使用 alltoken 在
./my-agent中搭建一个 AllToken chat 项目。" - "运行
/alltoken-models --type=video显示可用的视频模型。"
使用 SillyTavern 做 roleplay？查看专门指南： Use AllToken with SillyTavern.
更想自己写集成？继续阅读下面的 安装 SDK，使用 TypeScript / Python 路径。
安装 SDK
AllToken 完全兼容 OpenAI SDK。使用你喜欢的包管理器安装：
$npm install openai然后设置环境变量：
$export ALLTOKEN_API_KEY="your_alltoken_api_key"发送第一个请求
创建客户端，选择模型，发送一个聊天请求：
| 1 | import OpenAI from 'openai'; |
| 2 | |
| 3 | const client = new OpenAI({ |
| 4 | apiKey: process.env.ALLTOKEN_API_KEY, |
| 5 | baseURL: 'https://api.alltoken.ai/v1', |
| 6 | }); |
| 7 | |
| 8 | const completion = await client.chat.completions.create({ |
| 9 | model: 'minimax-m2.7', |
| 10 | messages: [ |
| 11 | { |
| 12 | role: 'user', |
| 13 | content: '生命的意义是什么？', |
| 14 | }, |
| 15 | ], |
| 16 | }); |
| 17 | |
| 18 | console.log(completion.choices[0]?.message?.content); |
Python 示例
| 1 | from openai import OpenAI |
| 2 | import os |
| 3 | |
| 4 | client = OpenAI( |
| 5 | api_key=os.environ.get("ALLTOKEN_API_KEY"), |
| 6 | base_url="https://api.alltoken.ai/v1", |
| 7 | ) |
| 8 | |
| 9 | completion = client.chat.completions.create( |
| 10 | model="minimax-m2.7", |
| 11 | messages=[ |
| 12 | {"role": "user", "content": "生命的意义是什么？"} |
| 13 | ], |
| 14 | ) |
| 15 | |
| 16 | print(completion.choices[0].message.content) |
直接调用 API
你也可以使用 cURL 或任何 HTTP 客户端直接调用 API：
| 1 | curl https://api.alltoken.ai/v1/chat/completions \ |
| 2 | -H "Authorization: Bearer $ALLTOKEN_API_KEY" \ |
| 3 | -H "Content-Type: application/json" \ |
| 4 | -d '{ |
| 5 | "model": "minimax-m2.7", |
| 6 | "messages": [ |
| 7 | {"role": "user", "content": "你好！"} |
| 8 | ] |
| 9 | }' |
流式响应
添加 stream: true 即可通过 Server-Sent Events 逐 token 获取响应：
| 1 | const stream = await client.chat.completions.create({ |
| 2 | model: 'minimax-m2.7', |
| 3 | messages: [{ role: 'user', content: '给我讲个故事' }], |
| 4 | stream: true, |
| 5 | }); |
| 6 | |
| 7 | for await (const chunk of stream) { |
| 8 | const content = chunk.choices[0]?.delta?.content; |
| 9 | if (content) process.stdout.write(content); |
| 10 | } |
详细的流式文档请参阅 流式响应。