开发者中心

API 接入文档

使用熟悉的 OpenAI SDK 和 Bearer Token，在几分钟内接入 CC Boy 多模型网关。

创建 API Key 下载 OpenAPI

01 / 五分钟接入

从第一条请求开始

网关在线

创建 API Key

登录用户控制台，在“API 密钥”页面创建密钥。完整密钥只会展示一次，请立即保存到密码管理器。

登录后创建密钥

设置 Base URL

所有接口都位于同一个网关地址，OpenAI SDK 只需要替换 Base URL。

https://api.tawsiya.cn/v1

发送对话请求

选择模型目录中显示为可用的模型，携带 Bearer Token 发起请求。

查看完整示例

02 / 鉴权

Bearer Token 鉴权

不要在浏览器端暴露密钥

API Key 只放在服务端环境变量中。不要提交到 Git、前端代码、截图或日志；泄露后请立即在控制台撤销并重新创建。

环境变量

AITOKEN_API_KEY=sk-在控制台生成的密钥
AITOKEN_BASE_URL=https://api.tawsiya.cn/v1

03 / 接口参考

OpenAI 兼容端点

OpenAPI 文件

GET

/v1/models

返回当前账号可访问的模型目录、模型类型和供应商信息。

需要鉴权

POST

/v1/chat/completions

创建一次对话补全。支持 system、user、assistant、tool 消息和流式响应。

需要鉴权

GET

/v1/account

查询当前 API 密钥的有效额度、套餐、速率限制和钱包余额。

需要鉴权

GET

/v1/usage

查询当前 API 密钥的近 24 小时、7 天或 30 天调用明细和汇总。

需要鉴权

请求核心字段

字段	类型	说明
`model`	string	模型代码，例如 `gpt-5.4`
`messages`	array	按顺序排列的对话消息
`stream`	boolean	是否使用 SSE 流式输出，默认 false
`temperature`	number	0 到 2，控制随机性
`max_tokens`	integer	限制本次最大输出 Token 数

响应字段

字段	说明
`id`	本次请求唯一 ID
`choices[0].message`	模型返回的消息内容
`usage`	输入、输出和总 Token 统计
`X-Request-ID`	网关请求 ID，用于日志查询和技术支持

03.5 / 账号与用量

在客户端读取额度和用量

创建 API Key 后，可以通过这两个只读接口把套餐状态、余额和调用统计显示到自己的开发者工具中。数据只返回当前 Bearer Token 对应的账号和密钥。

账号信息

curl https://api.tawsiya.cn/v1/account \
  -H "Authorization: Bearer $AITOKEN_API_KEY"

用量统计

curl "https://api.tawsiya.cn/v1/usage?period=7d" \
  -H "Authorization: Bearer $AITOKEN_API_KEY"

04 / 可复制示例

三种方式调用对话接口

cURL

curl https://api.tawsiya.cn/v1/chat/completions \
  -H "Authorization: Bearer $AITOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.4","messages":[{"role":"user","content":"你好，请介绍一下你自己"}]}'

Python / OpenAI SDK

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ["AITOKEN_API_KEY"],
    base_url="https://api.tawsiya.cn/v1",
)
response = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "你好，请介绍一下你自己"}],
)
print(response.choices[0].message.content)

Node.js / OpenAI SDK

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.AITOKEN_API_KEY,
  baseURL: "https://api.tawsiya.cn/v1",
});
const result = await client.chat.completions.create({
  model: "gpt-5.4",
  messages: [{ role: "user", content: "你好，请介绍一下你自己" }],
});
console.log(result.choices[0].message.content);

05 / 实时输出

流式响应与长文本

将请求体中的 stream 设置为 true 后，服务端会以 Server-Sent Events 返回增量内容，最后以 data: [DONE] 结束。

Python 流式示例

stream = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "写一段简短的产品介绍"}],
    stream=True,
)
for chunk in stream:
    delta = chunk.choices[0].delta.content or ""
    print(delta, end="", flush=True)

06 / 排错

错误码与处理建议

状态码	含义	建议
400	请求参数错误	检查 JSON、messages、model 和字段类型。
401	密钥无效或缺失	确认使用 `Authorization: Bearer`，并检查密钥状态。
402	余额不足	购买套餐或充值钱包后重试。
429	触发频率或并发限制	降低请求频率，使用指数退避并检查套餐限制。
502	上游渠道异常	稍后重试；提供 X-Request-ID 便于平台排查。

07 / 用量

计费、额度与限制

按 Token 计量

每次响应都会返回 usage。输入 Token 和输出 Token 分开统计，网关会将费用写入用量日志。

套餐限制

套餐可能包含 RPM、并发数和模型访问范围。实际可用模型以 GET /v1/models 返回结果为准。

按量结算

用户端不公开模型输入输出单价；调用费用按真实 Token 用量、渠道成本、模型销售倍率和会员倍率换算为人民币额度，并受最低毛利保护。

08 / 上线前检查

生产环境安全建议

使用服务器环境变量保存 API Key，不要写进前端代码。
为不同服务创建不同密钥，按项目需要设置名称并定期轮换。
记录并保留 X-Request-ID，发生错误时可以在控制台用量日志中定位。
生产环境建议使用 HTTPS，并为请求设置超时和指数退避重试。