Docs Rivya AI
Halaman API Model

Integrasi API Google Imagen4 Ultra

Gunakan Google Imagen4 Ultra melalui Rivya Public API v1 dengan id model google-imagen4-ultra, input yang didukung, parameter, aturan Files API, kredit, dan contoh response.

Tersedia via APIInput teks siapGambar
ID model API

google-imagen4-ultra

Input

text

Files API

Tidak diperlukan untuk request minimal

Kredit dasar

12

Kapabilitas

Gambar

Tagihan

FIXED

Batas prompt

5000 karakter

Kontrak request

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

KeyTipeWajibDefaultDeskripsi
modelstringYagoogle-imagen4-ultraGunakan google-imagen4-ultra sebagai id model API.
promptstringYa-Maksimum 5000 karakter untuk model ini.
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
aspect_ratioselectTidak1:1-1:1, 16:9, 9:16, 3:4, 4:3Rasio aspek
negative_prompttextTidak---Prompt negatif
seedtextTidak---Biarkan kosong untuk hasil acak baru setiap kali. Menggunakan ulang integer yang sama membuat hasil sebelumnya lebih mudah direproduksi atau disempurnakan. Hasil hanya akan lebih dekat bila prompt dan pengaturan kunci lain juga tetap mirip, dan ini bukan jaminan kecocokan 1:1.

Request minimal

{
  "model": "google-imagen4-ultra",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "negative_prompt": "Hal opsional yang ingin dihindari",
    "seed": "Nilai seed opsional"
  }
}

Response create

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

{
  "id": "task_google_imagen4_ultra_example",
  "status": "queued",
  "model": "google-imagen4-ultra",
  "reserved_credits": 12,
  "final_credits": 0,
  "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.