Tạo một phản hồi

OpenAI Responses API, dùng để tạo phản hồi của mô hình. Hỗ trợ hội thoại nhiều lượt, gọi công cụ, suy luận và các chức năng khác.

POST /v1/responses

URL gốc của dịch vụ: https://getrouter.ai

Giao thức: OpenAI Responses

Xác thực: Authorization: Bearer YOUR_API_KEY

Nội dung yêu cầu

Nội dung yêu cầu là bắt buộc. Loại nội dung: application/json

Trường yêu cầu

Trường	Kiểu	Bắt buộc	Mô tả
`model`	`string`	Có	—
`input`	`string or array<object>`	Không	Nội dung đầu vào, có thể là chuỗi hoặc mảng tin nhắn
`instructions`	`string`	Không	—
`max_output_tokens`	`integer`	Không	—
`temperature`	`number`	Không	—
`top_p`	`number`	Không	—
`stream`	`boolean`	Không	—
`tools`	`array<object>`	Không	—
`tool_choice`	`string or object`	Không	—
`reasoning`	`object`	Không	—
`previous_response_id`	`string`	Không	—
`truncation`	`string`	Không	Giá trị cho phép: `auto`, `disabled`

Ví dụ yêu cầu

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

Phản hồi

Trạng thái	Mô tả
`200`	Tạo phản hồi thành công

Các trường của phản hồi thành công

Trường	Kiểu	Bắt buộc	Mô tả
`id`	`string`	Không	—
`object`	`string`	Không	—
`created_at`	`integer`	Không	—
`status`	`string`	Không	Giá trị cho phép: `completed`, `failed`, `in_progress`, `incomplete`
`model`	`string`	Không	—
`output`	`array<object>`	Không	—
`usage`	`object`	Không	—

Ví dụ phản hồi

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

Hướng dẫn liên quan

Để xem quy trình và ví dụ đầy đủ, hãy đọc hướng dẫn API Responses.

Trang này được tạo từ đặc tả OpenAPI công khai của Relay. Xem đặc tả đầy đủ trong API Explorer.

#Tạo một phản hồi

#Nội dung yêu cầu

#Trường yêu cầu

#Ví dụ yêu cầu

#Phản hồi

#Các trường của phản hồi thành công

#Ví dụ phản hồi

#Hướng dẫn liên quan