Docs Rivya AI
Halaman API Model

Integrasi API Seedream 5.0 Lite

Gunakan Seedream 5.0 Lite melalui Rivya Public API v1 dengan id model seedream-5-lite, input yang didukung, parameter, aturan Files API, kredit, dan contoh response.

Tersedia via APITeks atau URL siap; mode referensi memakai Files APIGambar
ID model API

seedream-5-lite

Input

text, file

Files API

Diperlukan untuk mode referensi

Kredit dasar

per_image · default=5.5 · ⌈total⌉

Kapabilitas

Gambar

Tagihan

FIXED

Batas prompt

3000 karakter

Kontrak request

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

KeyTipeWajibDefaultDeskripsi
modelstringYaseedream-5-liteGunakan seedream-5-lite sebagai id model API.
promptstringYa-Maksimum 3000 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
aspectRatioselectTidak1:1-1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9Rasio aspek
qualityselectTidakbasic-basic, high, ultraKualitas
output_formatselectTidakpng-png, jpegFormat keluaran
nsfw_checkerselectTidaktrue-false, trueAktifkan filter konten opsional pada model. Tidak ada filter otomatis yang dapat menjamin cakupan sepenuhnya.

Kebijakan unggahan

Unggah file referensi terlebih dahulu, lalu tempatkan URL dan duration token yang dikembalikan ke dalam params.referenceMediaItems.

Aturan referensi

Gambar referensi: Unggah hingga 14 file gambar untuk proyek gambar.

File maksimum

14

Jenis file yang diterima

image

Duration token

Referensi video dan audio harus membawa durationToken dari /api/v1/files saat verifikasi durasi diperlukan.

kindUkuran maksimumTipe MIME
image10 MBimage/jpeg, image/png, image/webp

Request minimal

{
  "model": "seedream-5-lite",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "1:1",
    "quality": "basic",
    "output_format": "png",
    "nsfw_checker": "true"
  }
}

Request file referensi

{
  "model": "seedream-5-lite",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "1:1",
    "quality": "basic",
    "output_format": "png",
    "nsfw_checker": "true",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Response create

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

{
  "id": "task_seedream_5_lite_example",
  "status": "queued",
  "model": "seedream-5-lite",
  "reserved_credits": 6,
  "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

Beberapa mode membutuhkan unggahan referensi Files API.