适用对象: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。不同模型可能仅支持其中一种接口;请以模型详情和该模型的文档为准。
Responses API
POST /v1/responses · 适用于账户中支持 Responses 格式的模型。
Chat Completions
POST /v1/chat/completions · 适用于账户中支持 Chat Completions 格式的模型。
模型列表与价格
模型目录、价格与使用额度可能依账户分组而异。公开页面只列出当前确认的模型 ID,不以模型提供方的公开参考价替代 API Rove 的实际价格。
错误处理
- 401:检查 API Key 是否缺失、拼写错误或已撤销。
- 403:检查模型权限、账户状态或所用接口是否适用于该模型。
- 429:根据响应提示降低请求速率,检查账户限额后再重试。
- 5xx:记录响应中的 request ID(如有),检查服务状态;避免对非幂等请求盲目重复提交。
模型可用性、支持的参数、流式行为与计费方式可能不同。上线前请用少量请求验证模型和接口组合,并在控制台核对用量记录。