Halaman API Model
Integrasi API Seedream 3.0
Gunakan Seedream 3.0 melalui Rivya Public API v1 dengan id model seedream-3-0, input yang didukung, parameter, aturan Files API, kredit, dan contoh response.
Tersedia via APIInput teks siapGambar
ID model API
seedream-3-0
Input
text
Files API
Tidak diperlukan untuk request minimal
Kredit dasar
5
Kapabilitas
Gambar
Tagihan
FIXED
Batas prompt
5000 karakter
Kontrak request
Kirim id model di level atas. Kontrol khusus model berada di params.
| Key | Tipe | Wajib | Default | Deskripsi |
|---|---|---|---|---|
| model | string | Ya | seedream-3-0 | Gunakan seedream-3-0 sebagai id model API. |
| prompt | string | Ya | - | Maksimum 5000 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 |
|---|---|---|---|---|---|---|
| image_size | select | Tidak | square_hd | - | square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9 | Mengontrol bentuk framing output. Persegi HD adalah default saat ini dan cocok untuk sebagian besar komposisi umum. |
| guidance_scale | number | Tidak | 2.5 | min 1 / max 10 / step 0.1 | - | Nilai valid berjalan dari 1 hingga 10. Nilai yang lebih tinggi biasanya mengikuti prompt lebih dekat, tetapi juga dapat membuat output terasa lebih kaku. |
| seed | number | Tidak | - | min 0 / max 2147483647 | - | 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": "seedream-3-0",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"image_size": "square_hd",
"guidance_scale": 2.5,
"seed": 0
}
}Response create
Endpoint create mengembalikan public task id. Poll endpoint status sampai tugas berhasil atau gagal.
{
"id": "task_seedream_3_0_example",
"status": "queued",
"model": "seedream-3-0",
"reserved_credits": 5,
"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.