API 文档
一个 key 调 Claude / GPT / Gemini / DeepSeek。OpenAI 兼容 —— 改 base_url 即用;另有 Anthropic 兼容端点,Claude Code 可直连。
1. 快速开始
- 注册 cocodot.co/register,验证邮箱送 $0.5 体验额度(够跑通测试)。
- 在控制台 → AI 页创建 API Key(sk- 开头)。
- 把 base_url 指向 cocodot,直接调:
curl https://cocodot.co/api/ai/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-YOUR_KEY" \
-d '{
"model": "mcs-5",
"messages": [{"role": "user", "content": "你好!"}]
}'2. 端点与鉴权
| 用途 | 端点 | 鉴权 |
|---|---|---|
| 对话(OpenAI 兼容) | POST /api/ai/v1/chat/completions | Authorization: Bearer sk-… |
| 消息(Anthropic 兼容) | POST /api/ai/v1/messages | API key(见 §5) |
| 模型列表 + 实时价格 | GET /api/ai/models | 公开,无需鉴权 |
OpenAI SDK 的 base_url 填:https://cocodot.co/api/ai/v1
3. 代码示例
Python(openai SDK)
from openai import OpenAI
client = OpenAI(
base_url="https://cocodot.co/api/ai/v1",
api_key="sk-YOUR_KEY",
)
resp = client.chat.completions.create(
model="mco-6", # Claude Opus 4.8
messages=[{"role": "user", "content": "写一首关于大海的俳句"}],
)
print(resp.choices[0].message.content)Node.js(openai SDK)
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://cocodot.co/api/ai/v1",
apiKey: "sk-YOUR_KEY",
});
const resp = await client.chat.completions.create({
model: "mog-6", // GPT-5.5
messages: [{ role: "user", content: "Hello!" }],
});
console.log(resp.choices[0].message.content);更多示例(LangChain / Cursor / 流式):github.com/oncesylvia/cocodot-api-examples ↗
4. 流式输出
传 stream: true 即可 —— 标准 SSE,所有 OpenAI SDK 原生支持。用量按上游 usage 计费(上游缺失时按字符估算)。
stream = client.chat.completions.create(
model="mcs-5",
messages=[{"role": "user", "content": "..."}],
stream=True,
)
for chunk in stream:
print(chunk.choices[0].delta.content or "", end="")标准 OpenAI 参数直接透传:temperature、top_p、max_tokens、stop、presence_penalty、frequency_penalty、seed、response_format(JSON 模式)、tools / tool_choice(工具调用)、stream_options(如 include_usage)。高级特性的可用性取决于所选模型。
5. Claude Code 直连(Anthropic 兼容)
cocodot 提供 Anthropic 兼容的 /v1/messages 端点,Claude Code 设两个环境变量即可直连(内测):
export ANTHROPIC_BASE_URL=https://cocodot.co/api/ai
export ANTHROPIC_API_KEY=sk-YOUR_KEY
claude # 然后正常使用 Claude Code模型名自动映射(opus → mco-6,sonnet → mcs-5,haiku → mch-1)。详见 /claude-code
6. 模型与价格
| 模型 ID | 名称 | 说明 |
|---|---|---|
| mco-6 | Claude Opus 4.8 | 旗舰:写作/推理/agent |
| mco-5 | Claude Opus 4.7 | 上一代旗舰 |
| mcs-5 | Claude Sonnet 4.6 | 日常主力,性价比高 |
| mch-1 | Claude Haiku 4.5 | 快而便宜 |
| mog-6 | GPT-5.5 | OpenAI 通用 |
| mog-5 | GPT-5.3-codex | 编程向 |
| mgg-10 | Gemini 3.1 Pro | Google 多模态 |
| deepseek-v4-pro | DeepSeek V4 Pro | 国产便宜大碗 |
全量模型与实时单价(权威来源):GET https://cocodot.co/api/ai/models · 海外模型官网 9 折起、封顶不超官网。成本计算器 →
7. 计费与额度
- 按 token 从 cocodot 余额扣费(支付宝 / 银行卡充值),无订阅、无月费。
- 验证邮箱送 $0.5 体验额度(仅可调 API),先验质量再充值。
- 每次调用在控制台流水里逐笔可查(模型 / tokens / 金额)。
- 不信就验 —— 用降智检测工具测任何中转(包括我们):probe.cocodot.co
8. 限制与错误码
| 状态码 | 含义与处理 |
|---|---|
| 401 | API key 无效或缺失 —— 检查 Authorization: Bearer 头。 |
| 402 | 余额不足 —— 去控制台充值(支付宝/银行卡)。 |
| 413 | 请求体过大 —— 上限 25 MB(支持超长上下文,超出请裁剪)。 |
| 400 | 请求有误 —— 模型 ID 不存在或 body 格式错误。 |
| 5xx | 上游波动 —— 建议退避重试;持续出现联系客服。 |
9. 常见问题与支持
走持牌云厂商官转(非逆向)。随时自己验:降智检测(方法开源)。
请求仅用于转发推理,不用于训练;账单只记 token 数与金额。