Black Forest Labs: FLUX Video Upscale

FLUX Video Upscale amplía un clip existente mediante mejora de detalle fiel a la fuente o creativa. Su perfil documentado ofrece escalado de 1.5×–3×, conserva audio y encuadre originales y limita duración de fuente, resolución de entrada y área del fotograma de salida.

Ailoot Ultra · Generación de video 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 video de Black Forest Labs basado en FLUX 3. Recibe un clip existente y devuelve un MP4 ampliado, conservando encuadre y audio de la fuente. Una descripción breve opcional puede orientar el detalle visual mejorado. Sus dos modos permiten elegir entre mantenerse cerca de la apariencia aportada y generar detalle más agresivo, en vez de considerar toda imagen mayor una reconstrucción igualmente fiel.

Elegir mejora precisa o creativa

El ajuste creativity selecciona el modo. Un valor de 0 es el perfil preciso y fiel a la fuente: el fabricante lo recomienda cuando un rostro, producto o recurso de marca debe conservar su identidad. Un valor de 1 activa mejora creativa de detalle y es el predeterminado. Puede restaurar o inventar textura con mayor intensidad, lo que sirve para material generado, paisajes, multitudes o superficies cuyo detalle pueda desarrollarse creativamente.

El fabricante advierte expresamente que la mejora creativa no conserva rostros y productos con la misma precisión. Revisa el rasgo que debe seguir siendo identificable: apariencia facial, contorno del producto, letras, patrón de material o logotipo. Una imagen más nítida todavía puede contener detalles cambiados o inventados. En una demostración de producto, usa su apariencia prevista como criterio de revisión en vez de elegir una versión solo por tener textura más elaborada.

La instrucción opcional describe el contenido del clip para orientar la mejora; una descripción vacía pide un escalado neutral. Un encargo original de escena generada podría identificar un muro de piedra con musgo, luz diurna suave y textura fina de hojas. Centra la redacción en el material que debe refinarse. Sustituir un objeto, reconstruir el entorno o cambiar diálogo corresponde a una decisión de edición, mientras que este perfil conserva la pista de audio fuente.

Escala y área del fotograma de salida

El upscale_factor documentado va de 1.5 a 3, con 2 como valor predeterminado. Aumenta la resolución fuente conservando la relación de aspecto. El factor y las dimensiones de entrada determinan la salida prevista, de modo que un clip horizontal y una composición vertical deben planearse desde sus fotogramas reales. Prepara el tamaño de visualización de destino antes de elegir cuánto conviene ampliar.

La especificación exacta limita cada fotograma a 13.75 unidades de megapíxel del fabricante. Su documentación define cada unidad 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 de la guía. Una fuente grande puede recibir menos ampliación que el factor solicitado. Comprueba las dimensiones entregadas en vez de suponer que pedir 3× siempre triplica cada dimensión.

El máximo publicado de resolución fuente es 2560×1440. Este flujo aumenta una fuente elegible hacia 4K y más allá; no acepta una fuente ya mayor solo porque se desee una salida superior. Reduce la resolución o prepara una copia de trabajo apropiada antes de usar el perfil documentado. Conserva el original por separado para que la comparación final no se limite a un intermedio redimensionado.

Preparar una fuente breve y legible

La guía ordinaria de preparación limita las fuentes a veinte segundos y cincuenta MB. El clip se proporciona mediante URL de video o MP4 codificado. La referencia exacta señala que se procesan los primeros veinte segundos: un pequeño exceso puede procesarse solo hasta ese punto, mientras que un clip sustancialmente más largo se rechaza. No se publica tolerancia numérica. Recorta al segmento previsto de veinte segundos o menos en vez de depender de ese comportamiento de límite no especificado.

Elige la versión menos comprimida disponible. Los artefactos de compresión limitan el detalle real recuperable y la mejora creativa puede producir textura plausible sin demostrar qué contenía la escena original. Completa la edición y el recorte antes de ampliar el clip. Un flujo original podría terminar una toma de producto, elegir el intervalo útil de acción y ampliar esa selección final, conservando la fuente intacta para comparar.

El resultado conserva la pista de audio fuente. Revisa su sincronización con la imagen, sobre todo al inicio y final de un segmento seleccionado. El perfil no ofrece selector independiente de frecuencia de fotogramas, generación nueva de diálogo ni controles de edición con referencias de imagen. Su propósito es obtener video mayor con el tratamiento de detalle elegido, conservando el material temporal y sonoro fuente dentro del segmento procesado.

Conservar y revisar el clip entregado

El flujo del fabricante es asíncrono: una tarea enviada aporta identidad y ubicación de estado, y el resultado completo contiene un enlace firmado de entrega MP4. Ese enlace vence aproximadamente en una hora. Conserva el clip real, fuente, factor, modo de creatividad y descripción en vez de depender de la ubicación temporal. Distingue estado fallido o moderado de video completado.

Revisa fotogramas individuales para rostros, marcas y cambios de superficie; después mira la secuencia para continuidad, movimiento y alineación del audio. Las salidas precisas y creativas responden a necesidades diferentes; el recurso útil es el clip ampliado que cumpla el objetivo elegido de fidelidad al tamaño de visualización previsto. Una resolución mayor no demuestra por sí sola que identidad, redacción o detalle fino originales sigan siendo correctos.

Ailoot Ultra · Generación de video POST /v1/videos black-forest-labs/flux-video-upscale

black-forest-labs/flux-video-upscale

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

Inicio

Entradas aceptadas: Texto · Imágenes · Audio · Video
Resultados: Video

Disponible en Ailoot · entradas y métodos

Ailoot Ultra · Generación de video POST /v1/videos

Entrada: text, image, audio, video
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 real de contenido de un recurso de video completado que te pertenezca, con la firma devuelta. El propietario, el tipo y la evidencia de bytes almacenados del recurso 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

Tarifas

Cómo se calcula el cargo definitivo

Las tarifas mostradas permiten estimar el costo antes de la generación. El cargo final se calcula a partir del costo registrado para la generación original. La duración medida de la salida y las cantidades estimadas no son 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 fast: Sin especificar Cuando se selecciona el modo fast
Modo flex: Sin especificar Cuando se selecciona el modo flex
Esfuerzo máximo de razonamiento: Sin especificar Cuando el esfuerzo máximo de razonamiento usa el ajuste 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 video	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 video · Estimación solo para comparar $0.21 por megapíxel-segundo
ConfiguraciónPrecio del video	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 video · Estimación solo para comparar $0.15 por megapíxel-segundo
ConfiguraciónCosto 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 · Costo 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 por la generación completada.

Ailoot reserva un monto 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 · Generación de video

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 · Generación de video

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 videos completados o archivos recibidos; descarga cada URL de archivo que se haya devuelto.

Conserva la respuesta completa y los encabezados, 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 el id/polling_url real devuelto. 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