API de imagen a video
Parte de una imagen y describe el movimiento; el modelo la animará en un clip de video. Muchos modelos también aceptan un primer y último fotograma, o varias referencias para guiar el clip.
Modelos
Todos los modelos que aparecen a continuación aceptan el modo "image_to_video" con un image_url en POST /v1/videos/generations. Los precios son por segundo de video en la ruta predeterminada, a la resolución mostrada; los precios de Seedance son estimaciones basadas en su facturación por tokens.
| Modelo e ID de modelo de la API | Opciones | Precio en official-cheap (predeterminado) |
|---|---|---|
Seedance 2.5bytedance/seedance-2.5 | Tamaños: 480p, 720p, 1080pClips de 4–30 segundos | $0.213 por segundo de 720pofficial: $0.231 |
Seedance 2.0bytedance/seedance-2.0 | Tamaños: 480p, 720p, 1080p, 4KClips de 4–15 segundos | $0.139 por segundo de 720pofficial: $0.151 |
Seedance 2.0 Fastbytedance/seedance-2.0-fast | Tamaños: 480p, 720pClips de 4–15 segundos | $0.111 por segundo de 720pofficial: $0.121 |
Seedance 2.0 Minibytedance/seedance-2.0-mini | Tamaños: 480p, 720pClips de 4–15 segundos | $0.07 por segundo de 720pofficial: $0.076 |
Wan 3.0alibaba/wan-3.0 | Tamaños: 480p, 720p, 1080pClips de 2–15 segundos | $0.083 por segundo de 720pofficial: $0.092 |
Wan 3.0 Primealibaba/wan-3.0-prime | Tamaños: 480p, 720p, 1080pClips de 2–15 segundos | $0.125 por segundo de 720pofficial: $0.138 |
HappyHorse 1.1alibaba/happyhorse-1.1 | Tamaños: 480p, 720p, 1080pClips de 3–15 segundos | $0.125 por segundo de 720pofficial: $0.138 |
HappyHorse 1.0alibaba/happyhorse-1.0 | Tamaños: 720p, 1080pClips de 3–15 segundos | $0.125 por segundo de 720pofficial: $0.138 |
Grok Imagine Video 1.5xai/grok-imagine-video-1.5 | Tamaños: 480p, 720p, 1080pClips de 1–15 segundos | $0.126 por segundo de 720pofficial: $0.14 |
Grok Imagine Video 1.5 Litexai/grok-imagine-video-1.5-lite | Tamaños: 480p, 720p, 1080pClips de 1–15 segundos | $0.027 por segundo de 720pofficial: $0.03 |
Kling 4.0kwaivgi/kling-4.0 | Tamaños: 720p, 1080pClips de 3–30 segundos | $0.138 por segundo de 720pofficial: $0.154 |
MiniMax H3minimax/h3 | Tamaños: 480p, 768p, 2KClips de 5–15 segundos | $0.072 por segundo de 768pofficial: $0.08 |
MiniMax H3 Maxminimax/h3-max | Tamaños: 480p, 768pClips de 5–15 segundos | $0.072 por segundo de 768pofficial: $0.08 |
MiniMax H3 Max Turbominimax/h3-max-turbo | Tamaños: 480p, 768pClips de 5–15 segundos | $0.036 por segundo de 768pofficial: $0.04 |
Inicio rápido
- Crear una clave de API
Crea una clave en la consola y guárdala como la variable de entorno MLMUX_API_KEY.
Crear una clave de API - Enviar una solicitud
El ejemplo envía Seedance 2.0 (bytedance/seedance-2.0) a https://api.mlmux.com/v1/videos/generations. Cambia el ID del modelo por cualquier modelo de la tabla anterior.
- Leer el resultado
La respuesta es una tarea. Consulta periódicamente su poll_url cada pocos segundos hasta que status sea succeeded, luego descarga el video o configura un webhook para recibir notificaciones.
Referencia de la API de video
curl https://api.mlmux.com/v1/videos/generations \
-H "Authorization: Bearer $MLMUX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "bytedance/seedance-2.0",
"route_mode": "official-cheap",
"prompt": "The camera slowly pushes in while steam rises from the cup",
"mode": "image_to_video",
"image_url": "https://your-cdn.example/start-frame.jpg",
"ratio": "16:9",
"resolution": "720p",
"duration": 5,
"generate_audio": true
}'
# The response is a task. Poll it until "status" is "succeeded", then read "video".
curl https://api.mlmux.com/v1/videos/generations/TASK_ID \
-H "Authorization: Bearer $MLMUX_API_KEY"Preguntas frecuentes
¿Qué modelo debería usar para imagen a video?
Seedance 2.0 es una buena opción predeterminada. Seedance 2.5 y Wan 3.0 Prime ofrecen el movimiento más rico, Kling 4.0 genera clips de hasta 30 segundos y Grok Imagine Video 1.5 Lite es la opción más económica.
¿Cuánto cuesta la API de imagen a video?
Desde aproximadamente $0.027 por segundo de video (Grok Imagine Video 1.5 Lite) en la ruta predeterminada. Seedance cuenta la imagen inicial como imagen de referencia, no como video de referencia, por lo que aplica la tarifa más baja; los demás modelos cobran lo mismo por segundo con o sin imagen inicial.
¿Cómo envío la imagen inicial?
Pase una URL pública en image_url o suba el archivo con POST /v1/uploads y use la URL devuelta. La solicitud devuelve una tarea; sondee su estado o reciba un webhook cuando el video esté listo.
¿Se me cobra por las solicitudes fallidas? ¿Hay algún límite?
Las solicitudes fallidas no se cobran y los créditos retenidos para ellas se devuelven a tu saldo. Cada cuenta puede ejecutar hasta 60 tareas al mismo tiempo; escribe a support@mlmux.com si necesitas más.