Seedance 1.0 Pro API Entegrasyonu
Seedance 1.0 Pro modelini Rivya Public API v1 üzerinden model id seedance-1-0-pro, desteklenen girişler, parametreler, Files API kuralları, krediler ve yanıt örnekleriyle kullanın.
seedance-1-0-pro
text, file
Referans modları için gerekli
25
Video
FIXED
10000 karakter
İstek sözleşmesi
Model id değerini en üst seviyede gönderin. Modele özel kontroller params içine aittir.
| Anahtar | Tür | Gerekli | Varsayılan | Açıklama |
|---|---|---|---|---|
| model | string | Evet | seedance-1-0-pro | seedance-1-0-pro API model id değerini kullanın. |
| prompt | string | Evet | - | Bu model için en fazla 10000 karakter. |
| params | object | Hayır | - | Modele özel parametre nesnesi. İzin verilen anahtarlar için aşağıdaki satırları kullanın. |
| client_request_id | string | Hayır | - | Sisteminizde istekleri izlemek için isteğe bağlı istemci tarafı id. |
Model parametreleri
| Anahtar | Tür | Gerekli | Varsayılan | Aralık | Seçenekler | Açıklama |
|---|---|---|---|---|---|---|
| resolution | select | Hayır | 720p | - | 480p, 720p, 1080p | Çözünürlük |
| duration | select | Hayır | 5 | - | 5, 10 | Süre |
| aspect_ratio | select | Hayır | 16:9 | - | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | En-boy oranı |
| camera_fixed | select | Hayır | false | - | 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. |
| seed | number | Hayır | -1 | min -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_checker | select | Hayır | true | - | true, false | Gü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 görsel: Görselden videoya çalıştırmaları için 1 görsel dosyası yükleyin.
1
image
Süre doğrulaması gerektiğinde video ve ses referansları /api/v1/files içinden durationToken taşımalıdır.
| kind | Maks. boyut | MIME türleri |
|---|---|---|
| image | 10 MB | image/jpeg, image/png, image/webp |
Minimal istek
{
"model": "seedance-1-0-pro",
"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-pro",
"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_pro_example",
"status": "queued",
"model": "seedance-1-0-pro",
"reserved_credits": 25,
"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.