Black Forest Labs: FLUX Video Upscale

FLUX Video Upscale agrandit un extrait existant par une amélioration des détails fidèle à la source ou créative. Son profil documenté propose une mise à l’échelle de 1.5× à 3×, préserve l’audio et le cadrage sources et limite la longueur source, la résolution d’entrée et la surface des images de sortie.

Ailoot Ultra · Vidéo POST /v1/videos black-forest-labs/flux-video-upscale

À propos du modèle

Cette description présente les capacités du modèle. Les entrées, sorties et options disponibles dans Ailoot pour la méthode sélectionnée figurent ci-dessous.

FLUX Video Upscale est le processus de super-résolution vidéo de Black Forest Labs propulsé par FLUX 3. Il reçoit un extrait existant et renvoie un MP4 agrandi, avec le cadrage et l’audio sources conservés dans le résultat. Une courte description facultative peut guider les détails visuels améliorés. Ses deux modes offrent un choix important entre rester proche de l’apparence fournie et générer des détails plus prononcés, plutôt que de traiter toute image plus grande comme une reconstruction également fidèle.

Choisir une amélioration précise ou créative

Le réglage creativity choisit le mode. Une valeur de 0 correspond au profil précis et fidèle à la source : le fabricant le recommande lorsqu’un visage, un produit ou un élément de marque doit conserver son identité. Une valeur de 1 active l’amélioration créative des détails et constitue le réglage par défaut. Elle peut restaurer ou inventer de la texture plus fortement, ce qui convient aux séquences générées, aux paysages, aux foules ou aux surfaces dont les détails peuvent être développés créativement.

Le fabricant avertit explicitement que l’amélioration créative ne préserve pas aussi strictement les visages et les produits. Vérifiez la caractéristique qui doit rester identifiable : l’apparence faciale, le contour d’un produit, le lettrage, le motif d’un matériau ou un logo. Un visuel paraissant plus net peut néanmoins contenir un détail modifié ou nouvellement inventé. Pour une démonstration produit, utilisez l’apparence produit visée comme critère de vérification, plutôt que de choisir une version uniquement parce que sa texture est plus élaborée.

Le prompt facultatif décrit le contenu de l’extrait pour guider l’amélioration ; une description vide demande un agrandissement neutre. Un cahier des charges original de scène générée pourrait identifier un mur de pierre couvert de mousse, une lumière du jour douce et une fine texture de feuilles. Gardez la formulation centrée sur le matériau à affiner. Une demande de remplacement d’objet, de reconstruction du décor ou de changement de dialogue relève d’une décision de modification, tandis que ce profil conserve la piste audio source.

Échelle et surface des images de sortie

Le réglage upscale_factor documenté va de 1.5 à 3, avec 2 par défaut. Il agrandit la résolution source en préservant le rapport d’aspect. Le facteur choisi et les dimensions d’entrée déterminent la sortie visée ; un extrait paysage et une composition portrait doivent donc être planifiés à partir de leurs images réelles. Préparez la taille d’affichage cible avant de choisir l’agrandissement utile.

La spécification exacte plafonne chaque image de sortie à 13,75 unités de mégapixels du fabricant. Sa documentation définit une unité comme 1 048 576 pixels, donnant un plafond de 14 417 920 pixels, soit environ 14,4 millions. Cela explique la formulation arrondie de 14,4 mégapixels du guide. Une grande source peut donc recevoir un agrandissement inférieur au facteur demandé. Vérifiez les dimensions fournies, plutôt que de supposer qu’une demande 3× produit toujours trois fois chaque dimension source.

Le plafond publié de résolution source est de 2560×1440. Ce processus augmente une source admissible vers la 4K et au-delà ; il n’accepte pas une source déjà plus grande simplement parce qu’une sortie supérieure est souhaitée. Réduisez la taille ou préparez une copie de travail adaptée avant d’utiliser ce profil documenté. Gardez l’enregistrement d’origine séparément afin que la comparaison finale ne soit pas limitée à un intermédiaire redimensionné.

Préparer une source courte et lisible

