Rivya AI Dokümanları
Model API Sayfaları

Seedream 5.0 Lite API Entegrasyonu

Seedream 5.0 Lite modelini Rivya Public API v1 üzerinden model id seedream-5-lite, desteklenen girişler, parametreler, Files API kuralları, krediler ve yanıt örnekleriyle kullanın.

API üzerinden kullanılabilirMetin veya URL hazır; referans modları Files API kullanırGörsel
API model kimliği

seedream-5-lite

Girişler

text, file

Files API

Referans modları için gerekli

Temel krediler

per_image · default=5.5 · ⌈total⌉

Yetenek

Görsel

Faturalandırma

FIXED

Prompt limiti

3000 karakter

İstek sözleşmesi

Model id değerini en üst seviyede gönderin. Modele özel kontroller params içine aittir.

AnahtarTürGerekliVarsayılanAçıklama
modelstringEvetseedream-5-liteseedream-5-lite API model kimliği değerini kullanın.
promptstringEvet-Bu model için en fazla 3000 karakter.
paramsobjectHayır-Modele özel parametre nesnesi. İzin verilen anahtarlar için aşağıdaki satırları kullanın.
client_request_idstringHayır-Sisteminizde istekleri izlemek için isteğe bağlı istemci tarafı id.

Model parametreleri

AnahtarTürGerekliVarsayılanAralıkSeçeneklerAçıklama
aspectRatioselectHayır1:1-1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9En-boy oranı
qualityselectHayırbasic-basic, high, ultraKalite
output_formatselectHayırpng-png, jpegÇıktı biçimi
nsfw_checkerselectHayırtrue-false, trueModelin isteğe bağlı içerik filtresini etkinleştirin. Hiçbir otomatik filtre eksiksiz kapsama garantisi veremez.

Yükleme politikası

Önce referans dosyalarını yükleyin, ardından dönen URLyi ve duration token değerini params.referenceMediaItems içine yerleştirin.

Referans kuralı

Referans görsel: Görsel projeleri için en fazla 14 görsel dosyası yükleyin.

Maks. dosya

14

Kabul edilen dosya türleri

image

Süre belirteci

Süre doğrulaması gerektiğinde video ve ses referansları /api/v1/files içinden durationToken taşımalıdır.

kindMaks. boyutMIME türleri
image10 MBimage/jpeg, image/png, image/webp

Minimal istek

{
  "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"
  }
}

Referans dosyalı istek

{
  "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"
      }
    ]
  }
}

Create yanıtı

Create endpointi herkese açık task id döndürür. Görev başarılı veya başarısız olana kadar status endpointini sorgulayın.

{
  "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
}

Yaygın hatalar

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Bazı modlar Files API referans yüklemeleri gerektirir.