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.
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.
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.
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.
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.
", "aboutText": "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.\n\n### Elegir mejora precisa o creativa\n\nEl 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.\n\nEl 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.\n\nLa 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.\n\n### Escala y área del fotograma de salida\n\nEl 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.\n\nLa 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.\n\nEl 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.\n\n### Preparar una fuente breve y legible\n\nLa 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.\n\nElige 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.\n\nEl 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.\n\n### Conservar y revisar el clip entregado\n\nEl 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.\n\nRevisa 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.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "a816f3dd74b599c33eb1a706ff02a3b0fcd1c610af91d988e11a7d10e7c0432a", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "es-mx", "methods": [ { "html": "black-forest-labs/flux-video-upscaleFLUX 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.
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.
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.
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.
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.
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.
POST /v1/videostext, image, audio, videovideo| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites black-forest-labs/flux-video-upscale | Predeterminado— |
Campoinput_references | Tipoarray | RequisitoObligatorio | Valores y límites Número mínimo de elementos: 1 Número máximo de elementos: 1 | Predeterminado— |
Campoupscale_factor | Tiponumber | RequisitoObligatorio | Valores y límites Mínimo: 1.5 Máximo: 3 | Predeterminado— |
Campocreativity | Tipointeger | RequisitoObligatorio | Valores y límites 0, 1 | Predeterminado— |
| Parámetro | Contrato |
|---|---|
Parámetrocontent_type | Contratoapplication/json |
Parámetrorequired | Contratomodel, input_references, upscale_factor, creativity |
Parámetromaterial_types | Contratotext, image, audio, video |
Parámetromaterial_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
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.
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 →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_INPUT_REFERENCES_JSON:?Set the actual documented input value}"\nexport AILOOT_INPUT_REFERENCES_JSON\n: "${AILOOT_UPSCALE_FACTOR:?Set the actual documented input value}"\nexport AILOOT_UPSCALE_FACTOR\n: "${AILOOT_CREATIVITY:?Set the actual documented input value}"\nexport AILOOT_CREATIVITY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nrequest={'model': 'black-forest-labs/flux-video-upscale', 'input_references': '${ACTUAL_OWNED_INPUT_REFERENCES}', 'upscale_factor': '${ACTUAL_UPSCALE_FACTOR}', 'creativity': '${ACTUAL_CREATIVITY}'}\nrequest['input_references']=json.loads(os.environ['AILOOT_INPUT_REFERENCES_JSON'])\nrequest['upscale_factor']=float(os.environ['AILOOT_UPSCALE_FACTOR'])\nrequest['creativity']=int(os.environ['AILOOT_CREATIVITY'])\nPath('request.json').write_text(json.dumps(request,ensure_ascii=False),encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o response.bin\n# Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.\nGET /v1/videos/{request_id}GET /v1/videos/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif 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")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n 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")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nGuarda 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.
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.
| Campo | Tipo |
|---|---|
Campoid | Tipo |
Campostatus | Tipo |
Campodata[] | Tipo |
Campooutputs[] | Tipo |
Ailoot Ultra black-forest-labs/flux-video-upscale
Usa las rutas de método indicadas arriba.