Dùng GPT-5.2 qua Rivya Public API v1 với ID mô hình gpt-5-2-chat, đầu vào được hỗ trợ, tham số, quy tắc Files API, tín dụng và ví dụ phản hồi.

Khả dụng qua APIĐầu vào văn bản sẵn sàngChat

ID mô hình API

gpt-5-2-chat

Đầu vào

text, file

Files API

Không bắt buộc cho yêu cầu tối thiểu

Tín dụng cơ bản

Năng lực

Chat

Độ sẵn sàng

Chat API: không truyền luồng + truyền luồng SSE

Thanh toán

TOKEN_BASED

Giới hạn prompt

20000 ký tự

Quy ước yêu cầu

Yêu cầu Chat gửi từng tin nhắn một. Lịch sử phiên được Rivya lưu; đừng gửi mảng messages thô.

Key	Loại	Bắt buộc	Mặc định	Mô tả
model	string	Có	gpt-5-2-chat	Dùng gpt-5-2-chat làm ID mô hình API.
session_id	string	Không	-	ID phiên chat do API tạo, không bắt buộc. Bỏ qua để bắt đầu phiên mới.
message	string	Có	-	Tin nhắn người dùng tiếp theo. Lịch sử Chat API lấy từ phiên phía máy chủ, không phải mảng messages thô.
attachments	array	Không	-	Các giá trị file_id ảnh không bắt buộc do Files API trả về. Không chấp nhận URL tệp đính kèm bên ngoài.
enable_web_search	boolean	Không	false	Chỉ áp dụng khi mô hình chat đã chọn hỗ trợ tìm kiếm web.
reasoning_effort	string	Không	default	Mức suy luận không bắt buộc: default, minimal, low, medium, high hoặc xhigh khi được hỗ trợ.
client_request_id	string	Không	-	ID phía client không bắt buộc để theo dõi yêu cầu trong hệ thống của bạn.

Tham số mô hình

Mô hình chat này dùng các trường Chat API dùng chung ở trên. Hỗ trợ riêng cho tìm kiếm web, tệp ảnh đính kèm, thoughts và reasoning được phản ánh trong dữ liệu sẵn sàng.

Yêu cầu tối thiểu

{
  "model": "gpt-5-2-chat",
  "message": "Write a concise launch plan for a new product image campaign"
}

Yêu cầu có tệp tham chiếu

{
  "model": "gpt-5-2-chat",
  "message": "Write a concise launch plan for a new product image campaign",
  "attachments": [
    {
      "file_id": "file_uploaded_image_id"
    }
  ]
}

Phản hồi tạo

Điểm cuối Chat trả về tin nhắn assistant đã hoàn tất, lượng token sử dụng và phần kết toán tín dụng cuối cùng cho lượt này.

{
  "id": "chatcmpl_msg_gpt_5_2_chat_example",
  "object": "chat.completion",
  "session_id": "chat_session_gpt_5_2_chat",
  "model": "gpt-5-2-chat",
  "created_at": "2026-05-11T00:00:00.000Z",
  "message": {
    "id": "assistant_message_id",
    "role": "assistant",
    "content": "A concise launch plan with clear next steps."
  },
  "usage": {
    "input_tokens": 1200,
    "output_tokens": 320,
    "total_tokens": 1520
  },
  "credits": {
    "reserved": 3,
    "final": 3
  }
}

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported

Chat API hỗ trợ lượt không truyền luồng và truyền luồng SSE trong Public API v1. Tệp ảnh đính kèm phải dùng giá trị file_id của Files API.

Tích hợp API GPT-5.2