Black Forest Labs: FLUX Video Edit
FLUX Video Edit [fast] transforma un clip existente mediante una instrucción escrita de edición. Añada, elimine o sustituya elementos, cambie el escenario o el estilo y modifique diálogos existentes respetando las restricciones documentadas de duración del original, encuadre y audio.
Sobre el modelo
Esta descripción cubre las capacidades del modelo. Las entradas, salidas y opciones disponibles en Ailoot se indican a continuación para el método seleccionado.
FLUX Video Edit [fast] es el flujo de Black Forest Labs guiado por instrucciones para modificar un vídeo existente. Recibe un clip de origen y una instrucción que describe la edición, y después devuelve un MP4 editado. El original establece el plano: su duración, encuadre, movimiento de cámara y sincronización proporcionan la estructura de partida. Utilice la instrucción para identificar qué debe cambiar, en lugar de escribir una descripción de escena completamente nueva que deje poco claro el cambio previsto.
Nombrar el cambio y su posición
Las ediciones documentadas incluyen eliminar, añadir o sustituir objetos y personajes, reconstruir el escenario, cambiar el estilo del clip, modificar texto visible y revisar diálogo o sonido. Comience por el objetivo y la operación. Una instrucción original podría eliminar un bolso de una silla conservando a la persona sentada y la habitación, o sustituir una taza sencilla por una taza esmaltada azul sin cambiar la acción de la mano. Si hay varios objetos similares visibles, distinga el objetivo por su posición, aspecto o función.
Para una incorporación, describa la ubicación, la escala y la acción pertinente. Una lámpara roja alta al lado del sofá es más concreta que una lámpara adicional sin especificar en algún punto del plano. Para una sustitución, identifique qué se convierte en qué y el movimiento o contacto que debe permanecer. La guía de instrucciones del fabricante recomienda la instrucción más breve que nombre completamente el cambio, añadiendo detalle donde lo requiera la edición. Conserve deliberadamente rasgos del original, en lugar de pedir una mejora general cuyo alcance no se pueda evaluar.
Escenarios, estilos y animación preliminar
Un cambio de escenario puede reconstruir el entorno visible conservando la acción. El fabricante demuestra la sustitución de una superficie de escalada por otra estructura y la especificación de los nuevos puntos de contacto, de forma que las manos y los pies del personaje sigan teniendo una superficie con sentido. En una escena práctica, describa el entorno modificado y la geometría de la que depende el movimiento existente. Un fondo nuevo resulta más fácil de evaluar cuando la acción original tiene una relación explícita con él.
La guía también muestra cómo transformar una animación preliminar en un tratamiento visual terminado. Nombre en qué vehículos u objetos previstos se convierten los objetos de la maqueta preliminar y después conserve sus trayectorias, velocidades y relación con la cámara. Para cambiar el estilo, describa los materiales, las superficies, la luz y los reflejos resultantes, además de la estética. Una escena de aspecto de arcilla y una de aspecto fotográfico necesitan indicaciones visibles diferentes aunque sigan la misma acción.
Una revisión posterior puede utilizar el primer resultado editado como nuevo original. Conserve el original y cada etapa seleccionada y asigne a la siguiente pasada un propósito claro. El ejemplo documentado pasa de una previsualización preliminar a un escenario terminado y después a otro tratamiento de iluminación. Tras cada pasada, compare el clip revisado con el original anterior y compruebe que los rasgos que deseaba conservar siguen presentes.
El diálogo debe caber en el tiempo existente
El flujo conserva el audio de origen salvo que la instrucción solicite un cambio de diálogo o sonido. Un original silencioso devuelve un resultado silencioso, por lo que no aporta voz existente que modificar. Para una edición de diálogo, cite la frase prevista, identifique al hablante y ajuste las palabras nuevas al tiempo ocupado por la frase original. La guía informa de una sustitución más larga que se cortó al superar el intervalo disponible de voz. Escribir más palabras no crea tiempo adicional para hablar dentro del plano existente.
Revise la frase audible junto a la interpretación visible. Conserve una copia de la redacción de origen y de la sustitución prevista para identificar una palabra omitida, una frase mal sincronizada o un cambio de sonido no deseado. El resultado útil es el momento hablado modificado dentro de la escena editada, no una transcripción que se suponga fiel solo porque terminó el renderizado.
Límites del original y salida heredada
El perfil exacto del fabricante exige un vídeo y una instrucción de edición. La instrucción debe tener entre uno y 4096 caracteres tras eliminar los espacios en blanco de los extremos. El clip se proporciona mediante una URL o MP4 codificado, con duración máxima de quince segundos y límite de entrada de cincuenta MiB. Cada lado debe tener al menos 160 píxeles y el clip normalizado debe contener al menos diecisiete fotogramas a 24 fps, aproximadamente siete décimas de segundo. Los originales demasiado largos se rechazan, en lugar de recortarse silenciosamente; los demasiado pequeños pueden fallar durante el procesamiento.
El flujo documentado utiliza procesamiento a 24 fps y sigue la duración y la relación de aspecto de origen. Las entradas superiores al perfil de 720p se reducen; el fabricante da el ejemplo de un original de 1920×1088 que se devuelve como 1248×704. La duración, la resolución y la relación de aspecto no son ajustes independientes de salida en este perfil de edición. Su procedimiento de muestreo se gestiona internamente y campos como mode, version, seed o generate_audio no se aceptan en el contrato de solicitud indicado.
Un vídeo utilizado solo como inspiración de movimiento o estilo para un plano nuevo generado corresponde a un flujo diferente. Este editor no acepta una referencia de imagen, entrada solo de audio, máscaras ni una petición de ampliar el clip. Prepare el vídeo real que se va a modificar y conserve su duración seleccionada antes de escribir la edición. Tras el procesamiento asíncrono, el fabricante devuelve el MP4 editado mediante un enlace firmado temporal de entrega, válido durante aproximadamente una hora. Guarde el resultado y compare el objeto modificado, los fotogramas circundantes, la sincronización y el audio con el original antes de utilizar el clip en una edición más larga.
Ailoot Ultra · Vídeo POST /v1/videos black-forest-labs/flux-video-edit
black-forest-labs/flux-video-edit
black-forest-labs/flux-video-editPrimeros pasos
FLUX Video Edit [fast] transforma un clip existente mediante una instrucción escrita de edición. Añada, elimine o sustituya elementos, cambie el escenario o el estilo y modifique diálogos existentes respetando las restricciones documentadas de duración del original, encuadre y audio.
- Entradas aceptadas
- Texto · Imágenes · Audio · Vídeo
- Resultados
- Vídeo
Disponible en Ailoot · entradas y métodos
Ailoot Ultra · Vídeo POST /v1/videos
- Tipos de entrada
text,image,audio,video- Tipos de salida
video
| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites black-forest-labs/flux-video-edit | Predeterminado— |
Campoinput_references | Tipoarray | RequisitoObligatorio | Valores y límites Número mínimo de elementos: 1 Número máximo de elementos: 1 | Predeterminado— |
Campoprompt | Tipostring | RequisitoObligatorio | Valores y límites Longitud mínima: 1 | Predeterminado— |
Parámetros del método y ciclo de vida
| Parámetro | Contrato |
|---|---|
Parámetrocontent_type | Contratoapplication/json |
Parámetrorequired | Contratomodel, input_references, prompt |
Parámetromaterial_types | Contratotext, image, audio, video |
Parámetromaterial_conditions | ContratoUsa exactamente una URL de contenido real de un recurso de vídeo completado bajo tu titularidad, con la firma devuelta. La titularidad del recurso, su tipo y la evidencia de bytes almacenada deben coincidir con la solicitud. |
Ciclo de vida: asynchronous_job_then_owned_outputs
GET /v1/videos/{request_id} · id o polling_url real devuelto
GET /v1/videos/{request_id}/content
Planes
Cómo se calcula el cargo definitivo
Las tarifas mostradas estiman el coste antes de la generación. El cargo final se calcula a partir del coste registrado para la generación original. La duración medida del resultado y las cantidades previstas no constituyen la cantidad facturable final.
Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.
- Modo rápido
- Sin especificar Cuando se selecciona el modo rápido
- Modo flex
- Sin especificar Cuando se selecciona el modo flex
- Esfuerzo máximo de razonamiento
- Sin especificar Cuando el esfuerzo máximo de razonamiento utiliza el ajuste predeterminado (default)
Tarifas estimadas para comparar
Precios por configuración
Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas.
| Configuración | Tabla de tarifas | Cantidad prevista | Unidad de facturación | Condiciones de facturación | Cargo |
|---|---|---|---|---|---|
| ConfiguraciónTarifas base por token | Tabla de tarifasTarifa base | Cantidad prevista— | Unidad de facturación— | Condiciones de facturación— | Cargo Entrada · Tokens de entrada · Estimación solo para comparar — / 1K tokens Salida · Tokens de salida · Estimación solo para comparar — / 1K tokens Entrada · Lectura de caché · Estimación solo para comparar — / 1K tokens Entrada · Escritura en caché · Estimación solo para comparar — / 1K tokens Entrada · Escritura en caché, 1 hora · Estimación solo para comparar — / 1K tokens |
| ConfiguraciónPrecio del vídeo | Tabla de tarifas— | Cantidad prevista— | Unidad de facturaciónpor segundo de vídeo | Condiciones de facturaciónNo se declara ninguna condición adicional en esta clave de precios. | Cargo Salida · Precio del vídeo · Estimación solo para comparar $0.06 por segundo de vídeo |
| ConfiguraciónCoste estimado de generación | Tabla de tarifas— | Cantidad previstaestimación para una generación | Unidad de facturación— | Condiciones de facturación— | Cargo Salida · Coste estimado de generación · Estimación solo para comparar $0.06 estimación previa a la generación Esta estimación no es un cargo adicional ni una tarifa fija para la generación completada. |
Ailoot reserva un importe estimado antes de la solicitud. Tras obtener el resultado, liquida el cargo definitivo según el uso medido. En las respuestas en flujo, la liquidación usa el registro de uso final. Cómo funcionan la reserva y la liquidación →
Solicitudes de ejemplo
Ailoot Ultra · Vídeo
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_INPUT_REFERENCES_JSON:?Set the actual documented input value}"
export AILOOT_INPUT_REFERENCES_JSON
: "${AILOOT_PROMPT:?Set the actual documented input value}"
export AILOOT_PROMPT
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
request={'model': 'black-forest-labs/flux-video-edit', 'input_references': '${ACTUAL_OWNED_INPUT_REFERENCES}', 'prompt': '${ACTUAL_EDIT_PROMPT}'}
request['input_references']=json.loads(os.environ['AILOOT_INPUT_REFERENCES_JSON'])
request['prompt']=os.environ['AILOOT_PROMPT']
Path('request.json').write_text(json.dumps(request,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o response.bin
# Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.
Recibir y guardar resultados
Ailoot Ultra · Vídeo
GET /v1/videos/{request_id}GET /v1/videos/{request_id}/content
Guarda todos los archivos completados
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"
export AILOOT_STATUS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
from urllib.parse import urlsplit,urljoin
f=Path(os.environ["AILOOT_STATUS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual completed status file")
r=json.loads(f.read_text())
if r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")
urls=[]
for x in r["data"]:
if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path")
u=urljoin("https://api.ailoot.ai",x)
z=urlsplit(u)
if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")
urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_REQUEST
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"
index=$((index + 1))
done < asset-urls.txt
Conserva todos los resultados completados
Guarda todos los vídeos completados o archivos recibidos; descarga cada URL de archivo que se haya devuelto.
Conserva la respuesta completa y las cabeceras, todas las salidas reales, los identificadores originales devueltos y todos los campos de uso. Recupera la operación original sin volver a enviar la solicitud de creación.
Si es necesario revisar la respuesta original
Conserva X-Client-Request-ID, X-Ailoot-Task-Id y los valores reales devueltos de id/polling_url. Continúa el trabajo original; no vuelvas a enviar la solicitud de creación.
Campos de respuesta
| Campo | Tipo |
|---|---|
Campoid | Tipo |
Campostatus | Tipo |
Campodata[] | Tipo |
Campooutputs[] | Tipo |
Alias
Alias del modelo
Ailoot Ultra black-forest-labs/flux-video-edit
Alias de rutas de métodos
Usa las rutas de método indicadas arriba.
ID de modelo relacionados
FAQ · Black Forest Labs: FLUX Video Edit
- ¿Qué entradas y resultados están disponibles?
POST /v1/videos·black-forest-labs/flux-video-edit:text,image,audio,video→video- ¿Qué campos utiliza la solicitud?
POST /v1/videos·black-forest-labs/flux-video-edit:model,input_references,prompt