建立聊天完成

根據對話記錄建立模型回應。支援串流與非串流回應。相容於 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"
}

#建立聊天完成

#請求主體

#請求欄位

#請求範例

#回應

#成功回應欄位

#回應範例

#相關指南