首页 / API 文档 / 学员快速上手

STUDENT QUICKSTART

学员 API 快速上手

跟着下面 4 步,完成第一次模型调用。你需要一个已开通的 API Rove 账户和可用额度。

学员指南 · 约 2 分钟

1. 登录并确认模型

打开 API Rove 控制台。在模型列表中找到你要使用的模型,并在账户中确认模型权限、价格和可用额度。下面示例使用 GPT 的 Responses API;请把模型占位符替换成控制台显示且你有权限使用的模型 ID。

2. 创建专用 API Key

进入 API Key 管理,为本次课程或项目单独创建一个 Key。复制后妥善保存;不要发到群聊、截图、公开代码仓库,也不要放进网页前端。

3. 配置并发送第一次请求

在你自己的终端运行下面命令。将两处占位符换成自己的 API Key 和模型 ID:

export APIROVE_API_KEY='粘贴你自己的 API Key'
export APIROVE_MODEL='替换为控制台显示的模型 ID'

curl https://apirove.com/v1/responses \
  -H "Authorization: Bearer $APIROVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"'"$APIROVE_MODEL"'","input":"用一句话介绍你自己。","max_output_tokens":80}'

API 地址是 https://apirove.com/v1。此示例通过 Responses API 发送文本请求;其他模型或客户端可能需要不同接口和参数,请按模型说明选择。

4. 确认调用成功

如果请求成功,终端会返回模型响应。随后打开控制台的用量页面,确认请求记录和实际消耗。价格以账户显示为准。

常见问题

  • 401:检查 API Key 是否完整、有效,并以 Bearer 格式传入。
  • 403:检查账户状态、额度和模型权限,确认模型支持 Responses API。
  • 429:降低请求频率,并查看账户额度或并发限制。
  • 5xx:稍后再试;重试前先检查用量记录,避免重复请求。
如果模型不在账户列表中、没有可用额度或仍无法调用,请联系课程老师或查看完整 API 文档。如果 API Key 意外泄漏,立即在 API Key 管理页撤销并重新创建。

下一步:阅读OpenAI 兼容 API 接入教程和API Key 安全指南。