TokenToSea API 概览
用一个 API Key 调用国内外厂商的官方模型,按官方原价从账户余额实时结算。
TokenToSea API 把千问、智谱、MiniMax、豆包、阶跃星辰、Kimi、DeepSeek、TypeSafe 与 Cloudflare 的官方模型接到同一个入口。你用一把密钥调用全部已上线型号,费用按厂商公布的官方价格计算,不加价,从 TokenToSea 账户的同一个余额中预留并结算。
截至 2026-10-21,模型目录包含 303 个已验收型号:国内 297 个,海外 6 个(System One 结构化判断模型)。覆盖对话、图像、视频、语音合成、语音识别、实时音频、向量、重排序、专用工具与 3D 生成。完整列表见模型目录。
入口地址#
| 用途 | 地址 | 认证方式 |
|---|---|---|
| 模型推理(HTTP) | https://api.tokentosea.com/v1 | 全能密钥或模型密钥(sk-relay_…) |
| 实时音频(WebSocket) | wss://api.tokentosea.com/v1/realtime?model=<型号> | 同上,仅 Authorization: Bearer |
| 工具 API | https://tokentosea.com/api/v1/tool-api | 工具密钥(tts_tool_…)或已开启工具权限的全能密钥 |
| TokenToSea 登录(OAuth / OIDC) | https://tokentosea.com/api/oauth | 授权码 + PKCE |
| 控制台 | https://tokentosea.com/app/ | 账号登录 |
所有模型请求都发往 api.tokentosea.com。平台按请求中的 model 精确路由到对应区域的执行节点,你不需要也不能直接访问执行节点。
三步开始#
- 充值
登录控制台 → 充值,用微信支付到账后即可调用。每次调用先按上限预留金额,完成后按实际用量结算。
- 创建密钥
在控制台 → 我的 Key 选择「新建密钥」。明文只显示一次,请立即保存到服务器端的密钥管理或环境变量中。
- 发送第一个请求
按快速开始用 cURL、Python 或 Node.js 调用
/v1/chat/completions,两分钟内看到第一条回复。
curl https://api.tokentosea.com/v1/chat/completions \
-H "Authorization: Bearer $TOKENTOSEA_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "qwen3.8-flash",
"messages": [{"role": "user", "content": "用一句话介绍你自己。"}],
"max_tokens": 256
}'import os
import uuid
from openai import OpenAI
client = OpenAI(
api_key=os.environ["TOKENTOSEA_API_KEY"],
base_url="https://api.tokentosea.com/v1",
max_retries=0,
)
completion = client.chat.completions.create(
model="qwen3.8-flash",
messages=[{"role": "user", "content": "用一句话介绍你自己。"}],
max_tokens=256,
extra_headers={"Idempotency-Key": str(uuid.uuid4())},
)
print(completion.choices[0].message.content)import { randomUUID } from 'node:crypto';
const response = await fetch('https://api.tokentosea.com/v1/chat/completions', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.TOKENTOSEA_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': randomUUID(),
},
body: JSON.stringify({
model: 'qwen3.8-flash',
messages: [{ role: 'user', content: '用一句话介绍你自己。' }],
max_tokens: 256,
}),
});
const body = await response.json();
console.log(response.status, body.choices?.[0]?.message?.content ?? body);平台如何工作#
| 环节 | 行为 |
|---|---|
| 协议 | 对话类型号兼容 OpenAI Chat Completions、OpenAI Responses(无状态)和 Anthropic Messages;图像、视频、语音、向量、重排序、3D、System One 与实时音频使用各自的原生接口。每个型号只开放逐项验收过的接口、响应方式和输入类型。 |
| 鉴权 | Authorization: Bearer <密钥> 或 x-api-key: <密钥>。密钥在浏览器本地生成,平台只保存其 SHA-256 摘要。 |
| 计费 | 官方原价、保留原币(人民币或美元),受理时冻结价格版本与汇率;钱包以美元记账,精确到 0.000001 并向上取整。响应体保留厂商原生 usage。 |
| 可靠性 | 每次 POST 可带 Idempotency-Key。网络中断后用同一个键查询 /v1/results/{键} 取回结果,不要重新提交。 |
| 异步任务 | 视频、3D 及部分图像、语音识别任务返回 202 和结果编号,平台后台轮询厂商并把生成文件转存到私有存储。 |
文档导航#
开始使用
快速开始、认证与密钥、用官方 SDK 接入、选择型号、控制台。
指南
幂等与重试、流式输出、异步结果、计费、错误处理、限制、区域与安全。
API 参考
每个端点的请求参数、响应结构、错误码与完整示例。
模型
303 个型号的能力、接口、官方价格与逐个调用示例。
工具 API
用同一个余额调用工具市场中已接通的工具操作。
TokenToSea 登录
为第三方应用接入 OAuth / OIDC 登录与委托调用。