AI API 网关：模型接入、计费与首次请求 - Rock API Docs

AI API 网关位于应用与模型供应商之间，负责验证请求、转发到已支持的模型，并通过约定的接口返回结果。统一入口可以减少重复配置，让支持范围内的模型调用集中到同一用量视图；不同模型的行为、参数和能力仍需分别验证。 OpenAPI 市场服务可能有独立的订阅、鉴权和端点规则，不能把所有市场服务当作聊天模型接口调用。

与直接接入供应商比较什么

只使用一家供应商、且依赖其原生功能的应用，可以考虑直接接入。需要评估多种模型、集中管理密钥和查看消费时，网关有助于减少重复工作，但上线前仍要确认实际服务范围。

决策项	直接接入	评估网关时要核对
客户端配置	遵循各供应商接口	支持的端点及 SDK 行为
模型能力	阅读供应商当前文档	所选模型通过网关实际开放的功能
费用	分别核对供应商账户	模型价格、实际分组与结算用量
运行维护	应用处理供应商错误	同时测试网关错误、超时和限流

Rock API 的 OpenAI 兼容模型 Base URL 为 https://rockapi.ai/v1。兼容性针对已支持的请求与模型；自动切换、完全相同的输出、供应商全部原生功能，都不能仅由“统一 URL”推导出来。

普通买家如何跑通首次调用

打开当前模型目录与价格，选择支持聊天的模型，复制完整模型 ID，并确认账户和所选分组有访问权限。
注册账户，确认余额要求，在API 密钥页面创建平台密钥，放入服务端环境变量 ROCK_API_KEY。
把复制的 ID 设置为 ROCK_API_MODEL。SDK 使用完整 Base URL https://rockapi.ai/v1，curl 则请求下方的完整端点。
先发送短文本，成功后再添加工具、图片或流式输出。

curl --fail-with-body https://rockapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $ROCK_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"model\":\"$ROCK_API_MODEL\",\"messages\":[{\"role\":\"user\",\"content\":\"请回复你好。\"}]}"

运行前须在本地设置两个环境变量。模型 ID 来自目录并受账户权限约束，示例不保证任何特定型号可用。买家只需选择可访问的模型并创建平台密钥，无须配置上游渠道。

核对返回内容与最终费用

检查 HTTP 状态、响应正文、模型及返回的用量，再到控制台找到对应记录，核对实际分组、用量类别和最终结算。计费说明区分按量、按次和动态计费；临时预扣可能不同于最终费用，不能把所有模型视为固定折扣。遇到 401 或 403，先检查密钥和权限；400 或 404 应检查模型、请求体和路径；429 应检查额度与速率限制。保留时间戳和可用的请求 ID，分享前删除密钥与私密内容，按错误与限流说明定位。最小请求通过后，按兼容迁移验收指南测试应用实际需要的功能。向新增服务链路发送私密数据前，先阅读安全与隐私说明并确认适用条款。