> ## 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 マーケットプレイス購入ガイド：比較・契約・事前テスト

> API の掲載情報、OpenAPI 仕様、契約条件、認証、応答と利用料金を確認し、本番導入に適したサービスを選びます。

**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 サービスには、有効な契約と独自の URL、認証、クォータ、更新条件がある場合があります。すべてのサービスが Chat Completions を受け付けたり、モデルトークン料金を使ったりするとは限りません。

| 契約前の確認 | 保存しておく根拠 |
| - | - |
| 機能の適合 | 必要なエンドポイント、入力、出力例と制約 |
| 認証 | キーの発行元、ヘッダー、契約と権限の要件 |
| 費用 | 通貨、単位、含まれる使用量、超過料金、更新と解約 |
| 運用 | レート制限、時間切れ、エラーと問い合わせ先 |
| データ | 保持、処理、許可用途に関する適用条件 |

重要な情報が不足していたら、支払う前にサポートへ問い合わせます。単位やプラン条件のない価格だけでは、月額費用を見積もれません。

## 仕様から小さな検証を設計する

OpenAPI 文書は HTTP メソッド、パス、パラメーター、本文、認証方式、応答構造を記述します。対象操作の必須項目を読み、応答例とアプリが依存するフィールドを比較してください。必要に応じてページ分割、省略可能なフィールド、空の結果、非同期タスクの状態も確認します。

合成データを使い、影響の少ないリクエストを選びます。読み取り専用の操作があれば優先し、書き込み操作では実行前に変更内容を理解してください。契約前に少額の評価予算と合格基準を決めます。試用の有無も確認し、テストが無料だとは仮定しないでください。

## 正しい認証経路で試す

マーケットのサービスではプランを確認し、必要なら契約してからオンラインコンソールを使います。コンソールがなければ、サービスの文書にあるリクエスト例を使います。必要な資格情報を作り、完全な URL とメソッドを確認して最小の有効な呼び出しを行います。[OpenAPI の契約とオンラインテスト](https://docs.rockapi.ai/ja/blog/buyers/how-to-subscribe-and-test-openapi.md)も参照してください。

チャットモデルの評価では、[API キー画面](https://rockapi.ai/keys)でプラットフォームのキーを作成し、`ROCK_API_KEY` に保存します。アカウントで利用できる正確なモデル ID を `ROCK_API_MODEL` に設定します。SDK の完全なベース 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/ja/pricing-and-billing.md)はモデルの消費とサービスプランを区別しています。HTTP エラーだけで課金の有無は判断できません。

検証済みのメソッド、URL、ヘッダー、本文をコードへ移し、テストと本番のキーを分けます。時間制限と再試行上限を設定し、流量を増やす前に[API 契約チェックリスト](https://docs.rockapi.ai/ja/blog/buyers/api-subscription-checklist.md)を確認してください。


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