API 文档
ClawGate 提供统一 API 接口，兼容 OpenAI、Anthropic、Codex 格式。一个 Key 调用所有主流模型。
Base URL: https://xiaoclaw.com
🚀 快速开始
1
注册账号
访问 Dashboard 注册。新用户自动获得 $1 免费额度。
2
获取 API Key
在 Dashboard 点击「+ New Key」，复制 sk-cg-xxxx... 保存好（只显示一次）。
3
调用 API
用你的 Key 调用任意端点：
curl https://xiaoclaw.com/v1/chat/completions \
-H "Authorization: Bearer sk-cg-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-5-20250514",
"messages": [{"role": "user", "content": "Hello!"}]
}'🤖 支持的模型
| 厂商 | 模型 ID | 说明 |
|---|---|---|
| Anthropic | claude-opus-4-6-20260205 | Claude Opus 4.6 — 最强推理 |
| Anthropic | claude-opus-4-5-20250416 | Claude Opus 4.5 |
| Anthropic | claude-sonnet-4-5-20250514 | Claude Sonnet 4.5 — 性价比之选 |
| Anthropic | claude-haiku-4-5-20250514 | Claude Haiku 4.5 — 快速轻量 |
| OpenAI | gpt-5 | GPT-5 |
| OpenAI | gpt-5.2 | GPT-5.2 |
| OpenAI | gpt-5.3-codex | GPT-5.3 Codex — 代码专用 |
gemini-2.5-pro | Gemini 2.5 Pro | |
gemini-3-pro | Gemini 3 Pro — 最新 |
完整列表请调用 GET /v1/models 获取。
POST /v1/chat/completions
OpenAI 兼容格式。适用于所有模型（包括 Claude、GPT、Gemini）。
curl https://xiaoclaw.com/v1/chat/completions \
-H "Authorization: Bearer sk-cg-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-5-20250514",
"max_tokens": 1024,
"messages": [
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "用 Python 写一个快排"}
]
}'请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | ✓ | 模型 ID |
| messages | array | ✓ | 对话消息数组 |
| max_tokens | integer | - | 最大输出 token 数 |
| temperature | number | - | 采样温度 0-2 |
| stream | boolean | - | 是否流式输出 |
POST /v1/messages
Anthropic 原生格式。适用于 Claude 系列模型。
curl https://xiaoclaw.com/v1/messages \
-H "x-api-key: sk-cg-YOUR_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-5-20250514",
"max_tokens": 1024,
"messages": [
{"role": "user", "content": "解释量子计算"}
]
}'POST /v1/responses
Codex 格式（OpenAI Responses API）。
也支持 /codex/v1/responses 路径。
curl https://xiaoclaw.com/v1/responses \
-H "Authorization: Bearer sk-cg-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.3-codex",
"input": "Write a Python function to merge two sorted lists"
}'GET /v1/models
获取当前可用的模型列表。
curl https://xiaoclaw.com/v1/models \
-H "Authorization: Bearer sk-cg-YOUR_KEY"🔑 认证方式
ClawGate 支持两种认证方式，任选其一：
方式一：Bearer Token（推荐）
适用于 OpenAI 兼容客户端（ChatGPT 插件、Cursor、Continue 等）
Authorization: Bearer sk-cg-YOUR_KEY方式二：x-api-key Header
适用于 Anthropic 原生客户端（Claude Code 等）
x-api-key: sk-cg-YOUR_KEY⚠️ 错误码
| HTTP 状态码 | 含义 | 处理建议 |
|---|---|---|
| 400 | 请求格式错误 | 检查 JSON 格式和必填参数 |
| 401 | 认证失败 | 检查 API Key 是否正确 |
| 402 | 余额不足 | 前往 Dashboard 充值 |
| 404 | 模型不存在 | 调用 /v1/models 查看可用模型 |
| 429 | 请求过于频繁 | 降低请求频率，稍后重试 |
| 500 | 服务器内部错误 | 稍后重试，如持续请联系支持 |
| 502/503 | 上游模型服务不可用 | 上游 API 暂时不可用，稍后重试 |
错误响应格式
{
"error": {
"message": "Insufficient credits",
"type": "insufficient_credits",
"code": 402
}
}