Gunakan Z-Image melalui Rivya Public API v1 dengan ID model z-image, input disokong, parameter, peraturan Files API, kredit dan contoh respons.

Tersedia melalui APIInput teks sediaImej

ID model API

z-image

Input

text

Files API

Tidak diperlukan untuk permintaan minimum

Kredit asas

Keupayaan

Imej

Bil

FIXED

Had prompt

1000 aksara

Kontrak permintaan

Hantar ID model pada peringkat atas. Kawalan khusus model berada dalam params.

Kunci	Jenis	Wajib	Lalai	Penerangan
model	string	Ya	z-image	Gunakan ID model API z-image.
prompt	string	Ya	-	Maksimum 1000 aksara untuk model ini.
params	object	Tidak	-	Objek parameter khusus model. Gunakan baris di bawah untuk kunci yang dibenarkan.
client_request_id	string	Tidak	-	ID sisi klien pilihan untuk menjejak permintaan dalam sistem anda.

Parameter model

Kunci	Jenis	Wajib	Lalai	Julat	Pilihan	Penerangan
aspect_ratio	select	Tidak	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16	Nisbah aspek

Permintaan minimum

{
  "model": "z-image",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1"
  }
}

Respons cipta

Endpoint cipta mengembalikan ID tugasan awam. Poll endpoint status sehingga tugasan berjaya atau gagal.

{
  "id": "task_z_image_example",
  "status": "queued",
  "model": "z-image",
  "reserved_credits": 1,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Ralat biasa

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found