APIrove

首页 / API 文档

APIrove · DEVELOPER DOCUMENTATION

API 接入文档

使用一个 APIrove API Key,从你的应用调用账户已开通的模型。先核对模型权限与计价,再按该模型支持的接口选择请求格式。

适用对象:AI 应用开发者、产品团队与 API 集成工程师;请先注册或登录,并确认模型权限与可用余额。

学员快速上手

第一次使用 API?按步骤登录、确认模型、创建 API Key,并完成第一次调用。

打开学员 API 快速上手指南

两种 Key

新 Key 默认文本组,可调用 GPT 文本模型,也可以出图(Codex 默认 Image 2.6)。要 Claude 请在密钥管理选择完整组。老 Key 不用换。分组对照见小白版和专业版。

客户端接通:小白版 / 专业版

双入口:新客默认文本组(APIrove-Text,适合 CCSwitch/Codex,也可以出图);要 Claude 选完整组(APIrove-Unified)。老 Key 不用换。

小白版:复制一段话 → 发给 Codex / 对话 → 跟着点。短句、少术语,带一键复制。

打开小白版(推荐先看)

专业版:完整对接说明、文本组/完整组对照、全局提示词、聊天/出图规则与核对清单。

打开专业版

从现有中转站迁移

已有 OpenAI 兼容应用?先固定模型、端点与账单基线,再配置独立客户端、小流量验证并保留回滚。查看中转站迁移清单。

Base URL

将客户端的 API 地址设置为:

https://apirove.com/v1

请求中的模型 ID 必须与你账户中显示的名称一致。不要把模型 ID 当作权限凭据;调用前请登录控制台确认模型可用。

首页只保留 Base URL。完整请求示例留在OpenAI 兼容 API和本页下方;两种 Key 见两种 Key;缓存价、图片尺寸价和低余额说明见价格页。

使用 API Key 认证

对使用 Bearer Token 的 OpenAI 兼容接口,在 HTTP 请求头中传入 API Key:

Authorization: Bearer YOUR_API_KEY

创建和撤销密钥:打开 API Key 管理。将密钥保存在服务端环境变量或密钥管理器中,不要提交到代码仓库、浏览器脚本或公开日志。

请求接口

当前可核验的调用包括 OpenAI Responses API、Chat Completions,以及 Images Generations(文生图)。不同模型可能仅支持其中一种接口;请以模型详情和该模型的文档为准。

图片生成示例

已开通 Image 模型时,可用同一 API Key 调用:

curl https://apirove.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "a simple red circle on white background",
    "size": "1024x1024",
    "n": 1
  }'

更多模型 ID 见 Image 模型目录。编辑图 / 去背景等能力以账户开通为准。

模型列表与价格

公开美元零售单价见模型目录和价格说明(文本按每 100 万 token,图片按张)。登录控制台查看余额、权限和用量。这些单价是 APIrove 公布的零售价,不是模型厂商官网标价。

查看模型列表 · 阅读价格与计费说明 · 登录控制台查看账户价格

错误处理

  • 401:检查 API Key 是否缺失、拼写错误或已撤销。
  • 403:检查模型权限、账户状态或所用接口是否适用于该模型。
  • 429:根据响应提示降低请求速率,检查账户限额后再重试。
  • 5xx:记录响应中的 request ID(如有),检查服务状态;避免对非幂等请求盲目重复提交。
模型可用性、支持的参数、流式行为与计费方式可能不同。上线前请用少量请求验证模型和接口组合,并在控制台核对用量记录。

更多接入指南