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

Tersedia via APIInput teks siapGambar

ID model API

z-image

Input

text

Files API

Tidak diperlukan untuk request minimal

Kredit dasar

Tarif kredit: 0,8 / gambar Biaya akhir tugas dibulatkan ke atas ke kredit utuh.

Kapabilitas

Gambar

Tagihan

FIXED

Batas prompt

1000 karakter

Kontrak request

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

Key	Tipe	Wajib	Default	Deskripsi
model	string	Ya	z-image	Gunakan z-image sebagai id model API.
prompt	string	Ya	-	Maksimum 1000 karakter untuk model ini.
params	object	Tidak	-	Objek parameter khusus model. Gunakan baris di bawah untuk key yang diizinkan.
client_request_id	string	Tidak	-	ID sisi klien opsional untuk melacak request di sistem Anda.

Parameter model

Key	Tipe	Wajib	Default	Rentang	Opsi	Deskripsi
aspect_ratio	select	Tidak	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16	Rasio aspek

Request minimal

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

Response create

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

{
  "id": "task_z_image_example",
  "status": "queued",
  "model": "z-image",
  "reserved_credits": 1,
  "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