API integrace Seedance 1.0 Lite
Použijte Seedance 1.0 Lite přes Rivya Public API v1 s model id seedance-1-0-lite, podporovanými vstupy, parametry, pravidly Files API, kredity a příklady odpovědí.
seedance-1-0-lite
text, file
Vyžadováno pro referenční režimy
16
Video
FIXED
10000 znaků
Kontrakt požadavku
Model id posílejte na horní úrovni. Model-specific controls patří do params.
| Klíč | Typ | Povinné | Výchozí | Popis |
|---|---|---|---|---|
| model | string | Ano | seedance-1-0-lite | Použijte API model id seedance-1-0-lite. |
| prompt | string | Ano | - | Maximum 10000 znaků pro tento model. |
| params | object | Ne | - | Objekt parametrů specifických pro model. Povolené klíče najdete v řádcích níže. |
| client_request_id | string | Ne | - | Volitelné client-side id pro trasování požadavků ve vašem systému. |
Parametry modelu
| Klíč | Typ | Povinné | Výchozí | Rozsah | Možnosti | Popis |
|---|---|---|---|---|---|---|
| resolution | select | Ne | 720p | - | 480p, 720p, 1080p | Rozlišení |
| duration | select | Ne | 5 | - | 5, 10 | Délka |
| aspect_ratio | select | Ne | 16:9 | - | 16:9, 4:3, 1:1, 3:4, 9:16, 9:21 | Poměr stran |
| camera_fixed | select | Ne | false | - | false, true | Určuje, zda se má záběr chovat spíš jako pevná kamera. Zapnutí udrží pohyb kamery zdrženlivější; vypnutí dovolí zřetelnější pohyb. |
| seed | number | Ne | -1 | min -1 / max 2147483647 | - | Nechte prázdné, pokud chcete pokaždé nový náhodný výsledek. Opakované použití stejného celého čísla usnadňuje zopakování nebo doladění předchozího výsledku. Výsledek se přiblíží jen tehdy, když prompt i další klíčová nastavení zůstanou podobné, a nejde o zaručenou shodu 1:1. |
| enable_safety_checker | select | Ne | true | - | true, false | Bezpečnostní kontrola |
Pravidla nahrávání
Nejprve nahrajte referenční soubory a potom vložte vrácenou URL a duration token do params.referenceMediaItems.
Referenční obrázek: Nahrajte 1 zdrojový obrázek pro image-to-video, nebo 2 obrázky, když chcete přidat také volitelný koncový frame.
2
image
Video a audio reference by měly nést durationToken z /api/v1/files, když je vyžadováno ověření délky.
| kind | Max. velikost | MIME typy |
|---|---|---|
| image | 10 MB | image/jpeg, image/png, image/webp |
Minimální požadavek
{
"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"
}
}Požadavek s referenčním souborem
{
"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"
}
]
}
}Odpověď vytvoření
Create endpoint vrátí public task id. Pollujte status endpoint, dokud úloha neuspěje nebo neselže.
{
"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
}Běžné chyby
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
Některé režimy vyžadují referenční nahrání přes Files API.