Docs Rivya AI
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.

KeyTipeWajibDefaultDeskripsi
modelstringYaseedream-3-0Gunakan seedream-3-0 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
image_sizeselectTidaksquare_hd-square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9Mengontrol bentuk framing output. Persegi HD adalah default saat ini dan cocok untuk sebagian besar komposisi umum.
guidance_scalenumberTidak2.5min 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.
seednumberTidak-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.