建立回應

OpenAI Responses API，用於建立模型回應。支援多輪對話、工具呼叫、推理等功能。

POST /v1/responses

服務根位址: https://getrouter.ai

通訊協定: OpenAI Responses

驗證: Authorization: Bearer YOUR_API_KEY

請求主體

請求主體為必填。媒體類型: application/json

請求欄位

欄位	型別	必填	說明
`model`	`string`	是	—
`input`	`string or array<object>`	否	輸入內容，可以是字串或訊息陣列
`instructions`	`string`	否	—
`max_output_tokens`	`integer`	否	—
`temperature`	`number`	否	—
`top_p`	`number`	否	—
`stream`	`boolean`	否	—
`tools`	`array<object>`	否	—
`tool_choice`	`string or object`	否	—
`reasoning`	`object`	否	—
`previous_response_id`	`string`	否	—
`truncation`	`string`	否	可選值: `auto`, `disabled`

請求範例

curl --request POST \
  --url https://getrouter.ai/v1/responses \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "MODEL_ID",
  "stream": false,
  "temperature": 1,
  "max_output_tokens": 1
}'

回應

狀態碼	說明
`200`	已成功建立回應

成功回應欄位

欄位	型別	必填	說明
`id`	`string`	否	—
`object`	`string`	否	—
`created_at`	`integer`	否	—
`status`	`string`	否	可選值: `completed`, `failed`, `in_progress`, `incomplete`
`model`	`string`	否	—
`output`	`array<object>`	否	—
`usage`	`object`	否	—

回應範例

{
  "id": "string",
  "object": "object",
  "created_at": 1,
  "status": "completed",
  "model": "MODEL_ID",
  "output": [
    {
      "type": "string",
      "id": "string",
      "status": "completed",
      "role": "user",
      "content": [
        {
          "type": "string",
          "text": "string"
        }
      ]
    }
  ],
  "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
    }
  }
}

#建立回應

#請求主體

#請求欄位

#請求範例

#回應

#成功回應欄位

#回應範例

#相關指南