Black Forest Labs: FLUX Video Upscale

FLUX Video Upscale amplía un clip existente mediante una mejora de detalle fiel al original o creativa. Su perfil documentado ofrece escalado de 1.5×–3×, conserva el audio y el encuadre de origen y limita la duración, la resolución de entrada y el área de los fotogramas de salida.

Ailoot Ultra · Vídeo POST /v1/videos black-forest-labs/flux-video-upscale

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 Upscale es el flujo de superresolución de vídeo de Black Forest Labs impulsado por FLUX 3. Recibe un clip existente y devuelve un MP4 ampliado, trasladando al resultado el encuadre y el audio de origen. Una descripción opcional breve puede orientar el detalle visual mejorado. Sus dos modos ofrecen una elección significativa entre mantenerse cerca del aspecto suministrado y generar detalle de forma más agresiva, en lugar de tratar toda imagen más grande como una reconstrucción igualmente fiel.

Elegir mejora precisa o creativa

El ajuste de creatividad selecciona el modo. Un valor de 0 corresponde al perfil preciso y fiel al original: el fabricante lo recomienda cuando un rostro, producto o recurso de marca debe conservar su identidad. Un valor de 1 activa la mejora creativa del detalle y es el predeterminado. Puede restaurar o inventar texturas de forma más agresiva, lo que resulta útil para material generado, paisajes, multitudes o superficies cuyo detalle pueda desarrollarse creativamente.

El fabricante advierte expresamente de que la mejora creativa no preserva rostros y productos con el mismo rigor. Compruebe el rasgo que debe seguir siendo identificable: el aspecto facial, el contorno de un producto, las letras, un patrón de material o un logotipo. Una imagen que parece más nítida puede contener un detalle modificado o inventado. Para una demostración de producto, utilice el aspecto previsto del producto como criterio de revisión, en lugar de seleccionar una versión solo porque su textura sea más elaborada.

La instrucción opcional describe el contenido del clip para orientar la mejora; una descripción vacía solicita una ampliación neutra. Un encargo original de escena generada podría identificar un muro de piedra cubierto de musgo, luz diurna suave y una fina textura de hojas. Mantenga la redacción centrada en el material que se debe perfeccionar. Una petición de sustituir un objeto, reconstruir el escenario o cambiar el diálogo corresponde a una decisión de edición, mientras que este perfil conserva la pista de audio de origen.

Escala y área de los fotogramas de salida

El parámetro documentado upscale_factor va de 1.5 a 3, con 2 como valor predeterminado. Amplía la resolución de origen conservando la relación de aspecto. El factor seleccionado y las dimensiones de entrada determinan la salida prevista, por lo que un clip horizontal y una composición vertical deben planificarse a partir de sus fotogramas reales. Prepare el tamaño de visualización de destino antes de elegir cuánto conviene ampliar.

La especificación exacta limita cada fotograma de salida a 13.75 unidades de megapíxel del fabricante. Su documentación define una unidad de este tipo como 1 048 576 píxeles, lo que da un máximo de 14 417 920 píxeles, aproximadamente 14.4 millones. Esto explica la expresión redondeada de 14.4 megapíxeles en la guía. Por tanto, un original grande puede recibir menos ampliación que la solicitada por el factor. Compruebe las dimensiones entregadas, en lugar de asumir que una petición de 3× siempre triplica cada dimensión de origen.

El máximo publicado de resolución de origen es 2560×1440. Este flujo aumenta un original admisible hacia 4K y más allá; no acepta uno que ya sea mayor solo porque se desee una salida superior. Reduzca el tamaño o prepare una copia de trabajo adecuada antes de utilizar ese perfil documentado. Conserve la grabación original por separado para que la comparación final no se limite a un intermedio redimensionado.

Preparar un original breve y legible

Las indicaciones habituales de preparación del fabricante limitan los originales a veinte segundos y cincuenta MB. El clip se proporciona mediante una URL de vídeo o MP4 codificado. Su referencia exacta señala que se procesan los primeros veinte segundos: un pequeño exceso de duración puede procesarse solo hasta esa marca, mientras que un clip considerablemente más largo se rechaza. No se publica una tolerancia numérica. Recorte el segmento previsto a veinte segundos o menos, en lugar de depender de ese comportamiento de límite no especificado.

Elija la versión menos comprimida disponible. Los artefactos de compresión limitan la cantidad de detalle real que puede recuperar el ampliador, y la mejora creativa puede crear una textura plausible sin demostrar qué contenía la escena original. Complete la edición y el recorte previstos antes de ampliar el clip seleccionado. Un flujo original podría terminar primero un plano de producto, elegir el intervalo de acción útil y después ampliar esa selección definitiva, conservando el original sin modificar para compararlo.

El resultado conserva la pista de audio de origen. Examine su sincronización con la imagen, especialmente al principio y al final de un segmento seleccionado. El perfil documentado no ofrece un selector independiente de fotogramas por segundo, generación de diálogo nuevo ni controles de edición con referencias de imagen. Su finalidad es obtener un vídeo mayor con el tratamiento de detalle elegido, conservando el material temporal y sonoro del original dentro del segmento procesado.

