快速开始第一次调用
API 基础概念
了解 API、Base URL、API Key、模型 ID 与不同协议的关系
Routescope API 是统一的 AI 网关与资产管理平台。你可以用一个业务令牌调用已开通的模型，并在控制台中管理余额、模型权限、请求日志和异步任务。
核心概念
| 名称 | 含义 |
|---|---|
| API | 程序通过 HTTP 请求调用 Routescope 的方式。不同能力会使用不同路径，例如聊天使用 /v1/chat/completions，图像生成使用 /v1/images/generations。 |
| Base URL | 请求地址的公共前缀。官方示例中的 OpenAI 兼容 Base URL 是 https://api.routescope.ai/v1；自部署时替换为你的域名。 |
| API Key | 在令牌管理中创建的业务凭证，通常是完整的 sk-...。 |
| Authorization Header | 调用接口时携带的鉴权请求头：Authorization: Bearer sk-your-token。 |
| Model ID | 模型标识。建议从模型广场或模型列表接口复制，不要手填。 |
协议不要混用
| 协议/接口风格 | 典型路径 | 请求结构 |
|---|---|---|
| OpenAI Chat Completions | /v1/chat/completions | model + messages |
| Claude Messages | /v1/messages | model + messages + max_tokens，可带 system |
| Gemini Generate Content | /v1beta/models/{model}:generateContent | contents[].parts[] |
| Imagen Predict | /v1beta/models/{model}:predict | instances + parameters |
| OpenAI 风格图像 | /v1/images/generations、/v1/images/edits | JSON 或表单字段以接口说明为准 |
如果接口文档没有明确说明某个模型的额外限制，以接口返回或页面实际展示为准。
最后更新于