快速开始

使用 API 密钥与模型将你的首个应用程序连接到网关。

创建 API 密钥

在控制台打开【API 密钥】页面，创建具有足够额度且拥有目标模型权限的密钥。将后续示例中的 YOUR_API_KEY 替换为你实际的密钥。

可用模型

模型列表反映的是当前密钥和分组的访问权限，并不代表兼容所有接口类型。在调用具体模型 ID 前，请查阅其 supported_endpoint_types 和官方模型文档。部分模型可能仅支持 Responses、图像或其他特定接口。

curl 'https://routerra.ai/v1/models' \
  -H 'Authorization: Bearer YOUR_API_KEY'

发送请求

向对话补全端点发送请求。将 YOUR_MODEL_ID 替换为你密钥支持的实际模型名称。

curl 'https://routerra.ai/v1/chat/completions' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

常见问题排查

如遇鉴权错误，请检查密钥是否正确及是否过期；如遇额度不足，请核对账户余额与密钥额度上限；若模型不可用，请核对模型 ID 拼写与分组权限；若遇到频率限制，请携带退避重试机制再次请求。