API 文档

一个 key 调 Claude / GPT / Gemini / DeepSeek。OpenAI 兼容 —— 改 base_url 即用;Anthropic 兼容端点支持 Claude Code 直连与 PDF 输入;模型名可直接填官方名。

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": "claude-opus-4-8",
    "messages": [{"role": "user", "content": "你好!"}]
  }'

颜色说明:黄色 = 换成你自己的值 · 绿色 = 模型名(官方名可直填) · 蓝色 = cocodot 端点(原样复制)

2. 端点与鉴权

OpenAI SDK / 客户端的 base_url 填:https://cocodot.co/api/ai/v1 · Anthropic SDK / Claude Code 填:https://cocodot.co/api/ai

3. 模型、价格与官方名直填

模型名填「官方名」或「cocodot 短代号」都行 —— 路由与计费完全一致,大小写不敏感。SillyTavern / Cursor 等客户端直接选官方名即可。

匹配按关键词:名字里含 opus 即路由到 Opus 4.8、含 sonnet 到 Sonnet、含 gpt 到 GPT-5.5,以此类推;完全不认识的名字原样透传上游。全量模型与实时单价(权威来源):GET https://cocodot.co/api/ai/models各模型单价 →成本计算器 →

🔥 Fable 5(mcf-1)是 Anthropic 最新旗舰,国内直连、无需额外参数(其零数据保留要求由我们自动处理)。 · 全线封顶不超官网,主力型号官网 9 折。部分模型按输入长度分档计价,每一档都在价格页列明。

4. 代码示例

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="claude-opus-4-8",  # 官方名可直填;写 "mco-6" 也行
    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: "gpt-5.5",
  messages: [{ role: "user", content: "Hello!" }],
});
console.log(resp.choices[0].message.content);

Python(anthropic SDK,原生 Messages 格式)

from anthropic import Anthropic

client = Anthropic(
    base_url="https://cocodot.co/api/ai",  # 注意:这里不带 /v1
    api_key="sk-YOUR_KEY",
)
msg = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好!"}],
)
print(msg.content[0].text)

更多示例(LangChain / 流式 / 工具调用):github.com/cocodot2026/cocodot-api-examples ↗

5. 客户端接入

所有 OpenAI 兼容客户端都能接。问得最多的四个,照抄即通:

SillyTavern(酒馆)

1. API 选「聊天补全 Chat Completion」,来源选「自定义 (OpenAI-compatible)」
2. 自定义端点(Base URL)填 https://cocodot.co/api/ai/v1,API Key 填你的 sk-…
3. 点「连接」→ 模型下拉自动拉取(走 /v1/models),选 claude-opus-4-8 等官方名即可开聊。

Cursor

1. Settings → Models → API Keys:把 sk-… 填进「OpenAI API Key」
2. 打开「Override OpenAI Base URL」,填 https://cocodot.co/api/ai/v1
3. 在模型列表添加/勾选要用的官方名(claude-opus-4-8、gpt-5.5…),点 Verify 通过即用。

Cline(VS Code)

1. API Provider 选「OpenAI Compatible」
2. Base URL 填 https://cocodot.co/api/ai/v1,API Key 填 sk-…
3. Model ID 填 claude-opus-4-8(或其他官方名)。

Claude Code

export ANTHROPIC_BASE_URL=https://cocodot.co/api/ai
export ANTHROPIC_API_KEY=sk-YOUR_KEY
claude   # 然后正常使用 Claude Code

模型名自动映射(fable → mcf-1,opus → mco-6,sonnet → mcs-5,haiku → mch-1)。详见 /claude-code

6. 流式输出

传 stream: true 即可 —— 标准 SSE,所有 OpenAI SDK 原生支持。用量按上游 usage 计费(上游缺失时按字符估算)。

stream = client.chat.completions.create(
    model="claude-sonnet-4-6",
    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)。高级特性的可用性取决于所选模型。

7. 工具调用与 JSON 模式

工具调用(function calling)走标准 OpenAI tools 格式、直接透传 —— Claude / GPT / Gemini 旗舰模型都支持。

resp = client.chat.completions.create(
    model="claude-opus-4-8",
    messages=[{"role": "user", "content": "上海今天天气怎么样?"}],
    tools=[{
        "type": "function",
        "function": {
            "name": "get_weather",
            "description": "查询城市当前天气",
            "parameters": {
                "type": "object",
                "properties": {"city": {"type": "string"}},
                "required": ["city"],
            },
        },
    }],
)
# 模型决定调用工具:
print(resp.choices[0].message.tool_calls)

需要严格 JSON 输出时传 response_format={"type": "json_object"}(记得在 prompt 里同时要求输出 JSON)。

8. PDF / 文档输入

Claude 系模型可直接读 PDF —— 走 Anthropic 兼容端点 /v1/messages,用 document 内容块(base64)传入。

import base64
from anthropic import Anthropic

client = Anthropic(base_url="https://cocodot.co/api/ai", api_key="sk-YOUR_KEY")
pdf_b64 = base64.b64encode(open("report.pdf", "rb").read()).decode()

msg = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=2048,
    messages=[{
        "role": "user",
        "content": [
            {"type": "document", "source": {"type": "base64", "media_type": "application/pdf", "data": pdf_b64}},
            {"type": "text", "text": "总结这份文档"},
        ],
    }],
)
print(msg.content[0].text)

PDF 按输入 token 计费(文本 + 每页图像),与 Anthropic 官方口径一致。请求体上限 25 MB。

9. 计费与额度

• 按 token 从 cocodot 余额扣费(支付宝 / 银行卡充值),无订阅、无月费。
• 验证邮箱送 $0.5 体验额度(仅可调 API)。体验额度可调 DeepSeek / Qwen / Haiku 等实惠模型;充值后解锁 Opus / GPT / Gemini 全系旗舰。
• 每次调用在控制台流水里逐笔可查(模型 / tokens / 金额)。
• 不信就验 —— 用降智检测工具测任何中转(包括我们):probe.cocodot.co

10. 限制与错误码

11. 常见问题与支持