API 指南
ClawdRouter 提供统一的模型调用入口。API 指南用于解释“该怎么接入、怎么选协议、哪些行为需要注意”；下方的 API 参考只保留具体接口、请求字段和响应结构。
先选择调用路径
| 目标 | 推荐接口 | 适合场景 |
|---|---|---|
| 统一文本对话 | POST /v1/chat/completions | 默认入口，适合 OpenAI、Claude、Gemini 等聊天模型 |
| Responses | POST /v1/responses | 已使用 Responses API 或 GPT-5.x 新协议的项目 |
| Claude 原生协议 | POST /v1/messages | 已使用 Anthropic SDK，或需要 Claude 原生消息格式 |
| Gemini 多模态 | POST /v1beta/models/{model}:{method} | Gemini 原生文本、图片或多模态能力 |
| Google Interactions | POST /v1beta/interactions | 已接入 Google Interactions API，需要调用模型或 Agent、多模态输入、工具或后台任务 |
| Images | POST /v1/images/generations | GPT 图片生成能力 |
| Veo 视频生成 | POST /v1/video/generations | 异步文生视频、图生视频，结果到任务中心下载 |
指南与参考怎么分工
- API 指南：解释认证、参数、流式输出、错误排查等 API 使用方法。多模态能力说明位于文档 / 多模态。
- API 参考：只描述具体 endpoint 的
method、path、headers、request body、response body 和错误形态。
工具调用
平台提供各厂商原生搜索、文件检索与 Grounding 工具。请求结构保持厂商协议不变，并使用平台提供的工具标识；具体工具清单与请求示例见工具调用。
常用指南
认证鉴权了解 API Key、Bearer Token、BYOK 和安全建议。通用参数理解 model、messages、temperature、tools、response_format 等常用字段。流式输出学习 SSE 响应格式、客户端读取方式和中断处理。工具调用使用网络搜索、文件检索与 Grounding 工具。多模态处理图片、PDF 文件和 Veo 视频生成等多模态任务。
API 参考入口
| 分组 | 接口 |
|---|---|
| Chat Completions | 创建聊天补全、Claude 兼容聊天补全、Gemini 兼容聊天补全 |
| Messages | 创建消息 |
| Responses | 创建回复 |
| Google Interactions | 创建与查询 Interaction |
| Models | 查询当前 Key 可调用模型、查询全部模型 |
| Images | 图片生成、图片编辑 |
| Multimodal | Gemini 多模态、Veo 视频生成 |