Rivya AI Dokümanları
Model API Sayfaları

Seedance 2.0 API Entegrasyonu

Seedance 2.0 modelini Rivya Public API v1 üzerinden model id seedance-2, desteklenen girişler, parametreler, Files API kuralları, krediler ve yanıt örnekleriyle kullanın.

API üzerinden kullanılabilirMetin girişi hazırVideo
API model kimliği

seedance-2

Girişler

text

Files API

Minimal istek için gerekli değil

Temel krediler

per_input_and_output_second · 720p_without_video=41 · 1080p_with_video=62 · 1080p_without_video=102 · 4K_with_video=128 · 4K_without_video=208 · ⌈total⌉

Yetenek

Video

Faturalandırma

METERED

Prompt limiti

20000 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-2seedance-2 API model kimliği değerini kullanın.
promptstringEvet-Bu model için en fazla 20000 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
seedance_sceneselectHayırtext-text, frames, referenceHangi Seedance 2 yolunun çalıştırılacağını seçer: saf metinden videoya, ilk kare / ilk-son kare rehberliği veya çok modlu referans üretimi.
resolutionselectHayır720p-720p, 1080p, 4KÇözünürlük
aspect_ratioselectHayır16:9-1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptiveEn-boy oranı
durationnumberHayır5min 4 / max 15-Süre
generate_audioselectHayırtrue-true, falseSes oluştur
return_last_frameselectHayırfalse-false, trueSon kareyi ayrıca sabit görsel olarak döndürür; kapaklar, takip çalıştırmaları veya sonraki düzenlemeler için kullanışlıdır.
web_searchselectHayırfalse-false, trueWeb araması
nsfw_checkerselectHayırfalse-false, trueNSFW denetimi

Minimal istek

{
  "model": "seedance-2",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "text",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "false"
  }
}

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_2_example",
  "status": "queued",
  "model": "seedance-2",
  "reserved_credits": 205,
  "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

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.