↓
Docs Rivya AI
Halaman API Model

Integrasi API 4o Image

Gunakan 4o Image melalui Rivya Public API v1 dengan id model 4o-image, input yang didukung, parameter, aturan Files API, kredit, dan contoh response.

Tersedia via APIInput teks siapGambar
ID model API

4o-image

Input

text

Files API

Tidak diperlukan untuk request minimal

Kredit dasar

Tarif kredit: 3 / permintaan Biaya akhir tugas dibulatkan ke atas ke kredit utuh.

Kapabilitas

Gambar

Tagihan

FIXED

Batas prompt

Tidak ada batas prompt terdokumentasi

Kontrak request

Kirim id model di level atas. Kontrol khusus model berada di params.

KeyTipeWajibDefaultDeskripsi
modelstringYa4o-imageGunakan 4o-image sebagai id model API.
promptstringYa-Teks prompt untuk model yang mendukung input teks.
paramsobjectTidak-Objek parameter khusus model. Gunakan baris di bawah untuk key yang diizinkan.
client_request_idstringTidak-ID sisi klien opsional untuk melacak request di sistem Anda.

Parameter model

KeyTipeWajibDefaultRentangOpsiDeskripsi
sizeselectTidak1:1-1:1, 3:2, 2:3Aspect ratio

Request minimal

{
  "model": "4o-image",
  "prompt": "Sebuah botol produk di latar abu-abu muda, dengan pencahayaan lembut dari kiri.",
  "params": {
    "size": "1:1"
  }
}

Response create

Endpoint create mengembalikan public task id. Poll endpoint status sampai tugas berhasil atau gagal.

{
  "id": "task_4o_image_example",
  "status": "queued",
  "model": "4o-image",
  "reserved_credits": 3,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Error umum

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Endpoint create mengembalikan public task id. Poll endpoint status sampai tugas berhasil atau gagal.