Integrasi API GPT-5.4
Gunakan GPT-5.4 melalui Rivya Public API v1 dengan id model gpt-5-4-chat, input yang didukung, parameter, aturan Files API, kredit, dan contoh response.
gpt-5-4-chat
text, file
Tidak diperlukan untuk request minimal
4
Chat
API chat: tanpa streaming + streaming SSE
TOKEN_BASED
20000 karakter
Kontrak request
Request chat mengirim satu pesan setiap kali. Riwayat session disimpan oleh Rivya; jangan kirim array raw messages.
| Key | Tipe | Wajib | Default | Deskripsi |
|---|---|---|---|---|
| model | string | Ya | gpt-5-4-chat | Gunakan gpt-5-4-chat sebagai id model API. |
| session_id | string | Tidak | - | ID session chat buatan API yang opsional. Abaikan untuk memulai session baru. |
| message | string | Ya | - | Pesan pengguna berikutnya. Riwayat Chat API berasal dari session sisi server, bukan array raw messages. |
| attachments | array | Tidak | - | Nilai file_id gambar opsional yang dikembalikan Files API. URL lampiran eksternal tidak diterima. |
| enable_web_search | boolean | Tidak | false | Hanya berlaku saat model chat yang dipilih mendukung web search. |
| reasoning_effort | string | Tidak | default | Reasoning effort opsional: default, minimal, low, medium, high, atau xhigh saat didukung. |
| client_request_id | string | Tidak | - | ID sisi klien opsional untuk melacak request di sistem Anda. |
Parameter model
Model chat ini memakai field Chat API bersama di atas. Dukungan khusus model untuk web search, lampiran file gambar, thoughts, dan reasoning tercermin dalam data readiness.
Request minimal
{
"model": "gpt-5-4-chat",
"message": "Write a concise launch plan for a new product image campaign"
}Request file referensi
{
"model": "gpt-5-4-chat",
"message": "Write a concise launch plan for a new product image campaign",
"attachments": [
{
"file_id": "file_uploaded_image_id"
}
]
}Response create
Endpoint Chat mengembalikan pesan assistant yang selesai, token usage, dan settlement kredit final untuk turn ini.
{
"id": "chatcmpl_msg_gpt_5_4_chat_example",
"object": "chat.completion",
"session_id": "chat_session_gpt_5_4_chat",
"model": "gpt-5-4-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
}
}Error umum
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API mendukung turn non-streaming dan SSE streaming di Public API v1. Lampiran gambar harus memakai nilai file_id dari Files API.