Responses API

/v1/responses là một trong những endpoint chính thức của OpenAI. Chính thức khuyến nghị các dự án mới ưu tiên đánh giá Responses; nếu client hoặc framework của bạn mặc định sử dụng Chat Completions, hãy dùng Gọi tương thích OpenAI.

Base URL vẫn là https://api.rokoapi.com/v1.

Endpoint

POST /v1/responses

Bắt đầu nhanh

curl https://api.rokoapi.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-4o",
    "input": "Hãy giới thiệu bản thân trong một câu",
    "instructions": "Bạn là một trợ lý trả lời súc tích"
  }'

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.rokoapi.com/v1",
)

response = client.responses.create(
    model="gpt-4o",
    input="Hãy giới thiệu bản thân trong một câu",
    instructions="Bạn là một trợ lý trả lời súc tích",
)
print(response.output_text)

Để lấy văn bản, ưu tiên dùng output_text; khi duyệt thủ công output lưu ý mục đầu tiên có thể là reasoning thay vì message.

Tham số thường dùng

Nhãn khả năng của mô hình

Trang mô hình hiển thị trực tiếp các khả năng Responses được cấu hình trong trang quản trị. Hãy kiểm tra các nhãn sau trước khi gửi yêu cầu:

Client không được giả định rằng khả năng không hiển thị là khả dụng. Mô hình tương thích qua chuyển đổi không công bố các tính năng phụ thuộc vào vòng đời tài nguyên upstream, như trạng thái hội thoại, lưu phản hồi hoặc compaction.

Các mô hình chuyển đổi tương thích hiện tại

Các mô hình này dùng chế độ chuyển đổi không trạng thái. Hãy lưu toàn bộ lịch sử hội thoại và lệnh gọi công cụ ở phía client rồi gửi lại trong input tiếp theo. Chúng không hỗ trợ previous_response_id, conversation, compact hoặc lưu phản hồi.

Đối thoại đa vòng

Theo mặc định, hãy duy trì lịch sử ở phía client và đưa toàn bộ ngữ cảnh vào mảng input. Chỉ sử dụng tham số có trạng thái khi trang mô hình hiển thị rõ previous-response-id hoặc conversation-state.

Đầu ra streaming

Streaming của Responses là các sự kiện ngữ nghĩa (ví dụ response.output_text.delta), khác với cách Chat Completions xử lý choices[0].delta của Chat Completions. Sau khi đặt stream: true xử lý theo loại sự kiện.

So sánh với Chat Completions

Lưu ý

• Vui lòng kiểm tra trước trên Trang mô hình hoặc tài liệu mô hình đã triển khai để xác nhận mô hình đích có hỗ trợ Responses hay không
• Công cụ tích hợp và tác vụ nền phụ thuộc vào upstream; khả năng không được công bố trên trang mô hình không thuộc cam kết tương thích

Liên kết liên quan

• Gọi tương thích OpenAI
• Yêu cầu streaming
• Ví dụ SDK