POST /flux/videos para completar la generación de videos, la generación de video a partir de imágenes de fotogramas clave, la continuación de videos y la mejora de borradores. action=generate (predeterminado), mode selecciona el modo de generación; para consultar resultados se utiliza de forma unificada el ya existente POST /flux/tasks.
Actualmente está en Beta. La generación de video a partir de texto, la generación de video a partir de imágenes, la continuación de videos y la mejora de borradores ya están disponibles. HTTP 200 y el ID de tarea solo indican que la tarea fue aceptada; se debe continuar consultando el resultado final.
1. Obtener API Token
- Regístrate o inicia sesión en la consola de Ace Data Cloud, crea una aplicación y obtén un API Token. Un API Token general puede llamar a los servicios de la plataforma; confirma que la aplicación tenga permisos para llamar al servicio Flux y saldo disponible.
- Consulta los planes y los precios de cada operación en la página del servicio Flux. Cuando el saldo sea insuficiente, recarga en la página de saldo de la consola.
- Las solicitudes utilizan
Authorization: Bearer <tu Token>. El Token debe guardarse en variables de entorno del servidor, no lo escribas en páginas frontend, repositorios públicos, capturas de pantalla ni URL de callback.
El código de este documento lee de forma unificada la variable de entorno:
Para los campos completos y la depuración en línea, consulta Flux Videos API; para la consulta de tareas, consulta Flux Tasks API.
2. Elegir operación y entrada
El modelo de generación es
flux-3, y action es generate (predeterminado). Selecciona la generación de video a partir de texto, la generación de video a partir de imágenes, la continuación de video o la mejora de borrador mediante mode.
Parámetros generales de generación
La URL del material debe poder ser leída por el servicio. Si se utiliza una URL firmada temporal, debe reservarse suficiente tiempo de validez para la descarga y el procesamiento. No utilices direcciones de páginas web como direcciones de archivos de imágenes o videos.
3. Generación de video a partir de texto: solicitud y resultado completos probados
La siguiente solicitud se ejecutó correctamente en la interfaz de producción antes del ajuste de precios del 2026-10-02. Omitiraction verificó el comportamiento de generación predeterminado; async=true evita esperar una conexión HTTP durante mucho tiempo.
task_id de tu propia respuesta y continúa consultando; no utilices el ID de tarea de ejemplo de la documentación para consultar resultados de otras cuentas.
response devuelto por la consulta de tarea contiene el resultado final de negocio. Lo siguiente es el response exitoso de esta prueba, omitiendo los metadatos externos de la tarea. La URL de video de la documentación se ha reemplazado por una copia del mismo archivo en un CDN de ejemplo de larga duración (SHA-256 idéntico); las llamadas reales devolverán la URL de resultado propia de esta tarea:
Esta es una prueba histórica antes del ajuste de precios:
list_amount=2.9871876975 Credits, la cuenta tenía entonces un 10% de descuento de consumo, y el amount=2.68846892775 Credits real. El nuevo precio del 2026-10-02 ya se ha reducido aproximadamente un 6.33%; el mismo borrador de 5.041667 segundos cuesta 2.798125185 Credits al precio actual (antes del descuento de consumo), y si aún disfruta de un 10% de descuento de consumo sería 2.5183126665 Credits. Las facturas de tareas históricas no se recalculan. Los planes y descuentos de otras cuentas pueden ser diferentes; este no es un precio fijo en dólares para todos los usuarios.
4. Imagen a video: normal y con fotogramas clave temporizados
Los siguientes son ejemplos de parámetros, es necesario reemplazar las URL de los recursos, no son una declaración de que este ejemplo se haya ejecutado correctamente. Después de completar la generación, consulte según el flujo anterior, la estructura del resultado es la misma. Una o dos imágenes usan un arreglo normal:[segundos, URL de imagen]:
Salida de prueba de imagen a video
La entrada coincidente de esta prueba es la siguiente (solo se reemplaza el base64 completo con texto descriptivo, los demás campos son solicitudes reales):
Después de descargar este fotograma clave PNG, puede usar base64.b64encode(image_bytes).decode("ascii") de Python para obtener la cadena original e introducirla en el arreglo keyframes. No use el texto descriptivo del documento como entrada de imagen.
Lo siguiente es la response final real de la tarea de producción del 2026-10-01 (no una respuesta simulada); solo la URL del video se ha sustituido por una copia de ejemplo a largo plazo con el mismo hash. La entrada de prueba usó la cadena base64 original de un PNG de 1280×720 como un único fotograma clave; la entrada de URL anterior es un ejemplo de parámetro independiente.
5. Continuación de video
start_video recibe la dirección de un archivo de video existente, mode=v2v, con una duración máxima de 15 segundos.
Salida de prueba de continuación de video
La entrada completa de esta prueba es la siguiente; al reproducir la mejora de borrador, se debe reemplazar con su propio ID de borrador. La URL del material utiliza una copia de ejemplo a largo plazo del mismo archivo:start_video de entrada de prueba es el video de borrador completado, y los demás parámetros son duration=5、resolution=hd、generate_audio=false。
6. Primero borrador, luego mejora
- Use
draft=true、resolution=hdpara generar un borrador y espere a que tenga éxito. - Obtenga el ID de borrador de la plataforma desde el
data[0].draft_task_idfinal. - Use las credenciales de la aplicación de la misma propiedad para enviar una solicitud de mejora:
prompt、duration、aspect_ratio、version、generate_audio、draft、keyframes、start_video para sobrescribir el contenido original. La caché del borrador es un recurso temporal, mejórela a tiempo; no se promete almacenamiento permanente ni un número fijo de días de retención. Los borradores de otras personas/de la aplicación actual, los borradores sin completar y las cachés caducadas no pueden reutilizarse. El borrador y la mejora son dos tareas, y se cobran por separado después de tener éxito.
Salida de prueba de mejora de borrador
La entrada completa de esta prueba es la siguiente; al reproducir la mejora de borrador, se debe reemplazar con su propio ID de borrador. La URL del material utiliza una copia de ejemplo a largo plazo del mismo archivo:7. Llamada de extremo a extremo en Python
Instalerequests, configure su propio Token y ejecute el siguiente script para completar “enviar una vez → sondear → mostrar la URL del video”. Tanto las consultas como los reintentos de red deben usar el task_id original para evitar volver a enviar tareas de pago.
8. Uso de callbacks
Agreguecallback_url al enviar; una vez completada la tarea, se enviará el resultado JSON final mediante POST a esa dirección. La estructura de éxito es coherente con la response anterior, mientras que los fallos incluyen error.
9. Facturación actual y tabla de precios
Actualizado el 2026-10-02: los precios unitarios de cada nivel de esta interfaz de video se redujeron aproximadamente un 6.33%; el método de medición, los planes y las reglas de descuentos por consumo permanecen sin cambios. El cost de las response de pruebas históricas anteriores es la factura al completarse la tarea y no representa la cotización actual. La generación de video se factura según los segundos de salida reales. A continuación se muestran los precios unitarios actuales en Credits sin aplicar descuentos por consumo de la cuenta, coherentes con las reglas de la página de precios de Flux.
Conversión a dólares estadounidenses:
costo real (USD) = cost.amount (Credits) × price del plan / amount del plan. Los niveles de recarga y los descuentos por consumo afectan el precio real; los Credits no pueden considerarse directamente como USD. Las tareas fallidas no cobran tarifas de generación; el importe final se basa en el resultado de finalización y los registros de llamadas de la consola.
10. Preguntas frecuentes y solución de problemas
Al enviar comentarios, proporcione task_id, trace_id, la hora de la solicitud y parámetros anonimizados; no envíe el API Token. Consulte más métodos en la guía de integración de Flux MCP.