跳到主要内容

快速开始

5 分钟内完成第一条请求，并知道后续该从哪里继续扩展。

前提条件​

先选接入方式​

如果你还没有明确要走哪条协议，建议按下面选择：

场景推荐终结点说明
默认文本对话POST /v1/chat/completions最适合作为第一条请求
OpenAI Responses 协议POST /v1/responses适合 GPT-5.5 等新模型
Claude 原生协议POST /v1/messages适合已有 Anthropic SDK 项目
Gemini 原生多模态POST /v1beta/models/{model}:{method}适合图片生成和 Google 原生能力
Veo 视频生成POST /v1/video/generations异步任务，提交后到任务中心看结果

基础信息​

配置项值
API Base URL__DOCS_API_ORIGIN__
OpenAI 协议端点POST /v1/chat/completions
OpenAI Responses 协议端点POST /v1/responses
OpenAI 图片生成端点POST /v1/images/generations
Anthropic 协议端点POST /v1/messages
Google 多模态端点POST /v1beta/models/{model}:{method}
视频生成端点POST /v1/video/generations
认证方式Authorization: Bearer YOUR_API_KEY

发送第一个同步请求​

最简单的方式是先用 cURL 调用统一聊天接口：

curl __DOCS_API_ORIGIN__/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "你好"}
    ]
  }'

如果这条请求成功，就说明你的账号、Key 和网络都已经打通。

使用 SDK​

ClawdRouter 完全兼容 OpenAI SDK，只需修改 base_url 即可。

Python​

pip install openai
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="__DOCS_API_ORIGIN__/v1",
)

completion = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "user", "content": "你好，请介绍一下你自己"}
    ],
)

print(completion.choices[0].message.content)

Node.js​

npm install openai
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "__DOCS_API_ORIGIN__/v1",
});

async function main() {
  const completion = await client.chat.completions.create({
    model: "gpt-4o",
    messages: [
      { role: "user", content: "你好，请介绍一下你自己" },
    ],
  });

  console.log(completion.choices[0].message.content);
}

main();

提交第一个视频任务​

如果你的目标是 Veo 视频生成，请改用专用视频接口：

curl __DOCS_API_ORIGIN__/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "veo-3.1-fast-generate-001",
    "prompt": "A cute small bird dancing on a tree branch, moving rhythmically to cheerful music. The bird gently sways its body, lightly flaps its wings, and playfully tilts its head. Bright forest background with soft sunlight and subtle shadows. Semi-realistic, slightly cartoon style, vivid but not over-saturated colors. Static camera, centered subject, smooth motion, medium detail. 720p resolution, clear and stable output.",
    "duration": 4,
    "metadata": {
      "durationSeconds": 4,
      "aspectRatio": "16:9",
      "resolution": "720p",
      "negativePrompt": "low quality, blurry, distorted",
      "personGeneration": "allow_adult",
      "generateAudio": true
    }
  }'

典型情况下，视频请求会先返回异步受理结果：

{
  "request_id": "req_1234567890",
  "task_id": "task_1234567890",
  "status": "accepted",
  "message": "Task accepted for asynchronous processing."
}
视频结果在哪里看？

拿到 task_id 后，请到控制台任务中心下载生成结果。202 Accepted 只代表平台已经受理请求，不代表视频已经生成完成。

常见扩展​

  • 需要流式输出：在聊天请求里设置 stream: true
  • 需要切换厂商：保持请求结构不变，只改 model
  • 需要 Claude 原生协议：改用 POST /v1/messages
  • 需要 Gemini 图片或原生多模态：改用 POST /v1beta/models/{model}:{method}
  • 需要视频生成：改用 POST /v1/video/generations

切换模型​

ClawdRouter 的核心优势之一就是能够在不同厂商的模型之间自由切换，只需更改 model 参数：

# 使用 OpenAI 模型
completion = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "你好"}],
)

# 切换到 Anthropic 模型 — 仅需更改 model 参数
completion = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "你好"}],
)

# 切换到 Google 模型
completion = client.chat.completions.create(
    model="gemini-2.5-flash",
    messages=[{"role": "user", "content": "你好"}],
)
如何选择协议？
  • OpenAI 协议 (/v1/chat/completions) — 支持所有厂商的模型，适合统一调用
  • OpenAI Responses 协议 (/v1/responses) — GPT-5.5 等新模型推荐使用
  • OpenAI 图片生成 (/v1/images/generations) — GPT 图片生成
  • Anthropic 协议 (/v1/messages) — Anthropic 原生格式，适合已有 Anthropic SDK 集成的项目
  • Google 原生协议 (/v1beta/models/{model}:{method}) — Gemini 多模态能力（文本/生图）
  • 视频生成 API (/v1/video/generations) — Veo 视频生成，异步返回任务结果

下一步​