Einführung
FLUX 3 Video-Upscale vergrößert einen fertigen Videoclip um das 1,5- bis 3-Fache. Es akzeptiert ein MP4 von bis zu 20 Sekunden, behält Seitenverhältnis und Originalton bei und bietet einen Modus precise, der der Quelle treu bleibt, sowie einen Modus creative, der feine Details neu aufbaut.
Den Modus nach dem Ausgangsmaterial wählen
| Was Sie haben | Modus |
|---|---|
| ein geschriebenes Briefing | FLUX 3 Text-zu-Video |
| ein Standbild zum Animieren, optional mit letztem Frame | FLUX 3 Bild-zu-Video |
| ein Clip zum Fortsetzen | FLUX 3 Video-Erweiterung |
| ein Clip zum Vergrößern | FLUX 3 Video-Upscale |
Wichtige Funktionen und Highlights
Precise und creative
Precise schärft nur: In unserem 2x-Test wurden Bartstoppeln, Haarkanten und Stofffalten klarer, ohne dass Details hinzuerfunden wurden. Creative baut zusätzlich feine Details neu auf, optional per Prompt gesteuert, und kostet mehr.
Preis nach Länge, nicht nach Faktor
Die Abrechnung folgt der Länge des Eingangs-Clips, auf ganze Sekunden aufgerundet. Eine Vergrößerung um 1,5x oder 3x kostet gleich viel.
Ton bleibt erhalten
Die ursprüngliche Tonspur bleibt beim vergrößerten Clip.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
video_url | Ja | Der Clip, der hochskaliert werden soll, ein MP4 von bis zu 20 Sekunden. Die Abrechnung folgt seiner Länge, auf ganze Sekunden aufgerundet. mindestens 1 Zeichen |
upscale_mode | Nein | precise (Standard) bleibt der Quelle treu und schärft sie; creative baut zusätzlich feine Details neu auf und kostet mehr. |
upscale_factor | Nein | Um das Wievielfache größer, von 1,5 bis 3; standardmäßig 2. Das Seitenverhältnis bleibt erhalten, und der Faktor ändert den Preis nicht. |
prompt | Nein | Optional und nur im Modus creative verwendet: die Details, die ergänzt werden sollen, etwa Hauttextur oder Gewebestruktur. Bis zu 5.000 Zeichen. mindestens 1 Zeichen · höchstens 5000 Zeichen |
Preis
Abrechnung je Sekunde des Eingangs-Clips, auf ganze Sekunden aufgerundet. Der Upscale-Faktor ändert den Preis nicht. Der Modus creative kostet mehr als precise. Abgelehnte und fehlgeschlagene Anfragen werden nicht berechnet.
| Spezifikation | Preis |
|---|---|
| $0.528 / Sekunde |
| $0.7584 / Sekunde |
Anwendungsfälle
Einen finalen Schnitt vorbereiten
Rendern und schneiden Sie in 720p und vergrößern Sie nur die Clips, die Sie behalten.
Einen Draft retten
Bringen Sie einen guten Clip aus der Draft-Stufe auf eine größere Größe.
Liefergrößen
Wählen Sie einen Faktor zwischen 1,5x und 3x passend zu Ihrer Ausgabe.
Prompt-Leitfaden und Praxistipps
Beginnen Sie mit precise
Der Modus lässt den Inhalt unberührt und ist der günstigere.
Nutzen Sie creative sparsam
Wählen Sie ihn nur, wenn das Material neu aufgebaute Details braucht, und beschreiben Sie im Prompt die gewünschte Textur.
Erwarten Sie nicht, dass fehlende Details zurückkehren
Kleine Elemente, die in der Quelle unscharf sind, bleiben unscharf.
Planen Sie Zeit ein
Unser 2x-Test mit einem Fünf-Sekunden-Clip dauerte etwa 17 Minuten.
Beachten Sie die Dateigröße
Ein 2x-Clip kam bei fünf Sekunden auf etwa 17 MB.
API-Schnellstart
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "black-forest-labs/flux-3/upscale",
"input": {
"upscale_mode": "precise",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Authentifizierung, vollständiges Schema, Polling und Fehlerbehandlung stehen in der API-Referenz.


























