cocodot
cocodot Developer Docs

API 文档

一个 key 调 Claude / GPT / Gemini / DeepSeek。OpenAI 兼容 —— 改 base_url 即用;另有 Anthropic 兼容端点,Claude Code 可直连。

1. 快速开始

  1. 注册 cocodot.co/register,验证邮箱送 $0.5 体验额度(够跑通测试)。
  2. 控制台 → AI 页创建 API Key(sk- 开头)。
  3. 把 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/completionsAuthorization: Bearer sk-…
消息(Anthropic 兼容)POST /api/ai/v1/messagesAPI 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-6Claude Opus 4.8旗舰:写作/推理/agent
mco-5Claude Opus 4.7上一代旗舰
mcs-5Claude Sonnet 4.6日常主力,性价比高
mch-1Claude Haiku 4.5快而便宜
mog-6GPT-5.5OpenAI 通用
mog-5GPT-5.3-codex编程向
mgg-10Gemini 3.1 ProGoogle 多模态
deepseek-v4-proDeepSeek V4 Pro国产便宜大碗

全量模型与实时单价(权威来源):GET https://cocodot.co/api/ai/models · 海外模型官网 9 折起、封顶不超官网。成本计算器 →

7. 计费与额度

8. 限制与错误码

状态码含义与处理
401API key 无效或缺失 —— 检查 Authorization: Bearer 头。
402余额不足 —— 去控制台充值(支付宝/银行卡)。
413请求体过大 —— 上限 25 MB(支持超长上下文,超出请裁剪)。
400请求有误 —— 模型 ID 不存在或 body 格式错误。
5xx上游波动 —— 建议退避重试;持续出现联系客服。

9. 常见问题与支持

是满血模型吗?会不会降智?

走持牌云厂商官转(非逆向)。随时自己验:降智检测(方法开源)。

数据隐私?

请求仅用于转发推理,不用于训练;账单只记 token 数与金额。

遇到问题?

控制台内联系客服,或看 教程中心 · 为什么可信

开始接入

注册 → 验证邮箱领 $0.5 → 建 key,全程 2 分钟。

去拿 API Key →
API 文档 — cocodot 开发者接入 · AI Global Pass