Token工场

API 文档

详细的接入指南和 API 参考，助您快速集成 Token工场

1快速开始

使用 Token工场 API 只需简单三步：

  1. 注册 Token工场 账号并登录控制台
  2. 在控制台中创建 API Key
  3. 使用您的 API Key 调用我们的接口

提示：新用户注册后将获得免费体验额度，无需绑定信用卡即可开始使用。

2接口地址

API 基础地址如下，所有请求均使用 HTTPS 协议：

text
https://tokenstransit.com/v1

聊天补全接口：

text
POST https://tokenstransit.com/v1/chat/completions

注意：该接口完全兼容 OpenAI 的 Chat Completions 接口格式，您可以直接使用 OpenAI 的 SDK 进行调用。

3认证方式

Token工场 使用 Bearer Token 进行 API 认证。请在请求头中携带您的 API Key：

text
Authorization: Bearer sk-your-api-key-here

您可以在控制台的「API Keys」页面创建和管理您的密钥。 请妥善保管您的 API Key，不要在公共代码仓库或客户端代码中暴露。

4支持模型列表

模型 ID模型名称供应商
gpt-4oGPT-4oOpenAI
gpt-4o-miniGPT-4o MiniOpenAI
claude-3-5-sonnetClaude 3.5 SonnetAnthropic
claude-4-sonnetClaude 4 SonnetAnthropic
gemini-2-0-proGemini 2.0 ProGoogle
deepseek-v3DeepSeek-V3DeepSeek
qwen-maxQwen-MaxAlibaba Cloud

更多模型正在持续接入中，请关注我们的更新公告。

5示例代码

curl

bash
curl https://tokenstransit.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key-here" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ]
  }'

Python (openai SDK)

python
from openai import OpenAI

client = OpenAI(
    base_url="https://tokenstransit.com/v1",
    api_key="sk-your-api-key-here"
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "user", "content": "Hello!"}
    ]
)

print(response.choices[0].message.content)

Node.js (openai SDK)

javascript
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://tokenstransit.com/v1",
  apiKey: "sk-your-api-key-here",
});

const response = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [
    { role: "user", content: "Hello!" },
  ],
});

console.log(response.choices[0].message.content);

6错误码说明

API 请求失败时会返回对应的 HTTP 状态码和错误信息，格式如下：

json
{
  "error": {
    "message": "Insufficient balance",
    "type": "insufficient_balance",
    "code": 402
  }
}
状态码名称说明
400Bad Request请求参数错误，请检查请求体格式
401UnauthorizedAPI Key 无效或缺失，请检查 Authorization 请求头
402Insufficient Balance账户余额不足，请充值后重试
404Not Found请求的模型或接口不存在
429Rate Limit请求频率过高，请稍后重试
500Internal Server Error服务内部错误，请联系技术支持
503Service Unavailable模型服务暂时不可用，请稍后重试