赤兔 AI 官方 API 文档

通过 Cheetoo API 将智能对话集成到你的服务端应用。注册后在开发者中心查看系统自动签发的账号专属密钥，在余额与充值查看价格。

开始使用

1. 注册账号后，系统会自动创建独立 API Key，无需管理员审批。
2. 接口根地址为本站域名加 /v1，仅在服务端保存密钥。
3. 请求携带 Authorization: Bearer ctk_你的密钥。

可用接口

模型名称

• cheetoo-1.0：赤兔模型 1.0
• cheetoo-1.0-free：赤兔模型 1.0 FREE（免费）
• cheetoo-1.0-ultra：赤兔模型 1.0 Ultra

请求参数

model 为模型名称；messages 为包含 role、content 的消息数组。role 支持 system、user、assistant，最后一条必须为 user。最多 100 条、48000 字、200 KB 请求体。当前开放接口支持纯文本、非流式响应，stream 仅支持 false；网页配图与图片工作台不属于此接口。未知参数会返回 400。

curl https://你的域名/v1/chat/completions \
  -H "Authorization: Bearer $CHEETOO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"cheetoo-1.0","messages":[{"role":"user","content":"你好"}],"stream":false}'

返回格式

从 choices[0].message.content 读取回答。响应包含 id、object、created、model、choices；响应头 X-Request-ID 可用于排查问题。不提供未经服务确认的 Token 统计，费用以余额流水为准。

错误与重试

错误结构为 {"error":{"message":"说明","type":"request_error","code":"400","request_id":"ctreq_..."}}。超时不代表服务未处理请求，请先核对流水；SDK 不自动重试收费请求。每个账号最多同时执行一个生成任务，网页与接口共用此限制。

计费与数据

调用使用账号余额，请求前预扣、成功后按 Token 用量结算并退回差额。缺少用量或结果不明时保留预扣等待核对。多密钥共享账号限额；限额按有效请求次数计算，失败尝试可能计入。接口不保存消息正文到对话列表，只保留请求编号、状态、时间、模型版本和财务记录。

官方 SDK

下载 PHP、Python、JavaScript SDK 与示例

PHP 需要 PHP 8.2 和 cURL；Python 使用标准库；JavaScript 用于支持 fetch 的服务端 Node.js 环境。SDK 使用本服务定义的接口字段，不承诺兼容其他服务的所有 SDK 参数。