开发者指南总览
适用角色：开发者 更新日期：2026-07-14
平台提供与 OpenAI / Anthropic / Gemini 生态完全兼容的 API。如果你的代码已经在用 OpenAI 或 Claude 的 SDK，通常只需改两行配置（Base URL + API Key）就能切到平台，一套接入即可调用全球主流模型。
一、接入只需三步
① 拿到 API Key → 由主用户或子用户在控制台「API 密钥」页创建
② 配置 Base URL → 把请求指向 平台
③ 发起请求 → 用熟悉的 OpenAI/Anthropic 格式调用详细操作见 快速开始：5 分钟首次调用。
二、核心概念
理解下面几个概念，就理解了整个调用链：
| 概念 | 是什么 | 类比 |
|---|---|---|
| API Key | 你的身份凭证，sk- 开头 |
门禁卡 |
| Base URL | 平台的 API 地址 | 服务器门牌号 |
| 模型调用名 | 请求里 model 字段填的值 |
点哪道菜 |
| 分组（group） | 同名模型的标签维度，用于消歧和路由 | 你的菜单分区 |
关于模型调用名，v2 提供两种写法：
- 模型名称，如
claude-sonnet-4-6、gpt-4o：按优先级解析路由（Key 绑定分组 → 默认路由配置），与老版行为兼容。 - 带分组标识，如
5MHXZWKA/gpt-4o：按分组标识"点名"路由到指定分组（需开启分组标识路由）。
模型名称可在控制台「调用指南」、模型广场或 /v1/models API 获取；开启分组标识路由后，调用指南页还会展示带分组标识的调用名。详细说明与场景选择见 调用指南与路由说明。
你能调用哪些分组 / 模型，取决于你账户的可用模型范围（由平台按主用户配置）。调不到某个模型时，先确认可用范围，见 管理员手册 · 地区与模型范围。
三、协议格式
平台兼容多种主流协议，你可以按习惯任选：
| 协议 | 端点 | 适合 | 示例文档 |
|---|---|---|---|
| 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，部分模型支持）（已支持，文档完善中）