适用对象:AI 应用开发者、产品团队与 API 集成工程师;请先注册或登录,并确认模型权限与可用余额。
学员快速上手
第一次使用 API?按步骤登录、确认模型、创建 API Key,并完成第一次调用。
两种 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(文生图)。不同模型可能仅支持其中一种接口;请以模型详情和该模型的文档为准。
Responses API
POST /v1/responses · 适用于账户中支持 Responses 格式的模型。
Chat Completions
POST /v1/chat/completions · 适用于账户中支持 Chat Completions 格式的模型。
Images Generations
POST /v1/images/generations · 文生图;模型如 gpt-image-2 / gpt-image-2.5-flare / gpt-image-2.5-sunburst / gpt-image-2.6-flare / gpt-image-2.6-sunburst。
图片生成示例
已开通 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(如有),检查服务状态;避免对非幂等请求盲目重复提交。