Integración de API de Seedance 1.0 Lite
Usa Seedance 1.0 Lite mediante Rivya Public API v1 con el model id seedance-1-0-lite, entradas compatibles, parámetros, reglas de Files API, créditos y ejemplos de respuesta.
seedance-1-0-lite
text, file
Requerido para modos con referencia
16
Vídeo
FIXED
10000 caracteres
Contrato de solicitud
Envía el ID de modelo en el nivel superior. Los controles específicos del modelo van en params.
| Key | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
| model | string | Sí | seedance-1-0-lite | Usa seedance-1-0-lite como ID de modelo de API. |
| prompt | string | Sí | - | Máximo de 10000 caracteres para este modelo. |
| params | object | No | - | Objeto de parámetros específico del modelo. Usa las filas siguientes para ver las keys permitidas. |
| client_request_id | string | No | - | ID opcional del cliente para rastrear solicitudes en tu sistema. |
Parámetros del modelo
| Key | Tipo | Obligatorio | Predeterminado | Rango | Opciones | Descripción |
|---|---|---|---|---|---|---|
| resolution | select | No | 720p | - | 480p, 720p, 1080p | Resolución |
| duration | select | No | 5 | - | 5, 10 | Duración |
| aspect_ratio | select | No | 16:9 | - | 16:9, 4:3, 1:1, 3:4, 9:16, 9:21 | Relación de aspecto |
| camera_fixed | select | No | false | - | false, true | Controla si la toma debe comportarse más como una cámara fija. Al activarlo, el movimiento de cámara se mantiene más contenido; al desactivarlo, se permite un movimiento más evidente. |
| seed | number | No | -1 | min -1 / max 2147483647 | - | Déjalo vacío para obtener un resultado aleatorio nuevo cada vez. Reutilizar el mismo entero facilita reproducir o ajustar un resultado anterior. Solo se mantiene más cerca cuando el prompt y otros ajustes clave también siguen siendo similares, y no garantiza una coincidencia 1:1. |
| enable_safety_checker | select | No | true | - | true, false | Comprobador de seguridad |
Política de subida
Primero sube los archivos de referencia; después coloca la URL devuelta y el durationToken dentro de params.referenceMediaItems.
Imagen de referencia: Sube 1 imagen de origen para imagen a vídeo, o 2 imágenes cuando también quieras proporcionar un fotograma final opcional.
2
image
Las referencias de video y audio deben incluir durationToken de /api/v1/files cuando se requiera verificar la duración.
| kind | Tamaño máximo | Tipos MIME |
|---|---|---|
| image | 10 MB | image/jpeg, image/png, image/webp |
Solicitud mínima
{
"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"
}
}Solicitud con archivo de referencia
{
"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"
}
]
}
}Respuesta de creación
El endpoint de creación devuelve un ID de tarea público. Consulta el endpoint de estado hasta que la tarea termine correctamente o falle.
{
"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
}Errores comunes
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
Algunos modos requieren subidas de referencia mediante Files API.