> ## 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/ja/models-and-providers.md)を確認してください。

## 最小のリクエストを送る

[認証ガイド](https://docs.rockapi.ai/ja/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/ja/errors-and-rate-limits.md)を確認してください。

## 割引を仮定せず精算内容を照合する

モデル詳細から、通貨、価格単位、課金方式、入出力区分、キャッシュやコンテキストの段階料金を記録します。表示された実効料金にグループ倍率が含まれていない場合だけ倍率を適用します。Rock API は全モデル・全リクエスト共通の割引を保証していません。

チャージの支払額と付与残高は、API 消費料金とは別です。一時的な予約額と最終精算額も異なる場合があります。[料金と請求](https://docs.rockapi.ai/ja/pricing-and-billing.md)に従い、完了したリクエストに保存された単価、使用量区分、グループで照合してください。現在のカタログを過去の精算記録の代わりにはできません。

## 遅延と有用な出力を測定する

Mercury 3 と既存モデルで、代表的なプロンプト、出力要件、同時実行数、クライアントの地域をそろえます。必要に応じてキャッシュ未使用時と使用時を分け、失敗や再試行も集計に含めます。

ストリーミングでは、最初の有効な内容までの時間と、出力完了までの時間を別々に測ります。毎秒トークン数は定義した生成区間の指標で、すべての通信、待ち行列、プロンプト処理、ツール実行時間を含みません。エージェントはタスク全体を測り、ツールエラーと反復ステップも数えます。

中央値、p95、タスク成功率、合格した結果あたりの精算コストを比較します。事実、出力形式、言語品質、ツール引数も検証してください。事前の合格基準を満たした場合に流量を段階的に増やし、旧経路への切り戻しをテストしておきます。

## 評価を始める

[Rock API アカウントを作成](https://rockapi.ai/sign-up?utm_source=docs\&utm_medium=referral\&utm_campaign=mercury_3_api_ja)し、モデル詳細を確認してから[クイックスタート](https://docs.rockapi.ai/ja/quickstart.md)で小規模な評価を準備します。移行の判断前に、予算と品質基準を決めてください。


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