チャット補完を作成

会話履歴に基づいてモデルのレスポンスを作成します。ストリーミングと非ストリーミングのレスポンスに対応しています。 OpenAI Chat Completions API と互換性があります。

POST /v1/chat/completions

サービスルート: https://getrouter.ai

プロトコル: OpenAI Chat Completions

認証: Authorization: Bearer YOUR_API_KEY

リクエストボディ

リクエストボディは必須です。メディアタイプ: application/json

リクエストフィールド

フィールド	型	必須	説明
`model`	`string`	はい	モデル ID
`messages`	`array<object>`	はい	会話メッセージ一覧
`temperature`	`number`	いいえ	サンプリング温度デフォルト: `1`; 範囲: 0–2
`top_p`	`number`	いいえ	核サンプリングパラメータデフォルト: `1`; 範囲: 0–1
`n`	`integer`	いいえ	生成数デフォルト: `1`; 範囲: 1–∞
`stream`	`boolean`	いいえ	ストリーミングレスポンスを使用するかどうかデフォルト: `false`
`stream_options`	`object`	いいえ	—
`stop`	`string or array<string>`	いいえ	停止シーケンス
`max_tokens`	`integer`	いいえ	生成する Token の最大数
`max_completion_tokens`	`integer`	いいえ	補完 Token の最大数
`presence_penalty`	`number`	いいえ	デフォルト: `0`; 範囲: -2–2
`frequency_penalty`	`number`	いいえ	デフォルト: `0`; 範囲: -2–2
`logit_bias`	`object`	いいえ	—
`user`	`string`	いいえ	—
`tools`	`array<object>`	いいえ	—
`tool_choice`	`string or object`	いいえ	—
`response_format`	`object`	いいえ	—
`seed`	`integer`	いいえ	—
`reasoning_effort`	`string`	いいえ	推論強度（推論対応モデル用）選択肢: `low`, `medium`, `high`
`modalities`	`array<string>`	いいえ	—
`audio`	`object`	いいえ	—

リクエスト例

curl --request POST \
  --url https://getrouter.ai/v1/chat/completions \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "MODEL_ID",
  "messages": [
    {
      "role": "system",
      "content": "こんにちは。自己紹介してください。"
    }
  ],
  "stream": false,
  "temperature": 1,
  "max_tokens": 1
}'

レスポンス

ステータス	説明
`200`	レスポンスを正常に作成
`400`	リクエストパラメータが不正です
`429`	リクエストのレート制限

成功レスポンスのフィールド

フィールド	型	必須	説明
`id`	`string`	いいえ	—
`object`	`string`	いいえ	—
`created`	`integer`	いいえ	—
`model`	`string`	いいえ	—
`choices`	`array<object>`	いいえ	—
`usage`	`object`	いいえ	—
`system_fingerprint`	`string`	いいえ	—

レスポンス例

{
  "id": "string",
  "object": "object",
  "created": 1,
  "model": "MODEL_ID",
  "choices": [
    {
      "index": 1,
      "message": {
        "role": "system",
        "content": "こんにちは。自己紹介してください。",
        "name": "string",
        "tool_calls": [
          {
            "id": null,
            "type": null,
            "function": null
          }
        ],
        "tool_call_id": "string",
        "reasoning_content": "string"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 1,
    "completion_tokens": 1,
    "total_tokens": 1,
    "prompt_tokens_details": {
      "cached_tokens": 1,
      "text_tokens": 1,
      "audio_tokens": 1,
      "image_tokens": 1
    },
    "completion_tokens_details": {
      "text_tokens": 1,
      "audio_tokens": 1,
      "reasoning_tokens": 1
    }
  },
  "system_fingerprint": "string"
}

#チャット補完を作成

#リクエストボディ

#リクエストフィールド

#リクエスト例

#レスポンス

#成功レスポンスのフィールド

#レスポンス例

#関連ガイド