快速开始

开始使用 AllToken。

简介

AllToken 提供统一的 API，让你通过单一接口访问数百个 AI 模型，同时自动处理故障转移并选择最具性价比的选项。

只需几行代码，即可使用你喜欢的 SDK 或框架开始调用。

Base URL： https://api.alltoken.ai/v1

认证方式： Bearer API Key

兼容性： OpenAI 兼容 API

获取 API Key

在开始之前，请先创建一个 API Key：

  1. 前往 设置 → API Keys
  2. 点击 创建新 Key
  3. 复制并安全保存 Key — 它只会显示一次

请妥善保管你的 API Key，不要在客户端代码或公开仓库中暴露它。

安装 SDK

AllToken 完全兼容 OpenAI SDK。使用你喜欢的包管理器安装：

npm
$ npm install openai

然后设置环境变量：

Shell
$ export ALLTOKEN_API_KEY="your_alltoken_api_key"

发送第一个请求

创建客户端，选择模型，发送一个聊天请求：

TypeScript
1import OpenAI from 'openai';
2
3const client = new OpenAI({
4 apiKey: process.env.ALLTOKEN_API_KEY,
5 baseURL: 'https://api.alltoken.ai/v1',
6});
7
8const completion = await client.chat.completions.create({
9 model: 'deepseek-chat',
10 messages: [
11 {
12 role: 'user',
13 content: '生命的意义是什么？',
14 },
15 ],
16});
17
18console.log(completion.choices[0]?.message?.content);

Python 示例

Python
1from openai import OpenAI
2import os
3
4client = OpenAI(
5 api_key=os.environ.get("ALLTOKEN_API_KEY"),
6 base_url="https://api.alltoken.ai/v1",
7)
8
9completion = client.chat.completions.create(
10 model="deepseek-chat",
11 messages=[
12 {"role": "user", "content": "生命的意义是什么？"}
13 ],
14)
15
16print(completion.choices[0].message.content)

直接调用 API

你也可以使用 cURL 或任何 HTTP 客户端直接调用 API：

cURL
1curl https://api.alltoken.ai/v1/chat/completions \
2 -H "Authorization: Bearer $ALLTOKEN_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "model": "deepseek-chat",
6 "messages": [
7 {"role": "user", "content": "你好！"}
8 ]
9 }'

流式响应

添加 stream: true 即可通过 Server-Sent Events 逐 token 获取响应：

TypeScript
1const stream = await client.chat.completions.create({
2 model: 'deepseek-chat',
3 messages: [{ role: 'user', content: '给我讲个故事' }],
4 stream: true,
5});
6
7for await (const chunk of stream) {
8 const content = chunk.choices[0]?.delta?.content;
9 if (content) process.stdout.write(content);
10}

详细的流式文档请参阅 流式响应。

下一步