> ## 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.

# Mercury 3 API 接入指南：核对价格、模型权限与实测延迟

> 在 Rock API 评估 mercury-3：确认模型和分组权限，发送 Chat Completions 请求，核对结算，并用真实任务测量延迟与质量。

通过 Rock API 评估 Mercury 3 前，先在[实时模型目录](https://rockapi.ai/pricing)查找 `mercury-3`，确认当前账号及选用分组有权限，记录接口和请求限制，再用业务任务测试。文章中出现模型名，不代表所有分组随时都能调用。

本文提供接入与评估方法。厂商资料请从 [Inception 官网](https://www.inceptionlabs.ai/)查阅当前模型文档和公告。上下文上限、基准分数、发布日期和迁移截止日，应有明确且有效的一手来源才能作为生产计划依据。

## 编码前确认实际路由

| 检查项 | 需要记录的信息 |
| - | - |
| 模型 | 精确 ID `mercury-3`、分组权限，以及公开披露的模型版本。 |
| 接口 | 是否支持 Chat Completions，哪些参数必填或不受支持。 |
| 功能 | 业务需要的流式输出、工具调用、结构化输出和缓存行为。 |
| 限制 | 实际路由的输入上下文、最大输出、并发和速率限制。 |

OpenAI 兼容描述的是请求格式，不保证每个模型实现所有 OpenAI 接口及参数。迁移供应商专有配置前，先查[模型接入说明](https://docs.rockapi.ai/zh-cn/models-and-providers.md)。

## 发送最小请求

按[鉴权说明](https://docs.rockapi.ai/zh-cn/authentication.md)在环境中配置 `ROCKAPI_API_KEY`。确认上述模型和接口后再执行示例；执行会产生计费请求。

```bash theme={null}
curl --fail-with-body https://rockapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $ROCKAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mercury-3",
    "messages": [{"role": "user", "content": "列出 API 发布前的三项检查。"}]
  }'
```

OpenAI Python 客户端可以表达相同的基础请求：

```python theme={null}
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ROCKAPI_API_KEY"],
    base_url="https://rockapi.ai/v1",
)
response = client.chat.completions.create(
    model="mercury-3",
    messages=[{"role": "user", "content": "列出 API 发布前的三项检查。"}],
)
print(response.choices[0].message.content)
print(response.usage)
```

保留请求时间、模型、分组和可取得的请求 ID。失败后先查[错误与限流](https://docs.rockapi.ai/zh-cn/errors-and-rate-limits.md)，避免无边界重试。

## 按结算规则核价

打开模型详情，记录币种、价格单位、计费方式、输入输出类别，以及缓存或上下文阶梯规则。只有展示价格尚未包含分组倍率时，才应用实际倍率，避免重复计算。Rock API 不承诺所有模型或请求统一优惠。

充值支付决定到账余额，与调用消耗的定价分开。临时预扣也可能不同于最终结算。按照[价格与计费](https://docs.rockapi.ai/zh-cn/pricing-and-billing.md)，用已完成请求保存的单价、用量类别和分组对账，不能拿今天目录里的价格替代历史结算。

## 测量延迟与有效结果

为 Mercury 3 和现用模型准备相同的代表性提示、输出要求、并发和客户端地域。涉及缓存时区分冷缓存与热缓存，失败和重试也要保留。

流式接口分别测量首段有效内容耗时与完整输出耗时。每秒 token 数只对应明确定义的生成区间，不涵盖所有网络、排队、提示词处理和工具调用延迟。智能体应测完整任务，同时统计工具错误和重复步骤。

对比完整响应的中位数、p95、任务成功率和每个合格结果的结算成本。检查事实正确性、输出结构、语言质量和工具参数。只有满足预先设定的验收条件，才逐步增加流量，并保留已测试的回退路径。

## 开始评估

[注册 Rock API 账号](https://rockapi.ai/sign-up?utm_source=docs\&utm_medium=referral\&utm_campaign=mercury_3_api_zh)，核对模型详情，再按[快速开始](https://docs.rockapi.ai/zh-cn/quickstart.md)准备小规模评估。先定预算和质量门槛，再决定是否迁移。


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