Black Forest Labs: FLUX Video Upscale
FLUX Video Upscale vergrössert einen vorhandenen Clip durch quellentreue oder kreative Detailverbesserung. Sein dokumentiertes Profil bietet 1,5×–3× Skalierung, bewahrt Quellaudio und Bildausschnitt und begrenzt Quelllänge, Eingabeauflösung und Ausgabebildfläche.
Über das Modell
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
FLUX Video Upscale ist der auf FLUX 3 basierende Video-Superresolution-Workflow von Black Forest Labs. Er empfängt einen vorhandenen Clip und liefert ein vergrössertes MP4, wobei Bildausschnitt und Audio der Quelle in das Ergebnis übernommen werden. Eine kurze optionale Beschreibung kann die verbesserten visuellen Details steuern. Seine zwei Modi ermöglichen eine sinnvolle Wahl zwischen Nähe zum bereitgestellten Erscheinungsbild und stärkerer Detailgenerierung, statt jedes grössere Bild als gleichermassen originalgetreue Rekonstruktion zu behandeln.
Präzise oder kreative Verbesserung wählen
Die Einstellung creativity wählt den Modus. Ein Wert von 0 steht für das präzise, quellentreue Profil: Der Hersteller empfiehlt es, wenn ein Gesicht, Produkt oder Markenelement seine Identität behalten muss. Ein Wert von 1 aktiviert kreative Detailverbesserung und ist die Standardeinstellung. Sie kann Textur stärker wiederherstellen oder erfinden, was für generiertes Material, Landschaften, Menschenmengen oder Oberflächen nützlich ist, deren Details kreativ entwickelt werden können.
Der Hersteller warnt ausdrücklich, dass kreative Verbesserung Gesichter und Produkte weniger strikt bewahrt. Prüfen Sie das Merkmal, das erkennbar bleiben muss: Gesichtsausdruck und Erscheinungsbild, Produktumriss, Beschriftung, Materialmuster oder Logo. Eine schärfer wirkende Darstellung kann dennoch veränderte oder neu erfundene Details enthalten. Verwenden Sie für eine Produktdemonstration das vorgesehene Produktaussehen als Prüfkriterium, statt eine Version nur wegen aufwendigerer Textur zu wählen.
Der optionale Prompt beschreibt den Clipinhalt zur Steuerung der Verbesserung; eine leere Beschreibung fordert neutrales Upscaling an. Ein eigenes Briefing für eine generierte Szene könnte eine moosbewachsene Steinwand, weiches Tageslicht und feine Blatttextur benennen. Konzentrieren Sie den Wortlaut auf das zu verfeinernde Material. Die Aufforderung, ein Objekt zu ersetzen, die Umgebung neu aufzubauen oder Dialog zu ändern, gehört zu einer Bearbeitungsentscheidung; dieses Profil behält dagegen die Quelltonspur bei.
Skalierung und Ausgabebildfläche
Der dokumentierte upscale_factor reicht von 1.5 bis 3 mit 2 als Standard. Er vergrössert die Quellauflösung unter Beibehaltung des Seitenverhältnisses. Gewählter Faktor und Eingabeabmessungen bestimmen die vorgesehene Ausgabe; ein Querformatclip und eine Hochformatkomposition müssen daher anhand ihrer tatsächlichen Bilder geplant werden. Bereiten Sie die gewünschte Darstellungsgrösse vor, bevor Sie das nützliche Mass der Vergrösserung wählen.
Die genaue Spezifikation begrenzt jedes Ausgabebild auf 13,75 Megapixeleinheiten nach Herstellerdefinition. Seine Dokumentation definiert eine solche Einheit als 1’048’576 Pixel, woraus eine Obergrenze von 14’417’920 Pixeln, ungefähr 14,4 Millionen, folgt. Das erklärt die gerundete Angabe von 14,4 Megapixeln im Leitfaden. Eine grosse Quelle kann deshalb weniger als um den angeforderten Faktor vergrössert werden. Prüfen Sie die gelieferten Abmessungen, statt anzunehmen, dass eine 3×-Anfrage jede Quellabmessung immer verdreifacht.
Die veröffentlichte Obergrenze der Quellauflösung beträgt 2560×1440. Dieser Workflow vergrössert eine geeignete Quelle in Richtung 4K und darüber hinaus; er akzeptiert keine bereits grössere Quelle allein deshalb, weil eine höhere Ausgabe gewünscht ist. Verkleinern Sie die Quelle oder bereiten Sie eine geeignete Arbeitskopie vor, bevor Sie dieses dokumentierte Profil verwenden. Bewahren Sie die Originalaufnahme separat auf, damit der abschliessende Vergleich nicht auf ein skaliertes Zwischenergebnis beschränkt ist.
Eine kurze, gut erkennbare Quelle vorbereiten
Die üblichen Vorbereitungsrichtlinien des Herstellers begrenzen Quellen auf zwanzig Sekunden und fünfzig MB. Ein Clip wird per Video-URL oder kodiertem MP4 bereitgestellt. Die genaue Referenzdokumentation merkt an, dass die Verarbeitung die ersten zwanzig Sekunden umfasst: Eine geringe Längenüberschreitung kann nur bis zu dieser Marke verarbeitet werden, während ein wesentlich längerer Clip abgelehnt wird. Eine numerische Toleranz ist nicht veröffentlicht. Schneiden Sie auf das vorgesehene Segment von zwanzig Sekunden oder weniger zu, statt sich auf dieses nicht näher bestimmte Grenzverhalten zu verlassen.
Wählen Sie die am wenigsten komprimierte verfügbare Version. Kompressionsartefakte begrenzen die Menge echter Details, die der Upscaler wiederherstellen kann; kreative Verbesserung kann plausible Textur erzeugen, ohne festzustellen, was die ursprüngliche Szene enthielt. Schliessen Sie den vorgesehenen Schnitt und Zuschnitt ab, bevor Sie den ausgewählten Clip vergrössern. Ein eigener Workflow könnte zuerst eine Produktaufnahme fertigstellen, den nützlichen Handlungsabschnitt auswählen und anschliessend diese endgültige Auswahl hochskalieren, mit unveränderter Quelle zum Vergleich.
Das Ergebnis behält die Quelltonspur bei. Prüfen Sie ihre zeitliche Abstimmung mit dem Bild, besonders am Anfang und Ende eines ausgewählten Segments. Das dokumentierte Profil bietet keine unabhängige Auswahl der Bildrate, neue Dialoggenerierung oder Bearbeitungssteuerung mit Bildreferenzen. Sein Zweck ist das grössere Video und die gewählte Detailbehandlung, mit erhaltenem zeitlichem und klanglichem Quellmaterial innerhalb des verarbeiteten Segments.
Den gelieferten Clip aufbewahren und prüfen
Der Herstellerworkflow ist asynchron: Eine eingereichte Aufgabe liefert eine Kennung und eine Statusadresse; ihr fertiges Ergebnis enthält einen signierten MP4-Auslieferungslink. Dieser Link läuft nach ungefähr einer Stunde ab. Bewahren Sie den tatsächlichen Clip, die Quelle, den gewählten Faktor, den Kreativitätsmodus und die Inhaltsbeschreibung auf, statt sich auf die vorübergehende Adresse zu verlassen. Unterscheiden Sie einen fehlgeschlagenen oder moderierten Status von einem fertigen Video.
Prüfen Sie Einzelbilder auf Gesichter, Markierungen und Oberflächenänderungen und sehen Sie anschliessend die Abfolge auf Kontinuität, Bewegung und Audioausrichtung durch. Präzise und kreative Ausgaben erfüllen unterschiedliche visuelle Anforderungen; das nützliche Ergebnis ist der vergrösserte Clip, der das gewählte Ziel der Quellentreue bei der vorgesehenen Darstellungsgrösse erfüllt. Eine höhere Auflösung allein belegt nicht, dass ursprüngliche Identität, Wortlaut oder feine Details korrekt erhalten geblieben sind.
Ailoot Ultra · Videoerzeugung POST /v1/videos black-forest-labs/flux-video-upscale
black-forest-labs/flux-video-upscale
black-forest-labs/flux-video-upscaleEinstieg
FLUX Video Upscale vergrössert einen vorhandenen Clip durch quellentreue oder kreative Detailverbesserung. Sein dokumentiertes Profil bietet 1,5×–3× Skalierung, bewahrt Quellaudio und Bildausschnitt und begrenzt Quelllänge, Eingabeauflösung und Ausgabebildfläche.
- Zulässige Eingaben
- Text · Bilder · Audio · Video
- Ergebnisse
- Video
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Videoerzeugung POST /v1/videos
- Eingabe
text,image,audio,video- Ausgabe
video
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits black-forest-labs/flux-video-upscale | Standard— |
Feldinput_references | Typarray | AnforderungErforderlich | Werte und Limits Mindestanzahl Elemente: 1 Maximale Anzahl Elemente: 1 | Standard— |
Feldupscale_factor | Typnumber | AnforderungErforderlich | Werte und Limits Minimum: 1.5 Maximum: 3 | Standard— |
Feldcreativity | Typinteger | AnforderungErforderlich | Werte und Limits 0, 1 | Standard— |
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, input_references, upscale_factor, creativity |
Parametermaterial_types | Vertragtext, image, audio, video |
Parametermaterial_conditions | VertragVerwenden Sie genau eine tatsächliche Inhalts-URL eines fertiggestellten, Ihnen zugeordneten Videoassets mit dessen zurückgegebener Signatur. Eigentümer, Typ und gespeicherter Bytenachweis des Assets müssen zur Anfrage passen. |
Lebenszyklus: asynchronous_job_then_owned_outputs
GET /v1/videos/{request_id} · Tatsächlich zurückgegebene id oder polling_url
GET /v1/videos/{request_id}/content
Tarife
So wird die endgültige Gebühr berechnet
Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
- Schnellmodus
- Nicht angegeben Wenn der Schnellmodus ausgewählt ist
- Flex-Modus
- Nicht angegeben Wenn der Modus flex ausgewählt ist
- Maximaler Denkaufwand
- Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird
Geschätzte Tarife zum Vergleich
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Tarifstaffel | Prognostizierte Menge | Abrechnungseinheit | Abrechnungsbedingungen | Pixel pro Megapixel | Gebühr |
|---|---|---|---|---|---|---|
| KonfigurationToken-Basistarife | TarifstaffelGrundtarif | Prognostizierte Menge— | Abrechnungseinheit— | Abrechnungsbedingungen— | Pixel pro Megapixel— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Tokens Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache lesen · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache schreiben · Schätzung nur zum Vergleich — / 1K Tokens Eingabe · Cache schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Tokens |
| KonfigurationVideopreis | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Megapixel-Sekunde | AbrechnungsbedingungenQualität: creative | Pixel pro Megapixel1'048'576 | Gebühr Ausgabe · Videopreis · Schätzung nur zum Vergleich $0.21 pro Megapixel-Sekunde |
| KonfigurationVideopreis | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Megapixel-Sekunde | Abrechnungsbedingungenquality: precise | Pixel pro Megapixel1'048'576 | Gebühr Ausgabe · Videopreis · Schätzung nur zum Vergleich $0.15 pro Megapixel-Sekunde |
| KonfigurationGeschätzte Erzeugungskosten | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Abrechnungseinheit— | Abrechnungsbedingungen— | Pixel pro Megapixel— | Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.15 Schätzung vor der Generierung Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung. |
Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschliessenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Beispielanfragen
Ailoot Ultra · Videoerzeugung
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.
Ergebnisse abrufen und speichern
Ailoot Ultra · Videoerzeugung
GET /v1/videos/{request_id}GET /v1/videos/{request_id}/content
Alle fertiggestellten Dateien speichern
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
Alle fertiggestellten Ergebnisse aufbewahren
Speichern Sie jedes fertiggestellte Video oder jede zurückgegebene Datei; rufen Sie jede tatsächlich zurückgegebene Datei-URL ab.
Die vollständige Antwort und ihre Header, jede tatsächliche Ausgabe, die ursprünglich zurückgegebenen Kennungen und alle Nutzungsfelder aufbewahren. Den ursprünglichen Vorgang wiederaufnehmen, ohne die Erstellung erneut anzufordern.
Wenn die ursprüngliche Antwort geprüft werden muss
Bewahren Sie X-Client-Request-ID, X-Ailoot-Task-Id und die tatsächlich zurückgegebene id/polling_url auf. Setzen Sie den ursprünglichen Auftrag fort; reichen Sie die Erstellung nicht erneut ein.
Antwortfelder
| Feld | Typ |
|---|---|
Feldid | Typ |
Feldstatus | Typ |
Felddata[] | Typ |
Feldoutputs[] | Typ |
Aliasnamen
Modellaliasnamen
Ailoot Ultra black-forest-labs/flux-video-upscale
Aliasnamen für Methodenpfade
Verwenden Sie die oben angezeigten Methodenpfade.
Zugehörige Aufrufer-IDs
FAQ · Black Forest Labs: FLUX Video Upscale
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/videos·black-forest-labs/flux-video-upscale:text,image,audio,video→video- Welche Felder verwendet die Anfrage?
POST /v1/videos·black-forest-labs/flux-video-upscale:model,input_references,upscale_factor,creativity- Welche Grenzen gelten?
POST /v1/videos·black-forest-labs/flux-video-upscale:upscale_factor.minimum:1.5;upscale_factor.maximum:3