快速入门
快速开始
在五分钟内发出你的第一个请求。拿到密钥、粘贴 curl 命令、看响应返回。
能拿到什么
Caicaini API 通过单一 HTTP 端点为你提供托管模型的程序化访问能力。请求形态对齐业界通行的 Messages API 约定，任何针对该形态的客户端——你自己写的、第三方封装、或者直接 fetch——无需改动即可使用。
认证使用 bearer token。计费走的是一个独立的 apiCredits 池，由你直接充值——API 流量永远不会动到订阅积分，反之亦然。
1. 生成 API 密钥
登录后访问 /developers/keys，点击 Create key。密钥以 cai_api_ 前缀开头，且仅显示一次——关闭对话框前请把完整密钥保存到密码管理器或环境变量。
2. 导出密钥
把密钥保存到 shell 里，避免提交进版本控制。下面的示例都从 CAICAINI_API_KEY 读取。
shell
export CAICAINI_API_KEY="cai_api_..."3. 发送消息
请求体最少需要 model、max_tokens 和 messages。如果想让智能路由替你选模型，使用 caicaini/auto——完整列表见 模型。
curl https://caicaini.com/v1/messages \
-H "Authorization: Bearer cai_api_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "caicaini/auto",
"max_tokens": 256,
"messages": [
{"role": "user", "content": "Write a haiku about overdue invoices."}
]
}'4. 读取响应
每个成功响应都包含一个 id、一个 content 块数组（先文本，再是任何工具调用或思考块）、解析后的 model、一个 stop_reason，以及一个 usage 对象，精确告诉你这一轮花了多少积分。
响应 · 200 OK
{
"id": "msg_01H8fkx2N3p4q5r6s7t8u9v0wx",
"type": "message",
"role": "assistant",
"content": [
{
"type": "text",
"text": "Inbox keeps glowing — / payment terms net thirty days, / silence net forever."
}
],
"model": "caicaini/auto",
"stop_reason": "end_turn",
"usage": {
"input_tokens": 14,
"output_tokens": 23,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 0,
"credits_consumed": 12
}
}usage.credits_consumed 字段是 Caicaini 自有扩展。它是权威值——这里看到多少，就是从你 apiCredits 余额里扣了多少。