Les recommandations ordinaires de préparation du fabricant limitent les sources à vingt secondes et cinquante MB. Un extrait est fourni par une URL vidéo ou un MP4 encodé. Sa référence exacte précise que le traitement couvre les vingt premières secondes : un léger dépassement de longueur peut être traité seulement jusqu’à cette marque, tandis qu’un extrait nettement plus long est rejeté. Aucune tolérance numérique n’est publiée. Découpez le segment visé à vingt secondes ou moins, plutôt que de compter sur ce comportement de limite non précisé.

Choisissez la version la moins compressée disponible. Les artefacts de compression limitent la quantité de détails réels récupérables par l’agrandisseur, et l’amélioration créative peut produire une texture plausible sans établir ce que contenait la scène d’origine. Terminez le montage et le découpage visés avant d’agrandir l’extrait choisi. Un processus original pourrait d’abord terminer un plan produit, choisir l’intervalle d’action utile, puis agrandir cette sélection finale, en conservant la source non modifiée pour comparaison.

Le résultat garde la piste audio source. Examinez sa synchronisation avec l’image, particulièrement au début et à la fin d’un segment choisi. Le profil documenté ne fournit pas de sélecteur indépendant de fréquence d’images, de génération de nouveau dialogue ou de commandes de modification par référence image. Son objectif est une vidéo plus grande et le traitement choisi des détails, avec les matériaux temporels et sonores de la source conservés dans le segment traité.

Conserver et vérifier l’extrait fourni

Le processus du producteur est asynchrone : une tâche soumise fournit une identité et un emplacement de statut, et son résultat terminé contient un lien signé de fourniture MP4. Ce lien expire après environ une heure. Conservez l’extrait réel, la source, le facteur choisi, le mode creativity et la description du contenu, plutôt que de compter sur l’emplacement temporaire. Gardez les statuts d’échec ou de modération distincts d’une vidéo terminée.

Vérifiez des images individuelles pour les visages, les inscriptions et les changements de surfaces, puis regardez la séquence pour la continuité, le mouvement et l’alignement audio. Les sorties précises et créatives répondent à des exigences visuelles différentes ; l’artefact utile est l’extrait agrandi respectant l’objectif de fidélité choisi à la taille d’affichage visée. Une résolution supérieure n’est pas à elle seule la preuve que l’identité, les mots ou les détails fins d’origine sont restés corrects.

Ailoot Ultra · Vidéo POST /v1/videos black-forest-labs/flux-video-upscale

black-forest-labs/flux-video-upscale

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

Premiers pas

Entrées acceptées: Texte · Images · Audio · Vidéo
Résultats: Vidéo

Disponible dans Ailoot · entrées et méthodes

Ailoot Ultra · Vidéo POST /v1/videos

Entrée: text, image, audio, video
Sortie: video

Champ	Type	Exigence	Valeurs et limites	Par défaut
Champ`model`	Type`string`	ExigenceObligatoire	Valeurs et limites black-forest-labs/flux-video-upscale	Par défaut—
Champ`input_references`	Type`array`	ExigenceObligatoire	Valeurs et limites Nombre minimal d’éléments: 1 Nombre maximal d’éléments: 1	Par défaut—
Champ`upscale_factor`	Type`number`	ExigenceObligatoire	Valeurs et limites Minimum: 1.5 Maximum: 3	Par défaut—
Champ`creativity`	Type`integer`	ExigenceObligatoire	Valeurs et limites 0, 1	Par défaut—

Paramètres et cycle de vie de la méthode

Paramètre	Contrat
Paramètre`content_type`	Contratapplication/json
Paramètre`required`	Contratmodel, input_references, upscale_factor, creativity
Paramètre`material_types`	Contrattext, image, audio, video
Paramètre`material_conditions`	ContratUtilisez exactement une URL réelle de contenu d’une ressource vidéo terminée dont vous êtes propriétaire, avec la signature renvoyée. Le propriétaire, le type et l’attestation des octets enregistrés de la ressource doivent correspondre à la requête.

Cycle de vie : asynchronous_job_then_owned_outputs

GET /v1/videos/{request_id} · valeur id ou polling_url effectivement renvoyée

GET /v1/videos/{request_id}/content

Tarifs

Calcul du coût final

Les tarifs affichés servent à estimer le coût avant la génération. Le montant final est calculé à partir du coût enregistré pour la génération d’origine. La durée mesurée du résultat et les quantités prévisionnelles ne constituent pas la quantité finale facturable.

Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée.

