API 快速入门指南 - overrouter.ai Docs

可用模型与在线体验

在模型市场页面浏览我们完整的 AI 模型目录。每个模型都配有在线试用功能，您可以在编写代码前体验提示词和参数的效果。

100+ 模型，涵盖视频、图像、音乐和大语言模型类别
免费沙盒环境用于测试，无需信用卡
在线预览模型输出效果

定价方式

我们采用灵活的积分计费系统。每次请求根据所用模型和参数消耗相应积分。我们的定价通常比直接调用模型提供商低 30%-50%。请访问定价页面查看每个模型的积分消耗详情。

创建和保护您的 API 密钥

API base url

https://overrouter.ai

在此处创建和管理您的 API 密钥：
👉 https://overrouter.ai/market/api-keys

重要的安全提示：

切勿在前端代码中暴露您的 API 密钥（浏览器、移动应用、公共仓库）。将您的 API 密钥视为机密。为了帮助保护您的使用，我们提供：每个密钥的速率限制（每小时、每日和总使用量上限）；IP 白名单支持，仅允许已批准的服务器 IP 访问 API。这些功能有助于防止意外过度使用和未经授权的请求。

必需的请求头

所有 API 请求必须包含以下请求头，用于身份验证和内容协商。

HTTP Headers

Content-Type: application/json
Authorization: 参考市场快速开始Authorization的生成方式
API-KEY: 密钥对ak-开头的api-key

异步任务模型

大多数生成任务（视频、图像、音乐）采用异步处理。提交请求后，您会立即收到一个 task_id。使用此 ID 轮询状态，或配置 Webhook 回调，在任务完成时接收通知。

状态验证

在尝试访问结果 URL 之前，请务必验证任务状态。任务可能仍在处理中或已失败。使用「获取任务详情」接口进行检查。

JSON Response Example

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "abc123-def456-ghi789",
    "status": "processing",
    "progress": 45,
    "result_url": null,
    "created_at": "2025-01-01T00:00:00Z"
  }
}

速率限制与并发

默认速率限制为每分钟 60 次请求和 5 个并发任务。企业账户可申请更高限额。超出速率限制时，API 返回 429 状态码。请在重试逻辑中实现指数退避策略。

开发者支持

加入我们的 Discord 或 Telegram 社区获取实时开发者支持。如需企业咨询，请通过控制面板直接联系我们的销售团队。