Introducción
Seedance 2.0 Mini referencias a video reúne varias fuentes autorizadas en una sola toma: imágenes para el quién y el qué, clips para el movimiento y el ritmo, audio para el compás en el que cae el corte. No recibe un primer fotograma.
Seedance 2.0 Mini es el nivel más pequeño de la línea Seedance 2.0 de ByteDance. Publica los mismos endpoints que Seedance 2.0 Fast y devuelve clips de 4 a 15 segundos en 480p o 720p, con audio generado en la misma pasada.
Elige el modo de Seedance 2.0 Mini según tu material inicial
| Material inicial | Modo |
|---|---|
| Un guion o la descripción de una escena | Seedance 2.0 Mini Texto a video |
| Una imagen inicial aprobada | Seedance 2.0 Mini Imagen a video |
| Referencias separadas de apariencia, movimiento o audio | Seedance 2.0 Mini Referencias a video |
Funciones y aspectos destacados
El mismo contrato que Seedance 2.0 Fast
Mini publica los mismos endpoints y campos que Seedance 2.0 Fast: formato adaptable más seis relaciones fijas, de 4 a 15 segundos o -1 para que el modelo elija la duración, audio nativo y seed, con la resolución limitada a 720p. Un pipeline escrito para Mini pasa a Fast cambiando el id del modelo, no la solicitud.
Pensado para volumen
Mini es el nivel indicado cuando el rendimiento importa más que la calidad extra de los modelos Seedance 2.0 más grandes. Todos los endpoints son asíncronos: envía un Idempotency-Key en cada solicitud, guarda los ids de tarea y deja que el sondeo o los callbacks los resuelvan. La clave vale 24 horas, así que un reintento tras una conexión caída devuelve la tarea original.
Secuencias más largas con extensión de video
Para pasar de quince segundos, envía un clip terminado al endpoint video-extend: su último fotograma abre una nueva toma de Seedance 2.0 Mini y recibes un solo archivo con ambas partes unidas. Cada paso factura solo los segundos que añade, y el resultado unido se puede extender de nuevo.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Obligatorio, y aquí además hace el reparto. mínimo 1 caracteres |
reference_image_urls | No | Hasta 9 imágenes que tengas autorización para usar, para un personaje, un producto, un estilo o un decorado. máximo 9 elementos |
reference_video_urls | No | Hasta 3 clips que aportan movimiento, ritmo o lenguaje de cámara. máximo 3 elementos |
reference_audio_urls | No | Hasta 3 archivos de audio, de 2 a 15 segundos cada uno y 15 en total, cada uno por debajo de 15 MB, que dan a la toma un ancla sonora — entonación, tempo, una frase musical — a… máximo 3 elementos |
aspect_ratio | No | Encuadre de salida, adaptive por defecto: el clip toma la forma de la referencia principal. |
resolution | No | Resolución de salida: 480p o 720p por defecto. Elige un escalón de tarifa y no va a afilar referencias de baja resolución. |
duration_seconds | No | Duración del clip final en segundos enteros, de 4 a 15, 5 por defecto; con -1 la elige el modelo y la estimación supone 15 segundos. |
generate_audio | No | Determina si se renderiza una banda sonora nativa sincronizada con la imagen. Activo por defecto; apagarlo no baja la tarifa en esta versión. Valor predeterminado: |
enable_web_search | No | Apagado por defecto. Al activarlo, el modelo puede buscar en la web información relacionada con tu prompt antes de renderizar. Valor predeterminado: |
seed | No | Seed entera; si la omites, cada tirada saca la suya. Fíjala con todo lo demás constante para juzgar qué cambió realmente un retoque de prompt. |
return_last_frame | No | Devuelve además el último fotograma del clip como imagen aparte, junto al video. Valor predeterminado: |
bitrate_mode | No | Tasa de bits del archivo entregado: |
watermark | No | Añade al video la marca de agua visible «AI generated» del propio modelo. Valor predeterminado: |
Precios
Los clips de referencia suman segundos facturables. Como no podemos medir tus clips antes de ejecutar la tarea, retenemos por adelantado el importe de los 15 segundos máximos y liberamos la parte no utilizada en cuanto se liquida — solo se te cobran los segundos realmente usados.
| Especificación | Precio |
|---|---|
| $0.010969 / segundo |
| $0.023588 / segundo |
| $0.0246078 / segundo |
| $0.05292 / segundo |
| $0.036 / segundo |
| $0.072 / segundo |
Casos de uso
Un conjunto de referencias para toda una serie
Tres vistas de un hombre —de frente, en tres cuartos y de perfil— más una cuarta imagen de su delantal pueden sostener una serie completa mientras solo cambia el prompt entre solicitudes. El ejemplo publicado de la panadería está armado exactamente así.
Ritmo tomado de un clip
Un clip de referencia puede aportar ritmo en lugar de contenido. Un ejemplo toma un avance continuo y pausado de un clip, lo monta en un pasillo de una imagen de referencia y hace coincidir los pasos con el pulso de una pista de referencia, ocho segundos en 9:16.
Una pareja estable en distintos ángulos
Tres imágenes de la misma pareja permiten que una toma nueva encuentre un tercer ángulo mientras rostros y vestuario se mantienen, como en el ejemplo de la banca del parque generado en 480p.
Guía de prompts y consejos prácticos
Nombra cada referencia por su posición
El prompt es obligatorio y se encarga del casting, porque las referencias se leen en el orden en que las envías. Escribe "References 1-3 are..." o usa @Image1, @Image2 para que cada recurso tenga una sola tarea.
Conoce los límites
Envía hasta 9 imágenes, 3 clips y 3 pistas de audio, con al menos una imagen o un clip en cada solicitud. Clips y audio duran de 2 a 15 segundos cada uno y 15 segundos en total, y los segundos de tus clips de referencia se cobran además de la salida.
Adapta el ejemplo incluido
El ejemplo publicado usa aspect_ratio 16:9, duration_seconds 6, generate_audio true y resolution 720p, con cuatro imágenes en reference_image_urls.
@Image1, @Image2 and @Image3 are the same man from front, three-quarter and profile; @Image4 is his apron. Put him behind the counter of a small bakery at opening time in that apron, sliding a tray into the case and glancing up as the door chimes. Warm ovens, flat morning light.
Tres ángulos sostienen el rostro, la cuarta imagen sostiene el vestuario y el prompt dice qué es cada una. Conserva esa división cuando elijas a tu propio personaje.
¿Necesitas un primer fotograma exacto? Usa imagen a video
Este endpoint no tiene campo de primer ni de último fotograma. Cuando la imagen inicial deba coincidir exactamente con una foto, envía esa foto a imagen a video y describe solo el movimiento.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedance-2.0-mini/reference-to-video",
"input": {
"aspect_ratio": "adaptive",
"bitrate_mode": "standard",
"duration_seconds": 5,
"enable_web_search": false,
"generate_audio": true,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"reference_image_urls": [
"https://example.com/reference.png"
]
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.
















