Integración de API de Seedance 1.5 Pro
Usa Seedance 1.5 Pro mediante Rivya Public API v1 con el model id seedance-1-5-pro, entradas compatibles, parámetros, reglas de Files API, créditos y ejemplos de respuesta.
seedance-1-5-pro
text, file
Requerido para modos con referencia
28
Vídeo
FIXED
2500 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-5-pro | Usa seedance-1-5-pro como ID de modelo de API. |
| prompt | string | Sí | - | Máximo de 2500 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 | 8 | - | 4, 8, 12 | Duración |
| generate_audio | select | No | false | - | false, true | Generar audio |
| aspectRatio | select | No | 1:1 | - | 1:1, 4:3, 3:4, 16:9, 9:16, 21:9 | Relación de aspecto |
| fixed_lens | 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. |
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 hasta 2 archivos de imagen para proyectos de imagen.
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-5-pro",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"resolution": "720p",
"duration": "8",
"generate_audio": "false",
"aspectRatio": "1:1",
"fixed_lens": "false"
}
}Solicitud con archivo de referencia
{
"model": "seedance-1-5-pro",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"resolution": "720p",
"duration": "8",
"generate_audio": "false",
"aspectRatio": "1:1",
"fixed_lens": "false",
"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_5_pro_example",
"status": "queued",
"model": "seedance-1-5-pro",
"reserved_credits": 28,
"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.