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

# AI API ゲートウェイ：モデル接続、料金確認、最初のリクエスト

> AI API ゲートウェイと直接接続の違いを理解し、プラットフォームのキー、完全なベース URL、利用ログでモデル接続を確認します。

**AI API ゲートウェイ**は、アプリケーションとモデル提供元の間で、認証、対応モデルへの転送、規定の形式での応答を担います。接続設定の重複を減らし、対応範囲内の利用状況を一つの画面で確認しやすくします。ただし、異なるモデルの機能や出力が同じになるわけではありません。

OpenAPI サービスには独自の契約、認証、エンドポイントがある場合があります。すべてのサービスをモデルのチャット API と同じ方法で呼び出せるとは限りません。

## 提供元への直接接続と比較する

一社のネイティブ機能に依存するアプリでは直接接続が適する場合があります。複数のモデルを評価したり、キー管理や利用確認をまとめたりする場合は、ゲートウェイが選択肢になります。移行前に実際の対応範囲を確認してください。

| 判断項目 | 直接接続 | ゲートウェイで確認すること |
| - | - | - |
| クライアント | 各提供元の API に従う | 対応エンドポイントと SDK の動作 |
| モデル機能 | 提供元の最新仕様を確認 | 対象モデルで公開されている機能 |
| 費用 | 提供元ごとに照合 | 単価、適用グループ、確定した利用料金 |
| 運用 | 提供元のエラーを処理 | ゲートウェイのエラー、時間切れ、制限も検証 |

Rock API の OpenAI 互換モデル用ベース URL は `https://rockapi.ai/v1` です。互換性は対応するリクエストとモデルに適用されます。自動切り替え、同一の応答、すべてのネイティブ機能は、URL が一つというだけでは保証されません。

## 購入者として最初の呼び出しを行う

1. [現在のモデル一覧と料金](https://rockapi.ai/pricing)でチャット対応モデルを選び、正確な ID をコピーします。アカウントと選択グループの利用権限も確認します。
2. [アカウントを作成](https://rockapi.ai/sign-up?utm_source=docs\&utm_medium=referral\&utm_campaign=docs_launch)し、必要な残高を確認して、[API キー画面](https://rockapi.ai/keys)でプラットフォームのキーを発行します。サーバー側の `ROCK_API_KEY` に保存してください。
3. コピーした ID を `ROCK_API_MODEL` に設定します。SDK には完全なベース URL `https://rockapi.ai/v1` を指定し、curl には以下の完全なエンドポイントを使います。
4. ツール、画像、ストリーミングを追加する前に短いテキストで確認します。

```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\":\"こんにちは、と返答してください。\"}]}"
```

実行前にローカルで二つの環境変数を設定してください。モデル ID は一覧とアカウント権限に依存し、この例は特定モデルの利用可能性を保証しません。購入者は利用可能なモデルとプラットフォームのキーを用意すればよく、上流チャネルの設定は不要です。

## 応答と確定料金を確認する

HTTP ステータス、本文、モデル、返された使用量を確認し、管理画面の該当ログと照合します。実際のグループ、使用量の区分、確定料金が確認点です。[料金と請求](https://docs.rockapi.ai/ja/pricing-and-billing.md)は従量、呼び出し単位、動的料金を説明しています。一時的な予約額と確定額は異なる場合があり、全モデルに共通の固定割引はありません。

`401`・`403` はキーと権限、`400`・`404` はモデル、本文、パスを調べます。`429` では再試行前にクォータとレート制限を確認してください。秘密情報を除いて日時と取得できたリクエスト ID を残し、[エラーと制限](https://docs.rockapi.ai/ja/errors-and-rate-limits.md)に沿って調査します。

最小リクエストが通ったら、[互換 API の移行検証](https://docs.rockapi.ai/ja/blog/buyers/openai-compatible-api.md)で実際のアプリ機能を確認します。機密データを新たな中継先へ送る前に、[セキュリティとプライバシー](https://docs.rockapi.ai/ja/security-and-privacy.md)と適用条件を確認してください。


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