API利用方法

API利用方法

AI基盤APIの基本的な呼び出し方です。

前提

有効なAPIキーがあること（APIキー管理）。

基本

1. ベースURLは管理画面の「APIエンドポイント」に表示される値を使用します
2. 認証ヘッダーにAPIキーを付与します（例: Authorization: Bearer <API_KEY>）
3. Content-Type: application/jsonでリクエストボディを送ります
4. モデル名・入力・パラメータはAPIリファレンスに従います

例（概念）

POST /v1/chat/completions HTTP/1.1
Host: <api-host>
Authorization: Bearer <API_KEY>
Content-Type: application/json

{"model":"<model-id>","messages":[{"role":"user","content":"ping"}]}

実際のパス・フィールド名は、管理画面に掲載のOpenAPI/リファレンスを正とします。

制約

• レート制限を超えると429が返ります。指数バックオフで再試行してください
• タイムアウトや一時障害時は冪等なリトライ設計を推奨します
• エラー時はエラー時の確認方法を参照してください