Responses

Giao diện Responses phù hợp với client, agent lập trình và framework ứng dụng thế hệ mới sử dụng giao thức OpenAI Responses. Giao diện này thường dùng trong các kịch bản cần cấu trúc đầu vào thống nhất, gọi công cụ, kiểm soát suy luận hoặc cấu trúc phản hồi phức tạp hơn.

Endpoint

POST /v1/responses

Địa chỉ đầy đủ:

https://www.routeapi.ai/v1/responses

Ví dụ yêu cầu

curl https://www.routeapi.ai/v1/responses \
  -H "Authorization: Bearer $ROUTEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "input": "Hãy mô tả mục đích chính của RouteAPI"
  }'

Tham số thường gặp

Trường	Kiểu	Bắt buộc	Mô tả
model	string	Có	ID mô hình
input	string/array	Có	Nội dung đầu vào
instructions	string	Không	Chỉ thị cấp hệ thống
stream	boolean	Không	Có xuất streaming hay không
tools	array	Không	Định nghĩa công cụ
tool_choice	string/object	Không	Chiến lược chọn công cụ
temperature	number	Không	Nhiệt độ lấy mẫu
max_output_tokens	number	Không	Số token đầu ra tối đa

Khác biệt với Chat Completions

Mục	Chat Completions	Responses
Cấu trúc đầu vào	messages	input + instructions
Phạm vi tương thích	Tương thích nhiều nhất với client OpenAI SDK truyền thống	Phổ biến hơn với client giao thức mới và agent lập trình
Gọi công cụ	Hỗ trợ, tùy thuộc mô hình đã chọn	Hỗ trợ, thường có khả năng biểu đạt mạnh hơn
Kịch bản đề xuất	Chat tổng quát, tích hợp tương thích	Dự án mới, agent lập trình, tác vụ phức tạp

Khuyến nghị tích hợp

• Nếu client yêu cầu rõ giao thức OpenAI Responses, hãy dùng /v1/responses.
• Nếu client chỉ hỗ trợ OpenAI Chat Completions truyền thống, hãy dùng /v1/chat/completions.
• Việc cùng một mô hình có hỗ trợ Responses hay không phụ thuộc vào cấu hình mô hình RouteAPI và khả năng dịch vụ.