> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rockapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API 市场采购指南：比较、订阅与购买前测试

> 从 OpenAPI 文档、订阅条款、鉴权、响应验收和用量核账入手，评估 API 市场中的服务是否适合生产集成。

**API 市场**集中展示服务、文档与购买流程，但具体 API 是否满足需求，仍需买家验证。出现在市场中或提供 OpenAPI 规范，并不自动代表可用性、数据保护或应用兼容性已经达到你的要求。

![从发现与比较 API 到订阅、测试和应用集成的市场采购流程图](https://mintcdn.com/rockapi/Y2PJHTzmky-wG67e/images/blog/api-marketplace-workflow.svg?fit=max\&auto=format\&n=Y2PJHTzmky-wG67e\&q=85\&s=8360bb64cd8c977178f5216bdd46bfd4)

此图保留英文标注，用于说明采购步骤。是否有在线测试、是否必须先订阅，应以具体服务页面为准。

## 区分模型调用与服务订阅

购买 AI 模型调用时，先查看[当前模型目录与价格](https://rockapi.ai/pricing)，按模型端点和适用的用量规则调用。第三方 OpenAPI 服务则可能要求有效订阅，使用独立端点、鉴权、配额和续费条款。不能假设所有市场 API 都接受 Chat Completions 请求，或都按模型 token 价格收费。

| 订阅前检查 | 应保存的依据 |
| - | - |
| 功能适配 | 所需端点、输入、输出示例及限制 |
| 鉴权 | 凭证来源、请求头格式、订阅与权限要求 |
| 费用 | 币种、单位、包含用量、超额费、续费与取消条款 |
| 运行维护 | 速率限制、超时、文档错误码及支持渠道 |
| 数据处理 | 适用的留存、处理与允许用途条款 |

缺少关键说明时，应先向服务支持渠道核实再付款。仅有一个价格数字、没有单位和套餐条件，无法可靠估算月度账单。

## 用规范设计一个小测试

OpenAPI 文档描述 HTTP 方法、路径、参数、请求体、安全方案和响应结构。阅读目标端点的必填要求，将示例响应与应用依赖的字段逐项比较，并按需检查分页、可选字段、空结果和异步任务状态。

使用合成数据发起无害请求，有只读端点时优先选择。对于会修改数据的操作，发送前应理解其影响。订阅前设定小额评估预算和合格标准；确认服务是否真的提供试用，不能默认测试免费。

## 沿正确的授权路径测试

市场服务应先阅读套餐，按要求订阅，再使用可用的在线控制台；没有在线控制台时，使用该服务自己的请求示例。创建所需凭证，核对完整服务 URL 与方法，发送最小有效请求。详细流程可参考[订阅并在线测试 OpenAPI](https://docs.rockapi.ai/zh-cn/blog/buyers/how-to-subscribe-and-test-openapi.md)。

若评估的是聊天模型，在[API 密钥页面](https://rockapi.ai/keys)创建平台密钥，保存为 `ROCK_API_KEY`，将账户可访问的完整目录 ID 设置为 `ROCK_API_MODEL`。SDK 完整 Base URL 为 `https://rockapi.ai/v1`，curl 示例为：

```bash theme={null}
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\":\"请回复你好。\"}]}"
```

先设置两个环境变量并确认余额要求。普通买家无须配置上游渠道。此示例仅用于模型聊天，不能作为所有市场服务的通用端点。

## 验收响应，再核对购买与消费

检查状态码及正文，不要只看控制台是否显示成功。尝试文档说明的无效输入，确认应用能处理相应错误。`401` 或 `403` 应检查密钥、订阅与权限，`429` 应检查配额和速率限制。保留时间戳和请求或任务 ID，删除密钥等敏感信息。

找到对应使用记录，核对最终费用或订阅配额扣减。[计费说明](https://docs.rockapi.ai/zh-cn/pricing-and-billing.md)区分模型消费与市场套餐；HTTP 错误本身不能证明有没有收费。

将验证通过的方法、URL、请求头和正文移入代码，隔离测试与生产密钥，设置超时和有限重试。增加流量前，完成[API 订阅检查清单](https://docs.rockapi.ai/zh-cn/blog/buyers/api-subscription-checklist.md)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.