开发者指南总览
适用角色：开发者 更新日期：2026-08-06
本平台提供 OpenAI Compatible、Messages Compatible 和 Gemini Native 兼容接口。已有兼容 SDK 的项目通常只需调整 Base URL、API Key 和模型调用名。
接入信息
| 配置项 | 值 |
|---|---|
| OpenAI Compatible Base URL | https://<接口地址> |
| Chat Completions | https://<接口地址>/v1/chat/completions |
| Messages Compatible Base URL | https://<接口地址> |
| Messages | https://<接口地址>/v1/messages |
| API Key | 控制台创建的 sk- 开头密钥 |
| 模型调用名 | 从控制台「调用指南」复制 |
第一次调用可以从 快速开始 开始。
调用链中的关键配置
| 配置 | 作用 |
|---|---|
| API Key | 识别用户，并应用分组、额度、速率和来源限制 |
| Base URL | 决定请求发送到哪个 API 服务 |
model |
指定模型，也可以包含分组标识 |
| Key 绑定分组 | 普通模型名优先使用的分组 |
| 默认模型配置 | 绑定分组没有目标模型时提供候选分组 |
普通调用名示例为 deepseek-v4-flash 或 kimi-k3。启用分组标识路由后，也可以使用控制台展示的完整调用名，例如 5MHXZWKA/deepseek-v4-flash。
模型能否调用，还取决于组织分组、子用户权限和账号状态。详细规则见 模型可用范围与分组授权 和 调用指南与路由说明。
选择协议
| 协议 | 端点 | 适合场景 |
|---|---|---|
| OpenAI Compatible | /v1/chat/completions |
大多数 SDK、聊天客户端和工作流工具 |
| Messages Compatible | /v1/messages |
使用 Messages 请求结构的 SDK 和 Agent 工具 |
| Gemini Native | /v1beta/models/{model}:generateContent 等 |
使用 Gemini SDK 或原生 Gemini API 格式的客户端 |
三种协议的请求字段和流式事件不同。接入时应按客户端实际支持的协议选择，不要在同一请求中混用字段。
文档导航
| 需求 | 文档 |
|---|---|
| 完成第一次 API 请求 | 快速开始 |
| 查看参数、认证和流式输出 | API 调用基础 |
| 使用 Python、JavaScript 等 SDK | SDK 接入 |
| 接入 Claude Code、Cursor 等工具 | 第三方工具接入 |
| 处理 401、403、404、429 和 5xx | 错误码与排障 |
| 理解模型调用名和路由 | 调用指南与路由说明 |
| 提高中文输出稳定性 | 模型中文输出稳定性说明 |
| 快速查询常见问题 | 开发者常见问题 |
工具调用、图片输入、提示词缓存和结构化输出是否可用，取决于具体模型和协议。上线前应使用目标模型做小范围验证，并为不支持的能力准备降级处理。