创建响应

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
    }
  }
}

#创建响应

#请求体

#请求字段

#请求示例

#响应

#成功响应字段

#响应示例

#相关指南

创建响应

请求体

请求字段

请求示例

响应

成功响应字段

响应示例

相关指南