快速开始

第一步：获取 API Key

前往 1688token.ai 控制台 注册账号并登录，在「令牌」页面创建一个 API Key。

所有请求均需在 HTTP Header 中携带该 Key：

Authorization: Bearer <your-api-key>

第二步：设置接入地址

1688token.ai 完全兼容 OpenAI API 格式，所有接口统一使用以下 Base URL：

https://1688token.ai/v1

只需将原有代码中的 base_url 替换为上述地址，即可无缝迁移。

第三步：安装 SDK

Python

pip install openai

Node.js

npm install openai

第四步：发送首个请求

Python

from openai import OpenAI

client = OpenAI(
    api_key="your-api-key",
    base_url="https://1688token.ai/v1"
)

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[
        {"role": "system", "content": "你是一个专业的 AI 助手。"},
        {"role": "user", "content": "你好，介绍一下你自己。"}
    ]
)

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

Node.js

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'your-api-key',
  baseURL: 'https://1688token.ai/v1',
});

const response = await client.chat.completions.create({
  model: 'gpt-4o-mini',
  messages: [
    { role: 'system', content: '你是一个专业的 AI 助手。' },
    { role: 'user', content: '你好，介绍一下你自己。' },
  ],
});

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

cURL

curl https://1688token.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "system", "content": "你是一个专业的 AI 助手。"},
      {"role": "user", "content": "你好，介绍一下你自己。"}
    ]
  }'

第五步：常用接口

接口	方法	说明
/v1/chat/completions	POST	聊天补全（支持流式）
/v1/models	GET	查询可用模型列表

错误处理

请求失败时，响应体格式如下：

{
  "error": {
    "message": "Invalid API key",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

常见错误码：

HTTP 状态码	说明	处理建议
401	API Key 无效或未传入	检查 Authorization 头
403	权限不足或余额不足	检查账户余额和 Key 权限
429	请求频率超限	降低请求频率或联系支持
500	服务端内部错误	稍后重试

使用限制

限制项	说明
请求频率	根据账户等级限制，超限返回 429
单次 Token 上限	取决于所选模型的上下文窗口
响应超时	建议客户端设置 60s 超时，流式请求适当放宽