开发者指南总览
适用角色：开发者 更新日期：2026-07-02
CloudRouter 提供与 OpenAI / Anthropic / Gemini 生态完全兼容的 API。如果你的代码已经在用 OpenAI 或 Claude 的 SDK，通常只需改两行配置（Base URL + API Key）就能切到 CloudRouter，一套接入即可调用全球主流模型。
一、接入只需三步
① 拿到 API Key → 由组织或子用户在控制台「API 密钥」页创建
② 配置 Base URL → 把请求指向 CloudRouter
③ 发起请求 → 用熟悉的 OpenAI/Anthropic 格式调用详细操作见 快速开始：5 分钟首次调用。
二、核心概念
理解下面几个概念，就理解了整个调用链：
| 概念 | 是什么 | 类比 |
|---|---|---|
| API Key | 你的身份凭证，sk- 开头 | 门禁卡 |
| Base URL | CloudRouter 的 API 地址 | 服务器门牌号 |
| 模型调用名 | 请求里 model 字段填的值 | 点哪道菜 |
| 分组（group） | 同名模型的标签维度，用于消歧和路由 | 你的菜单分区 |
关于模型调用名，v2 提供两种写法：
- 裸模型名，如
claude-sonnet-4-6、gpt-4o：路由到这把 Key 绑定的路由分组（与老版行为一致）。 - 带指纹，如
5MHXZWKA/gpt-4o：按指纹"点名"路由到指定分组。
两种写法都从控制台「调用指南」页复制最稳妥。详细机制、场景选择、网关分流规则见 调用指南与双路由。
你能调用哪些分组 / 模型，取决于你账户的可用模型范围（由平台按组织配置）。调不到某个模型时，先确认可用范围，见 管理员手册 · 地区与模型范围。
三、协议格式
CloudRouter 兼容多种主流协议，你可以按习惯任选：
| 协议 | 端点 | 适合 | 示例文档 |
|---|---|---|---|
| OpenAI 格式 | /v1/chat/completions | 用 OpenAI SDK、大多数框架 | API 调用基础 |
| Anthropic 格式 | /v1/messages | 用 Anthropic SDK、调 Claude | API 调用基础 |
| Gemini 格式 | /v1beta/models/* | 用 Google Gemini SDK | API 调用基础 |
各格式调用的是同一批模型，区别只在请求/响应的字段结构。同一个模型，既可以用 OpenAI 格式调，也可以用 Anthropic 格式调。
四、按你的场景选文档
| 你的情况 | 推荐路径 |
|---|---|
| 第一次用，想先跑通 | 快速开始 |
想搞清楚 model 字段到底写什么 | 调用指南与双路由 |
| 已有 OpenAI/Claude 代码，想迁移 | SDK 接入 |
| 用 Claude Code / Cursor 等工具 | 第三方工具接入 |
| 想了解请求参数、流式输出 | API 调用基础 |
| 遇到报错 | 错误码与排障 |
| 模型偶发输出韩文/日文 | Claude 语言漂移说明 |
| 想快速查一个问题的答案 | 开发者常见问题 |
五、进阶用法
以下能力已支持，专项文档即将上线：
- 提示词缓存（Prompt Caching）（已支持，文档完善中）
- 工具调用（Tool Calls / Function Calling）（已支持，文档完善中）
- 多模态（图片输入）（已支持，文档完善中）
- 结构化输出（Structured Output，部分模型支持）（已支持，文档完善中）
联系我们
- 电子邮箱：support_cloudrouter@clouditera.com
- QQ 社群：712273971
- 平台网址：cloudrouter.online