Conservar y comprobar el clip entregado

El flujo del fabricante es asíncrono: una tarea enviada proporciona una identidad y una ubicación de estado, y su resultado completado contiene un enlace firmado de entrega del MP4. Ese enlace caduca después de aproximadamente una hora. Conserve el clip real, el original, el factor elegido, el modo de creatividad y la descripción del contenido, en lugar de depender de la ubicación temporal. Distinga un estado fallido o moderado de un vídeo completado.

Revise fotogramas individuales para comprobar rostros, marcas y cambios de superficie, y después vea la secuencia para comprobar continuidad, movimiento y alineación del audio. Las salidas precisas y creativas responden a necesidades visuales diferentes; el recurso útil es el clip ampliado que cumple el objetivo de fidelidad elegido al tamaño de visualización previsto. Una resolución mayor por sí sola no demuestra que se hayan mantenido correctos la identidad, las palabras o el detalle fino originales.

Ailoot Ultra · Vídeo POST /v1/videos black-forest-labs/flux-video-upscale

black-forest-labs/flux-video-upscale

Black Forest Labs /black-forest-labs/flux-video-upscale

Primeros pasos

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
Campo`model`	Tipo`string`	RequisitoObligatorio	Valores y límites black-forest-labs/flux-video-upscale	Predeterminado—
Campo`input_references`	Tipo`array`	RequisitoObligatorio	Valores y límites Número mínimo de elementos: 1 Número máximo de elementos: 1	Predeterminado—
Campo`upscale_factor`	Tipo`number`	RequisitoObligatorio	Valores y límites Mínimo: 1,5 Máximo: 3	Predeterminado—
Campo`creativity`	Tipo`integer`	RequisitoObligatorio	Valores y límites 0, 1	Predeterminado—

Parámetros del método y ciclo de vida

Parámetro	Contrato
Parámetro`content_type`	Contratoapplication/json
Parámetro`required`	Contratomodel, input_references, upscale_factor, creativity
Parámetro`material_types`	Contratotext, image, audio, video
Parámetro`material_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	Píxeles por megapíxel	Cargo
ConfiguraciónTarifas base por token	Tabla de tarifasTarifa base	Cantidad prevista—	Unidad de facturación—	Condiciones de facturación—	Píxeles por megapíxel—	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 megapíxel-segundo	Condiciones de facturacióncalidad: creative	Píxeles por megapíxel1.048.576	Cargo Salida · Precio del vídeo · Estimación solo para comparar $0.21 por megapíxel-segundo
ConfiguraciónPrecio del vídeo	Tabla de tarifas—	Cantidad prevista—	Unidad de facturaciónpor megapíxel-segundo	Condiciones de facturaciónquality: precise	Píxeles por megapíxel1.048.576	Cargo Salida · Precio del vídeo · Estimación solo para comparar $0.15 por megapíxel-segundo
ConfiguraciónCoste estimado de generación	Tabla de tarifas—	Cantidad previstaestimación para una generación	Unidad de facturación—	Condiciones de facturación—	Píxeles por megapíxel—	Cargo Salida · Coste estimado de generación · Estimación solo para comparar $0.15 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

Usa la entrada real y conserva el resultado completo

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_UPSCALE_FACTOR:?Set the actual documented input value}"
export AILOOT_UPSCALE_FACTOR
: "${AILOOT_CREATIVITY:?Set the actual documented input value}"
export AILOOT_CREATIVITY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
request={'model': 'black-forest-labs/flux-video-upscale', 'input_references': '${ACTUAL_OWNED_INPUT_REFERENCES}', 'upscale_factor': '${ACTUAL_UPSCALE_FACTOR}', 'creativity': '${ACTUAL_CREATIVITY}'}
request['input_references']=json.loads(os.environ['AILOOT_INPUT_REFERENCES_JSON'])
request['upscale_factor']=float(os.environ['AILOOT_UPSCALE_FACTOR'])
request['creativity']=int(os.environ['AILOOT_CREATIVITY'])
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

Obtener todos los archivos completados con GET

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
Campo`id`	Tipo
Campo`status`	Tipo
Campo`data[]`	Tipo
Campo`outputs[]`	Tipo

Alias

Alias del modelo

Ailoot Ultra black-forest-labs/flux-video-upscale

Alias de rutas de métodos

Usa las rutas de método indicadas arriba.

ID de modelo relacionados

black-forest-labs/flux-video-upscale

FAQ · Black Forest Labs: FLUX Video Upscale

¿Qué entradas y resultados están disponibles?: POST /v1/videos · black-forest-labs/flux-video-upscale: text, image, audio, video → video
¿Qué campos utiliza la solicitud?: POST /v1/videos · black-forest-labs/flux-video-upscale: model, input_references, upscale_factor, creativity
¿Qué límites se aplican?: POST /v1/videos · black-forest-labs/flux-video-upscale: upscale_factor.minimum: 1.5; upscale_factor.maximum: 3

Black Forest Labs: FLUX Video Upscale