Tài liệu Rivya AI
Trang API mô hình

Tích hợp API GPT-5.4 Codex

Dùng GPT-5.4 Codex qua Rivya Public API v1 với ID mô hình gpt-5.4-codex-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.4-codex-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

4

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ô.

KeyLoạiBắt buộcMặc địnhMô tả
modelstringgpt-5.4-codex-chatDùng gpt-5.4-codex-chat làm ID mô hình API.
session_idstringKhông-ID phiên chat do API tạo, không bắt buộc. Bỏ qua để bắt đầu phiên mới.
messagestring-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ô.
attachmentsarrayKhô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_searchbooleanKhôngfalseChỉ áp dụng khi mô hình chat đã chọn hỗ trợ tìm kiếm web.
reasoning_effortstringKhôngdefaultMức suy luận không bắt buộc: default, minimal, low, medium, high hoặc xhigh khi được hỗ trợ.
client_request_idstringKhô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.4-codex-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.4-codex-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_4_codex_chat_example",
  "object": "chat.completion",
  "session_id": "chat_session_gpt_5_4_codex_chat",
  "model": "gpt-5.4-codex-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": 4,
    "final": 4
  }
}

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.