跳转到主要内容
OpenAI 兼容 API支持文档约定的 OpenAI 风格请求与响应,可让应用在已支持的操作上复用客户端。但修改 Base URL 只是迁移起点:模型 ID、参数、工具调用、流式事件和错误处理,都需要单独验收,不能据此承诺零改动上线。

准备账户与请求参数

在当前模型目录选择支持聊天的模型,复制完整 ID,并确认账户和分组可用。在API 密钥页面创建 Rock API 平台密钥,不能直接用原供应商密钥替代。测试前阅读计费说明,确认余额要求。 把密钥保存在服务端环境变量 ROCK_API_KEY,把所选 ID 设置为 ROCK_API_MODEL。下面的示例要求本地有 curl,或在对应语言环境中已安装 openai 包。它们演示 Chat Completions,不代表所有 SDK 方法或供应商原生接口都已支持。普通买家无需配置上游渠道。

先建立最小调用基线

SDK 的完整 Base URL 为 https://rockapi.ai/v1。不要再追加一个 /v1,也不要把 /chat/completions 填进 SDK 的基础地址。curl 使用完整端点:

Python 示例

Node.js 示例

逐项验收应用使用的功能

先不带可选参数,再逐个加入真实业务所需功能。记录 SDK 版本、模型 ID、输入和预期结果,方便失败时复现。 文本调用成功并不能证明图片或工具调用成功。同一端点下的不同模型,仍可能有不同功能和输出行为,可参考按任务评估模型。

保留回滚路径再逐步放量

在测试环境回放经过脱敏的真实请求,比较质量、延迟、错误和每个合格结果的费用。检查重试上限,避免重复执行或无控制地消费;鉴权失败不应无限重试。按错误与限流说明排查,并保留不含密钥或私密提示词的时间戳和请求 ID。 验收通过后再逐步增加生产流量,保留原配置用于回滚。核账以最终用量记录为依据,临时扣减和 HTTP 错误均不能单独证明最终收费结果。