Rivya AI Dokümanları
Model API Sayfaları

Seedance 1.0 Lite API Entegrasyonu

Seedance 1.0 Lite modelini Rivya Public API v1 üzerinden model id seedance-1-0-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ırVideo
API model id

seedance-1-0-lite

Girişler

text, file

Files API

Referans modları için gerekli

Temel krediler

16

Yetenek

Video

Faturalandırma

FIXED

Prompt limiti

10000 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
modelstringEvetseedance-1-0-liteseedance-1-0-lite API model id değerini kullanın.
promptstringEvet-Bu model için en fazla 10000 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
resolutionselectHayır720p-480p, 720p, 1080pÇözünürlük
durationselectHayır5-5, 10Süre
aspect_ratioselectHayır16:9-16:9, 4:3, 1:1, 3:4, 9:16, 9:21En-boy oranı
camera_fixedselectHayırfalse-false, trueÇekimin daha sabit bir kamera gibi davranıp davranmayacağını kontrol eder. Açıldığında kamera hareketi daha sınırlı kalır; kapatıldığında daha belirgin harekete izin verir.
seednumberHayır-1min -1 / max 2147483647-Her seferinde yeni bir rastgele sonuç için boş bırakın. Aynı tam sayıyı yeniden kullanmak, önceki bir sonucu yeniden üretmeyi veya ince ayar yapmayı kolaylaştırır. Yalnızca istem ve diğer temel ayarlar da benzer kaldığında sonuca daha yakın durur; bire bir eşleşme garanti değildir.
enable_safety_checkerselectHayırtrue-true, falseGüvenlik denetimi

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örselden videoya için 1 kaynak görsel yükleyin; isteğe bağlı bitiş karesi sağlamak istediğinizde 2 görsel yükleyin.

Maks. dosya

2

Kabul edilen dosya türleri

image

Duration token

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": "seedance-1-0-lite",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "camera_fixed": "false",
    "seed": -1,
    "enable_safety_checker": "true"
  }
}

Referans dosyalı istek

{
  "model": "seedance-1-0-lite",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "camera_fixed": "false",
    "seed": -1,
    "enable_safety_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_seedance_1_0_lite_example",
  "status": "queued",
  "model": "seedance-1-0-lite",
  "reserved_credits": 16,
  "final_credits": 0,
  "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.