模型与能力
Models
ClawdRouter 聚合 OpenAI、Anthropic、Google 以及更多国内外主流模型厂商。你可以先按能力选择接口,再查询当前 Key 可调用模型和全部模型列表,快速确定合适的 model 与调用路径。
统一文本对话Chat / Responses / Messages
图片与文件理解图片理解、PDF、Gemini 原生多模态
图片生成GPT Image、Gemini Image
视频生成Veo 异步视频生成
模型查询按 Key 查询可用模型、查看全部模型列表
按能力选择入口
Chat文本生成:统一聊天
POST /v1/chat/completions默认推荐入口。适合统一调用 GPT、Claude、Gemini 等主流聊天模型。
Responses文本生成:Responses APIPOST /v1/responses适合 GPT-5.5 等新协议模型,以及需要推理、工具调用和结构化输出的场景。
Messages文本生成:Claude 原生协议POST /v1/messages适合已有 Anthropic SDK 或需要保留 Claude 原生请求格式的项目。
Images图片生成:GPT ImagePOST /v1/images/generations适合 GPT Image 系列模型。Gemini 图片模型请使用 Google 原生多模态接口。
Multimodal图片与文件理解:Gemini 原生多模态POST /v1beta/models/{model}:{method}适合 Gemini 文本、图片理解、PDF 文件理解,也可用于 Gemini 图片生成。
Video视频生成:VeoPOST /v1/video/generations异步视频生成接口。请求受理后,可到控制台任务中心下载结果。
模型查询接口
用于查询当前 Key 可调用模型,以及服务侧已接入的全部模型列表。
| 接口 | 用途 | 返回重点 | 适合场景 |
|---|---|---|---|
GET /v1/models | 查询当前 Bearer Key 可访问的模型 | id、vendorKey、name、callable | 接入前确认某个 Key 当前能用哪些模型 |
GET /v1/models/all | 查询服务侧已接入的全部模型 | id、vendorKey、name、opened | 做模型总览、后台配置或同步候选模型清单 |
详细字段和响应示例请查看:
模型选择建议
最快接入聊天能力
先用 /v1/chat/completions,优先从 gpt-4o、claude-sonnet-4-6、gemini-2.5-flash 这类通用模型开始。
更强推理或工具编排
优先查看 /v1/responses,适合 GPT-5.5 系列和需要推理、工具与结构化输出的复杂任务。
保持厂商原生协议
Claude 优先使用 /v1/messages;Gemini 图片、PDF 和多模态能力优先使用 /v1beta/models/{model}:{method}。
先查目录再决定具体模型
当你不确定权限或模型开放情况时,先查 /v1/models 或 /v1/models/all,再确定业务侧实际使用的 model 值。
使用说明
- 想先快速接入:优先使用
POST /v1/chat/completions。 - 想先确认某个 Key 能调用哪些模型:使用
GET /v1/models。 - 想查看当前开放了哪些模型:使用
GET /v1/models/all。 - 想保持 Anthropic 原生请求格式:使用
POST /v1/messages。 - 想用 Gemini 图片或 Google 原生能力:使用
POST /v1beta/models/\{model\}:\{method\}。 - 想生成视频:使用
POST /v1/video/generations,并在控制台任务中心下载结果。 - 实际可用模型以你的账户权限和当前开放列表为准。
下一步
- 查询当前 Key 可调用模型 - 查询当前 Key 实际可访问模型
- 查询全部模型 - 查看服务侧模型列表和开放状态
- API 指南 - 了解不同协议的接入选择
- 多模态 / 视频生成 - 查看视频模型选择和提示词建议