API リファレンス

Chat Completions

POST/v1/chat/completions

主力のエンドポイント:モデル一覧にあるすべてのチャット対応モデルで、マルチターンチャット、ストリーミング、ツール呼び出し、画像認識、JSON モードを利用できます。

#リクエストパラメーター

  • modelstring必須

    /v1/models から取得したモデル ID。ゲートウェイはこの値から上流ベンダーを判定します。

  • messagesarray必須

    会話のターン:{role: system|user|assistant|tool, content}。content は文字列またはマルチモーダルのパーツ配列です。

  • streamboolean任意

    true の場合、SSE の差分をストリーミングし、data: [DONE] で終了します。

  • temperaturenumber任意

    0〜2。空欄にするとモデルのデフォルトを使用します。

  • max_tokensinteger任意

    生成トークン数の上限。事前確保する利用枠の見積もりの上限にもなります。

  • toolsarray任意

    モデルが呼び出せる関数の宣言 — ツール呼び出しガイドを参照してください。

  • tool_choicestring | object任意

    "auto"、"none"、または特定の関数を指定します。

  • response_formatobject任意

    {"type":"json_object"}、または対応モデルで構造化出力を行う json_schema ラッパー。

  • top_pnumber任意

    核サンプリング。temperature と top_p はどちらか一方を使います。

  • stopstring | array任意

    生成を打ち切る停止シーケンス(最大 4 個)。

#関連するエラー

  • 400 invalid_request_errorボディの形式が不正か、このモデルが対応していないパラメーターがあります。
  • 401Bearer トークンが無効か、ありません。このパスでは error.code が付きません — ステータスで判定してください。
  • 402 insufficient_user_quotaウォレット残高が事前確保の見積額に足りません。
  • 429キー単位のレート制限です。ボディは空なので、Retry-After の時間だけ待ってください。insufficient_user_quota が付いた 429 は、レート制限ではなく 1 日の利用上限額によるものです。
  • 503 model_not_found不明なモデルか、現在そのモデルを提供できる正常なチャネルがありません。

エラーコード一覧 →

#リクエスト例

curl https://www.aisplice.store/v1/chat/completions \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-luna",
    "messages": [{"role": "user", "content": "Say hello."}]
  }'

#レスポンス

response.json
{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "model": "gpt-5.6-luna",
  "choices": [{
    "index": 0,
    "message": {"role": "assistant", "content": "Hello!"},
    "finish_reason": "stop"
  }],
  "usage": {"prompt_tokens": 9, "completion_tokens": 3, "total_tokens": 12}
}

まだ解決しませんか?

リクエスト ID かエラーメッセージを送っていただければ、こちらで調査します。