CHEETOO MODEL API GATEWAY · 模型 API 聚合网关
赤兔AI智能聚合引擎(cheetoo)模型 API 接入文档
本站为标准 AI 模型 API 聚合网关(仅开放标准大模型 API 接口,不开放其他非模型业务功能对接)。完全兼容 OpenAI 标准协议,只需配置一个网关地址 + 一个 API 密钥即可在任意客户端、SDK 或业务系统中直接调用。
1. 网关接入三要素(单网关 + 单密钥直连)
登录控制台并在「API 密钥」页面创建密钥后,即可在 Cherry Studio、Minis (iOS)、Cursor、NextChat、ChatBox、LobeChat 或标准 OpenAI SDK 中直接填入以下配置:
| 配置项 | 标准值 / 格式 | 说明 |
|---|---|---|
| API 网关地址 (Base URL) | https://www.cheetoo.cc/v1 | 所有第三方客户端统一填写的接口根地址 |
| 鉴权请求头 (Authorization) | Authorization: Bearer sk-xxxxxxxx | 单密钥 Bearer Token 直连鉴权(兼容 x-api-key) |
| 通用旗舰模型 | cheetoo-1.3-pro | 1M 超长上下文 · 支持代码研发、深度推理、流式输出与深度思考 |
| 文旅出行垂类模型 | cheetoo-1.3-pro-travel | 专注于旅游路线规划、景点交通衔接与旅游营销文案 |
2. 开放的模型 API 接口清单
本网关仅对外提供以下标准大模型 API 端点,不支持对接其他内部管理或非模型接口:
| 方法与端点 | 用途说明 |
|---|---|
GET /v1/models | 获取当前密钥可调用的模型列表及输入/缓存命中/输出单价 |
POST /v1/chat/completions | 发起标准对话生成(支持 stream: true 实时流式打字机输出与深度思考) |
POST /v1/responses | 兼容新版 OpenAI Responses API 协议调用 |
POST /v1/messages | 兼容 Anthropic Messages API 协议调用 |
GET /v1/usage | 查询当前账户/密钥实时剩余可用余额与已用额度(兼容 /api/usage/token 与 /v1/dashboard/billing/subscription) |
3. 模型对话调用示例(POST /v1/chat/completions)
支持标准非流式("stream": false)与 SSE 实时流式打字机输出("stream": true)。如需开启 AI 深度思考能力并获取 reasoning_content 思考过程,可传入 "enable_thinking": true 或 "reasoning_effort": "high":
curl https://www.cheetoo.cc/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-您的API密钥" \
-d '{
"model": "cheetoo-1.3-pro",
"messages": [
{"role": "system", "content": "你是一个专业的技术架构顾问。"},
{"role": "user", "content": "请帮我设计一个高并发接口防重放方案"}
],
"stream": true,
"enable_thinking": true,
"reasoning_effort": "high"
}'
4. Python / Node.js 标准 OpenAI SDK 接入示例
from openai import OpenAI
client = OpenAI(
base_url="https://www.cheetoo.cc/v1",
api_key="sk-您的API密钥"
)
stream = client.chat.completions.create(
model="cheetoo-1.3-pro",
messages=[{"role": "user", "content": "你好,请介绍一下你自己"}],
stream=True
)
for chunk in stream:
delta = chunk.choices[0].delta
if getattr(delta, "reasoning_content", None):
print(delta.reasoning_content, end="", flush=True)
if delta.content:
print(delta.content, end="", flush=True)
5. 计费标准与状态码说明
所有模型调用均按照输入 Token(Input)、缓存命中 Token(Cached Input)与输出 Token(Output)三项标准精确计费,可在控制台「使用记录」与「API 对话」中实时核对每次请求的 Token 明细。
200 OK:调用成功,返回choices与usage(含prompt_tokens、prompt_tokens_details.cached_tokens、completion_tokens)。401 Unauthorized:API 密钥无效、已停用或已过期。402 Payment Required:账户可用余额不足,请前往控制台「我的钱包」充值。403 Forbidden:来源 IP 不在该密钥配置的 IP 白名单内,或账号未完成实名认证。429 Too Many Requests:触发该密钥配置的每分钟/每日频控或消费限额。