首页 / API 文档

API ROVE · DEVELOPER DOCUMENTATION

API 接入文档

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

适用对象:AI 应用开发者、产品团队与 API 集成工程师

Base URL

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

https://apirove.com/v1

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

使用 API Key 认证

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

Authorization: Bearer YOUR_API_KEY

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

请求接口

当前可核验的文本调用示例包括 OpenAI Responses API 与 Chat Completions。不同模型可能仅支持其中一种接口;请以模型详情和该模型的文档为准。

模型列表与价格

模型目录、价格与使用额度可能依账户分组而异。公开页面只列出当前确认的模型 ID,不以模型提供方的公开参考价替代 API Rove 的实际价格。

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

错误处理

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

更多接入指南