Mode rapide: Non précisé Lorsque le mode rapide est sélectionné
Mode Flex: Non précisé Lorsque le mode flex est sélectionné
Effort de raisonnement maximal: Non précisé Lorsque l’effort de raisonnement maximal utilise l’ajustement par défaut (default)

Tarifs estimés à des fins de comparaison

Prix par configuration

Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.

Configuration	Barème tarifaire	Quantité prévisionnelle	Unité de facturation	Conditions de facturation	Pixels par mégapixel	Coût
ConfigurationTarifs de base des jetons	Barème tarifaireTarif de base	Quantité prévisionnelle—	Unité de facturation—	Conditions de facturation—	Pixels par mégapixel—	Coût Entrée · Tokens en entrée · Estimation à des fins de comparaison uniquement — / 1K tokens Sortie · Tokens en sortie · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Lecture du cache · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Écriture dans le cache · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Écriture dans le cache, 1 h · Estimation à des fins de comparaison uniquement — / 1K tokens
ConfigurationTarif vidéo	Barème tarifaire—	Quantité prévisionnelle—	Unité de facturationpar mégapixel-seconde	Conditions de facturationqualité : creative	Pixels par mégapixel1'048'576	Coût Sortie · Tarif vidéo · Estimation à des fins de comparaison uniquement $0.21 par mégapixel-seconde
ConfigurationTarif vidéo	Barème tarifaire—	Quantité prévisionnelle—	Unité de facturationpar mégapixel-seconde	Conditions de facturationquality: precise	Pixels par mégapixel1'048'576	Coût Sortie · Tarif vidéo · Estimation à des fins de comparaison uniquement $0.15 par mégapixel-seconde
ConfigurationCoût estimé de la génération	Barème tarifaire—	Quantité prévisionnelleEstimation pour une génération	Unité de facturation—	Conditions de facturation—	Pixels par mégapixel—	Coût Sortie · Coût estimé de génération · Estimation à des fins de comparaison uniquement $0.15 estimation avant génération Cette estimation ne constitue ni des frais supplémentaires ni un tarif fixe pour la génération terminée.

Ailoot réserve un montant estimé avant une requête. Après le résultat, le montant final est débité selon l’utilisation mesurée. Pour le streaming, le montant final à débiter est calculé à partir du relevé final d’utilisation. Fonctionnement de la réservation et du débit →

Exemples de requêtes

Ailoot Ultra · Vidéo

Utilisez les données d’entrée réelles et conservez le résultat complet

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.

Recevoir et enregistrer les résultats

Ailoot Ultra · Vidéo

GET /v1/videos/{request_id}
GET /v1/videos/{request_id}/content

Enregistrer toutes les ressources terminées

GET toutes les ressources terminées

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

Conserver tous les résultats terminés

Enregistrez chaque vidéo terminée ou fichier renvoyé ; récupérez chaque URL de ressource effectivement renvoyée.

Conservez la réponse complète et les en-têtes, chaque sortie effective, les identifiants initialement renvoyés et tous les champs d’utilisation. Récupérez l’opération d’origine sans soumettre à nouveau sa création.

Si la réponse d’origine doit être vérifiée

Conservez X-Client-Request-ID, X-Ailoot-Task-Id et les valeurs id/polling_url effectivement renvoyées. Poursuivez la tâche d’origine ; ne renvoyez pas de demande de création.

Champs de la réponse

Champ	Type
Champ`id`	Type
Champ`status`	Type
Champ`data[]`	Type
Champ`outputs[]`	Type

Alias

Alias du modèle

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

Alias des chemins de méthode

Utilisez les chemins de méthode indiqués ci-dessus.

ID d’appel associés

black-forest-labs/flux-video-upscale

FAQ · Black Forest Labs: FLUX Video Upscale

Quelles entrées et quels résultats sont disponibles ?: POST /v1/videos · black-forest-labs/flux-video-upscale: text, image, audio, video → video
Quels champs la requête utilise-t-elle ?: POST /v1/videos · black-forest-labs/flux-video-upscale: model, input_references, upscale_factor, creativity
Quelles limites s’appliquent ?: POST /v1/videos · black-forest-labs/flux-video-upscale: upscale_factor.minimum: 1.5; upscale_factor.maximum: 3

Black Forest Labs: FLUX Video Upscale