常见问题

基础问题

ClawdRouter 是什么？

ClawdRouter 是一个 AI 大模型聚合平台，提供统一的 API 接口（支持 OpenAI 协议和 Anthropic 原生协议），让你通过一个端点访问来自 OpenAI、Anthropic、Google 等多家厂商的大语言模型。

支持哪些模型？

目前支持以下厂商的模型：

OpenAI：GPT-4o、GPT-4.1、GPT-5 系列、o1/o3/o4 推理模型等
Anthropic：Claude 3/3.5/3.7/4/4.5/4.6 系列
Google：Gemini 2.5/3/3.1 系列

完整列表请查看模型列表。

与直接调用官方 API 有什么区别？

统一接口：所有模型使用相同的 API 格式，无需适配不同厂商的接口
简化接入：只需一个 API Key，即可访问所有厂商的模型
无缝切换：更改 model 参数即可在不同模型间切换，无需修改代码

什么是 BYOK（自带 Key）？

BYOK（Bring Your Own Key）允许你将自有的供应商 API Key 接入平台，享受统一的 API 管理和路由能力，同时使用自己的供应商资源。详见 BYOK 文档。

如何联系技术支持？

所有技术问题、需求和反馈都可以通过提交工单联系我们。详见工单与技术支持。

API 与协议

API 请求的基础 URL 是什么？

__DOCS_API_ORIGIN__/v1

支持哪些 API 端点？

目前支持以下端点：

端点	方法	协议	说明
`/v1/chat/completions`	POST	OpenAI	聊天补全，支持所有厂商模型
`/v1/responses`	POST	OpenAI	Responses API，适合 GPT-5.5 等新模型
`/v1/images/generations`	POST	OpenAI	图片生成
`/v1/messages`	POST	Anthropic	Anthropic 原生协议，支持 Claude 系列模型
`/v1beta/models/{model}:{method}`	POST	Google	Gemini 原生多模态和图片生成
`/v1/video/generations`	POST	Video API	Veo 视频生成，异步返回任务结果

是否兼容 OpenAI SDK？

是的，ClawdRouter 完全兼容 OpenAI SDK。你只需将 base_url 修改为 __DOCS_API_ORIGIN__/v1，即可使用官方 SDK 的所有功能。

此外，还支持 Anthropic SDK，将 base_url 修改为 __DOCS_API_ORIGIN__ 即可通过原生协议调用 Claude 模型。

是否支持流式输出？

是的，所有模型均支持流式输出。在请求中设置 stream: true 即可启用。

是否支持 Function Calling / Tool Use？

是的，支持 Function Calling 的模型均可通过 tools 和 tool_choice 参数使用此功能。

视频与异步任务

视频接口为什么返回 202 Accepted？

因为 Veo 视频生成属于异步任务。202 Accepted 代表平台已经成功受理请求，但模型侧可能仍在生成中。最终是否成功，需要结合任务状态和结果状态判断。

提交视频请求后去哪里看结果？

请到控制台任务中心下载生成结果。建议保留好 task_id 和 request_id，它们分别对应任务排查和请求排查。

任务中心、日志管理、下载中心有什么区别？

任务中心看“这个异步任务后来怎么样了”
日志管理看“这次调用发生了什么”
下载中心看“导出的文件是否已生成”

如果是视频生成结果、过期提醒、下载链接或失败任务，请优先进入任务中心。

为什么日志里显示成功，任务中心却显示失败？

这通常说明请求层已经成功受理，但任务层最终执行失败。视频等异步能力需要同时看请求状态和任务状态，这也是日志管理和任务中心要分开的原因。

结果过期后还能恢复吗？

通常不能直接恢复，需要根据原始调用参数重新发起生成。建议优先处理任务中心里“待下载”和“即将过期”的任务。

认证与安全

如何获取 API Key？

API Key 泄露了怎么办？

请立即在控制台禁用该 Key 并创建新的 Key。被禁用的 Key 将立即失效。

请求是否加密？

所有 API 请求均通过 HTTPS 传输，数据在传输过程中是加密的。

常见错误

401 Unauthorized

API Key 无效或缺失。请检查：

Authorization Header 是否存在
格式是否为 Bearer YOUR_API_KEY
API Key 是否有效（未过期、未禁用）

429 Too Many Requests

请求频率超过限制。请：

降低请求频率
实施指数退避重试策略
如需更高限额，请提交工单联系技术支持

500 Internal Server Error

服务端出现异常。请：

稍后重试
如果持续出现，请携带 traceId 提交工单联系技术支持

计费相关

如何计费？

按照实际使用的 Token 数量计费，不同模型有不同的单价。具体价格请在控制台查看。

什么是 Token？

Token 是模型处理文本的基本单位。大致上，1 个中文字约等于 1-2 个 Token，1 个英文单词约等于 1 个 Token。每次请求的 Token 用量包含在响应的 usage 字段中。

如何查看用量？

在控制台的用量统计页面可以查看历史调用记录和 Token 消耗情况。

下一步

快速开始 - 先完成第一条请求
认证鉴权 - 排查 API Key 和请求头问题
控制台任务中心 - 下载视频等异步任务的生成结果
工单与技术支持 - 需要人工协助时提交工单

基础问题​

API 与协议​

视频与异步任务​

认证与安全​

常见错误​

计费相关​

下一步​