Gunakan Ideogram V3 melalui Rivya Public API v1 dengan ID model ideogram-v3, input disokong, parameter, peraturan Files API, kredit dan contoh respons.

Tersedia melalui APIInput teks sediaImej

ID model API

ideogram-v3

Input

text

Files API

Tidak diperlukan untuk permintaan minimum

Kredit asas

Keupayaan

Imej

Bil

FIXED

Had prompt

5000 aksara

Kontrak permintaan

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

Kunci	Jenis	Wajib	Lalai	Penerangan
model	string	Ya	ideogram-v3	Gunakan ID model API ideogram-v3.
prompt	string	Ya	-	Maksimum 5000 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
rendering_speed	select	Tidak	BALANCED	-	TURBO, BALANCED, QUALITY	Mengimbangkan kelajuan, kos dan perincian. Turbo ialah yang paling pantas dan murah, Kualiti ialah yang paling terperinci dan mahal, manakala Seimbang ialah pilihan tengah lalai.
style	select	Tidak	AUTO	-	AUTO, GENERAL, REALISTIC, DESIGN	Gaya
expand_prompt	select	Tidak	true	-	true, false	Suis pengembangan prompt Ideogram. Menghidupkannya membantu model mengembangkan huraian anda; mematikannya lebih baik apabila anda mahukan kawalan prompt yang ketat.
image_size	select	Tidak	square_hd	-	square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9	Saiz imej
seed	number	Tidak	-	min 0	-	Biarkan kosong untuk hasil rawak baharu setiap kali. Menggunakan semula nombor bulat yang sama memudahkan anda menghasilkan semula atau memperhalus hasil sebelumnya. Hasil hanya kekal lebih hampir apabila prompt dan tetapan utama lain juga masih serupa, dan ia bukan padanan 1:1 yang dijamin.
negative_prompt	text	Tidak	-	-	-	Prompt negatif

Permintaan minimum

{
  "model": "ideogram-v3",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "rendering_speed": "BALANCED",
    "style": "AUTO",
    "expand_prompt": "true",
    "image_size": "square_hd",
    "seed": 0,
    "negative_prompt": "Perkara pilihan untuk dielakkan"
  }
}

Respons cipta

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

{
  "id": "task_ideogram_v3_example",
  "status": "queued",
  "model": "ideogram-v3",
  "reserved_credits": 7,
  "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