Black Forest Labs: FLUX Video Upscale

Το FLUX Video Upscale μεγεθύνει υπάρχον απόσπασμα με πιστή στην πηγή ή δημιουργική ενίσχυση λεπτομέρειας. Το τεκμηριωμένο προφίλ του προσφέρει κλιμάκωση 1.5×–3×, διατηρεί τον αρχικό ήχο και το κάδρο και περιορίζει τη διάρκεια πηγής, την ανάλυση εισόδου και την επιφάνεια καρέ εξόδου.

Ailoot Ultra · Βίντεο POST /v1/videos black-forest-labs/flux-video-upscale

Σχετικά με το μοντέλο

Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.

Το FLUX Video Upscale είναι η ροή υπερανάλυσης βίντεο της Black Forest Labs που βασίζεται στο FLUX 3. Δέχεται υπάρχον απόσπασμα και επιστρέφει μεγεθυμένο MP4, με το αρχικό κάδρο και τον ήχο να μεταφέρονται στο αποτέλεσμα. Μια σύντομη προαιρετική περιγραφή μπορεί να κατευθύνει την ενισχυμένη οπτική λεπτομέρεια. Οι δύο λειτουργίες του επιτρέπουν ουσιαστική επιλογή μεταξύ διατήρησης της παρεχόμενης εμφάνισης και παραγωγής πιο επιθετικής λεπτομέρειας, αντί να αντιμετωπίζουν κάθε μεγαλύτερη εικόνα ως εξίσου πιστή ανακατασκευή.

Επιλογή ακριβούς ή δημιουργικής ενίσχυσης

Η ρύθμιση δημιουργικότητας επιλέγει τη λειτουργία. Η τιμή 0 είναι το ακριβές, πιστό στην πηγή προφίλ: ο κατασκευαστής το συνιστά όταν ένα πρόσωπο, προϊόν ή στοιχείο επωνυμίας πρέπει να διατηρεί την ταυτότητά του. Η τιμή 1 ενεργοποιεί δημιουργική ενίσχυση λεπτομέρειας και είναι η προεπιλογή. Μπορεί να αποκαθιστά ή να επινοεί υφή πιο επιθετικά, κάτι χρήσιμο για παραγόμενο υλικό, τοπία, πλήθη ή επιφάνειες των οποίων η λεπτομέρεια μπορεί να αναπτυχθεί δημιουργικά.

Ο κατασκευαστής προειδοποιεί ρητά ότι η δημιουργική ενίσχυση δεν διατηρεί πρόσωπα και προϊόντα το ίδιο αυστηρά. Ελέγξτε το χαρακτηριστικό που πρέπει να παραμένει αναγνωρίσιμο: εμφάνιση προσώπου, περίγραμμα προϊόντος, γράμματα, μοτίβο υλικού ή λογότυπο. Ένα οπτικό αποτέλεσμα που φαίνεται ευκρινέστερο μπορεί ακόμη να περιέχει αλλαγμένη ή νεοεπινοημένη λεπτομέρεια. Για επίδειξη προϊόντος, χρησιμοποιήστε την επιδιωκόμενη εμφάνιση προϊόντος ως κριτήριο ελέγχου αντί να επιλέγετε έκδοση μόνο επειδή η υφή της είναι πιο περίτεχνη.

Η προαιρετική προτροπή περιγράφει το περιεχόμενο του αποσπάσματος για να καθοδηγήσει την ενίσχυση· μια κενή περιγραφή ζητά ουδέτερη μεγέθυνση. Μια πρωτότυπη οδηγία παραγόμενης σκηνής θα μπορούσε να προσδιορίζει πέτρινο τοίχο καλυμμένο με βρύα, απαλό φως ημέρας και λεπτή υφή φύλλων. Διατηρήστε τη διατύπωση γύρω από το υλικό που πρέπει να βελτιωθεί. Ένα αίτημα αντικατάστασης αντικειμένου, ανακατασκευής σκηνικού ή αλλαγής διαλόγου ανήκει σε απόφαση επεξεργασίας, ενώ αυτό το προφίλ διατηρεί το αρχικό ηχητικό κομμάτι.

Κλίμακα και επιφάνεια καρέ εξόδου

Το τεκμηριωμένο upscale_factor κυμαίνεται από 1.5 έως 3, με προεπιλογή 2. Μεγεθύνει την αρχική ανάλυση διατηρώντας την αναλογία διαστάσεων. Ο επιλεγμένος συντελεστής και οι διαστάσεις εισόδου καθορίζουν την επιδιωκόμενη έξοδο, επομένως ένα οριζόντιο απόσπασμα και μια κατακόρυφη σύνθεση πρέπει να σχεδιάζονται από τα πραγματικά τους καρέ. Προετοιμάστε το μέγεθος προβολής-στόχο πριν επιλέξετε πόση μεγέθυνση είναι χρήσιμη.

Η ακριβής προδιαγραφή περιορίζει κάθε καρέ εξόδου σε 13,75 μονάδες megapixel του κατασκευαστή. Η τεκμηρίωσή του ορίζει μία τέτοια μονάδα ως 1.048.576 pixel, δίνοντας ανώτατο όριο 14.417.920 pixel, περίπου 14,4 εκατομμύρια. Αυτό εξηγεί τη στρογγυλοποιημένη διατύπωση 14,4 megapixel στον οδηγό. Επομένως, μια μεγάλη πηγή μπορεί να λάβει μικρότερη μεγέθυνση από τον ζητούμενο συντελεστή. Ελέγξτε τις παραδοθείσες διαστάσεις αντί να υποθέτετε ότι ένα αίτημα 3× παράγει πάντα τριπλάσια κάθε διάσταση της πηγής.

Το δημοσιευμένο ανώτατο όριο ανάλυσης πηγής είναι 2560×1440. Αυτή η ροή αυξάνει μια επιλέξιμη πηγή προς το 4K και πέρα από αυτό· δεν δέχεται ήδη μεγαλύτερη πηγή μόνο επειδή επιθυμείται υψηλότερη έξοδος. Μειώστε την ανάλυση ή προετοιμάστε κατάλληλο αντίγραφο εργασίας πριν χρησιμοποιήσετε αυτό το τεκμηριωμένο προφίλ. Διατηρήστε ξεχωριστά την αρχική εγγραφή, ώστε η τελική σύγκριση να μην περιορίζεται σε ενδιάμεσο αρχείο αλλαγμένου μεγέθους.

Προετοιμασία σύντομης, ευανάγνωστης πηγής

Οι συνήθεις οδηγίες προετοιμασίας του κατασκευαστή περιορίζουν τις πηγές σε είκοσι δευτερόλεπτα και πενήντα MB. Ένα απόσπασμα παρέχεται μέσω URL βίντεο ή κωδικοποιημένου MP4. Η ακριβής αναφορά σημειώνει ότι η επεξεργασία καλύπτει τα πρώτα είκοσι δευτερόλεπτα: μια μικρή υπέρβαση διάρκειας μπορεί να υποβληθεί σε επεξεργασία μόνο μέχρι εκεί, ενώ ένα σημαντικά μεγαλύτερο απόσπασμα απορρίπτεται. Δεν δημοσιεύεται αριθμητική ανοχή. Περικόψτε στο επιδιωκόμενο τμήμα έως είκοσι δευτερολέπτων, αντί να βασίζεστε σε αυτή την απροσδιόριστη συμπεριφορά ορίου.

Επιλέξτε την έκδοση με τη μικρότερη διαθέσιμη συμπίεση. Τα τεχνουργήματα συμπίεσης περιορίζουν την πραγματική λεπτομέρεια που μπορεί να ανακτήσει το εργαλείο μεγέθυνσης, ενώ η δημιουργική ενίσχυση μπορεί να δημιουργήσει εύλογη υφή χωρίς να τεκμηριώνει τι περιείχε η αρχική σκηνή. Ολοκληρώστε την επιδιωκόμενη επεξεργασία και περικοπή πριν μεγεθύνετε το επιλεγμένο απόσπασμα. Μια πρωτότυπη ροή θα μπορούσε πρώτα να ολοκληρώνει ένα πλάνο προϊόντος, να επιλέγει το χρήσιμο διάστημα δράσης και έπειτα να μεγεθύνει αυτή την τελική επιλογή, διατηρώντας την αμετάβλητη πηγή για σύγκριση.

Το αποτέλεσμα διατηρεί το αρχικό ηχητικό κομμάτι. Επιθεωρήστε τον χρονισμό του με την εικόνα, ιδιαίτερα στην αρχή και στο τέλος επιλεγμένου τμήματος. Το τεκμηριωμένο προφίλ δεν παρέχει ανεξάρτητο επιλογέα ρυθμού καρέ, παραγωγή νέου διαλόγου ή χειριστήρια επεξεργασίας με αναφορά εικόνας. Σκοπός του είναι το μεγαλύτερο βίντεο και η επιλεγμένη απόδοση λεπτομέρειας, με το χρονικό και ηχητικό υλικό της πηγής διατηρημένο εντός του επεξεργασμένου τμήματος.

Διατήρηση και έλεγχος του παραδοθέντος αποσπάσματος

Η ροή του κατασκευαστή είναι ασύγχρονη: μια υποβληθείσα εργασία παρέχει ταυτότητα και θέση κατάστασης και το ολοκληρωμένο αποτέλεσμά της περιέχει υπογεγραμμένο σύνδεσμο παράδοσης MP4. Ο σύνδεσμος λήγει έπειτα από περίπου μία ώρα. Διατηρήστε το πραγματικό απόσπασμα, την πηγή, τον επιλεγμένο συντελεστή, τη λειτουργία δημιουργικότητας και την περιγραφή περιεχομένου, αντί να βασίζεστε στην προσωρινή θέση. Διακρίνετε την κατάσταση αποτυχίας ή ελέγχου περιεχομένου από ένα ολοκληρωμένο βίντεο.

Ελέγξτε μεμονωμένα καρέ για πρόσωπα, σημάνσεις και αλλαγές επιφανειών και έπειτα παρακολουθήστε την ακολουθία για συνέχεια, κίνηση και ευθυγράμμιση ήχου. Οι ακριβείς και οι δημιουργικές έξοδοι απαντούν σε διαφορετικές οπτικές απαιτήσεις· το χρήσιμο τεχνούργημα είναι το μεγεθυμένο απόσπασμα που καλύπτει τον επιλεγμένο στόχο πιστότητας στο επιδιωκόμενο μέγεθος προβολής. Η μεγαλύτερη ανάλυση από μόνη της δεν αποδεικνύει ότι η αρχική ταυτότητα, διατύπωση ή λεπτή λεπτομέρεια παρέμεινε σωστή.

Ailoot Ultra · Βίντεο POST /v1/videos black-forest-labs/flux-video-upscale

black-forest-labs/flux-video-upscale

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

Εισαγωγή

Αποδεκτές είσοδοι: Κείμενο · Εικόνες · Ήχος · Βίντεο
Αποτελέσματα: Βίντεο

Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι

Ailoot Ultra · Βίντεο POST /v1/videos

Είσοδος: text, image, audio, video
Έξοδος: video

Πεδίο	Τύπος	Απαίτηση	Τιμές και όρια	Προεπιλογή
Πεδίο`model`	Τύπος`string`	ΑπαίτησηΥποχρεωτικό	Τιμές και όρια black-forest-labs/flux-video-upscale	Προεπιλογή—
Πεδίο`input_references`	Τύπος`array`	ΑπαίτησηΥποχρεωτικό	Τιμές και όρια Ελάχιστο πλήθος στοιχείων: 1 Μέγιστο πλήθος στοιχείων: 1	Προεπιλογή—
Πεδίο`upscale_factor`	Τύπος`number`	ΑπαίτησηΥποχρεωτικό	Τιμές και όρια Ελάχιστο: 1,5 Μέγιστο: 3	Προεπιλογή—
Πεδίο`creativity`	Τύπος`integer`	ΑπαίτησηΥποχρεωτικό	Τιμές και όρια 0, 1	Προεπιλογή—

Παράμετροι και κύκλος ζωής μεθόδου

Παράμετρος	Σύμβαση
Παράμετρος`content_type`	Σύμβασηapplication/json
Παράμετρος`required`	Σύμβασηmodel, input_references, upscale_factor, creativity
Παράμετρος`material_types`	Σύμβασηtext, image, audio, video
Παράμετρος`material_conditions`	ΣύμβασηΧρησιμοποιήστε ακριβώς ένα πραγματικό URL περιεχομένου ολοκληρωμένου αρχείου βίντεο που σας ανήκει, με την υπογραφή που επιστρέφεται. Ο ιδιοκτήτης, ο τύπος και το αποθηκευμένο τεκμήριο byte του αρχείου πρέπει να αντιστοιχούν στο αίτημα.

Κύκλος ζωής: asynchronous_job_then_owned_outputs

GET /v1/videos/{request_id} · πραγματικό id ή polling_url που επιστρέφεται

GET /v1/videos/{request_id}/content

Τιμολόγηση

Πώς υπολογίζεται η τελική χρέωση

Οι εμφανιζόμενες τιμές χρησιμοποιούνται για την εκτίμηση του κόστους πριν από την παραγωγή. Η τελική χρέωση υπολογίζεται από το κόστος που καταγράφηκε για την αρχική παραγωγή. Η μετρημένη διάρκεια της εξόδου και οι προβλεπόμενες ποσότητες δεν αποτελούν την τελική χρεώσιμη ποσότητα.

Οι τιμολογιακές αναφορές δεν προσθέτουν επιλογές αιτήματος. Οι υποστηριζόμενες παράμετροι αναφέρονται στην επιλεγμένη μέθοδο.

Γρήγορη λειτουργία: Δεν έχει οριστεί Όταν επιλέγεται η γρήγορη λειτουργία
Λειτουργία flex: Δεν έχει οριστεί Όταν επιλέγεται η λειτουργία flex
Μέγιστη προσπάθεια συλλογισμού: Δεν έχει οριστεί Όταν η μέγιστη προσπάθεια συλλογισμού χρησιμοποιεί την προσαρμογή default

Εκτιμώμενες χρεώσεις για σύγκριση

Τιμές ανά διαμόρφωση

Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.

Διαμόρφωση	Πίνακας χρεώσεων	Προβλεπόμενη ποσότητα	Μονάδα τιμολόγησης	Συνθήκες χρέωσης	Pixel ανά megapixel	Χρέωση
ΔιαμόρφωσηΒασικές χρεώσεις token	Πίνακας χρεώσεωνΒασική χρέωση	Προβλεπόμενη ποσότητα—	Μονάδα τιμολόγησης—	Συνθήκες χρέωσης—	Pixel ανά megapixel—	Χρέωση Είσοδος · Token εισόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Έξοδος · Token εξόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα · Εκτίμηση μόνο για σύγκριση — / 1K token
ΔιαμόρφωσηΤιμή βίντεο	Πίνακας χρεώσεων—	Προβλεπόμενη ποσότητα—	Μονάδα τιμολόγησηςανά μεγαπίξελ-δευτερόλεπτο	Συνθήκες χρέωσηςποιότητα: creative	Pixel ανά megapixel1.048.576	Χρέωση Έξοδος · Τιμή βίντεο · Εκτίμηση μόνο για σύγκριση $0.21 ανά μεγαπίξελ-δευτερόλεπτο
ΔιαμόρφωσηΤιμή βίντεο	Πίνακας χρεώσεων—	Προβλεπόμενη ποσότητα—	Μονάδα τιμολόγησηςανά μεγαπίξελ-δευτερόλεπτο	Συνθήκες χρέωσηςquality: precise	Pixel ανά megapixel1.048.576	Χρέωση Έξοδος · Τιμή βίντεο · Εκτίμηση μόνο για σύγκριση $0.15 ανά μεγαπίξελ-δευτερόλεπτο
ΔιαμόρφωσηΕκτιμώμενο κόστος δημιουργίας	Πίνακας χρεώσεων—	Προβλεπόμενη ποσότηταεκτίμηση για μία δημιουργία	Μονάδα τιμολόγησης—	Συνθήκες χρέωσης—	Pixel ανά megapixel—	Χρέωση Έξοδος · Εκτιμώμενο κόστος δημιουργίας · Εκτίμηση μόνο για σύγκριση $0.15 εκτίμηση πριν από τη δημιουργία Αυτή η εκτίμηση δεν αποτελεί πρόσθετη χρέωση ούτε σταθερή τιμή για την ολοκληρωμένη παραγωγή.

Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →

Παραδείγματα αιτημάτων

Ailoot Ultra · Βίντεο

Χρησιμοποιήστε την πραγματική είσοδο και διατηρήστε το πλήρες αποτέλεσμα

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.

Λήψη και αποθήκευση αποτελεσμάτων

Ailoot Ultra · Βίντεο

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

Αποθηκεύστε όλα τα ολοκληρωμένα αρχεία

Λήψη όλων των ολοκληρωμένων αρχείων με 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

Διατηρήστε όλα τα ολοκληρωμένα αποτελέσματα

Αποθηκεύστε κάθε ολοκληρωμένο βίντεο ή αρχείο που επιστρέφεται· ανακτήστε κάθε πραγματικό URL αρχείου που επιστρέφεται.

Διατηρήστε ολόκληρη την απόκριση και τις κεφαλίδες, κάθε πραγματικό αποτέλεσμα εξόδου, τα αρχικά αναγνωριστικά που επιστράφηκαν και όλα τα πεδία χρήσης. Ανακτήστε την αρχική λειτουργία χωρίς να υποβάλετε ξανά αίτημα δημιουργίας.

Αν χρειάζεται έλεγχος της αρχικής απάντησης

Διατηρήστε τα X-Client-Request-ID, X-Ailoot-Task-Id και το πραγματικό id/polling_url που επιστρέφεται. Συνεχίστε την αρχική εργασία· μην υποβάλετε ξανά αίτημα δημιουργίας.

Πεδία απάντησης

Πεδίο	Τύπος
Πεδίο`id`	Τύπος
Πεδίο`status`	Τύπος
Πεδίο`data[]`	Τύπος
Πεδίο`outputs[]`	Τύπος

Εναλλακτικά ονόματα

Εναλλακτικά ονόματα μοντέλου

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

Εναλλακτικές διαδρομές μεθόδων

Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.

Σχετικά ID μοντέλων

black-forest-labs/flux-video-upscale

FAQ · Black Forest Labs: FLUX Video Upscale

Ποιες είσοδοι και αποτελέσματα διατίθενται;: POST /v1/videos · black-forest-labs/flux-video-upscale: text, image, audio, video → video
Ποια πεδία χρησιμοποιεί το αίτημα;: POST /v1/videos · black-forest-labs/flux-video-upscale: model, input_references, upscale_factor, creativity
Ποια όρια ισχύουν;: POST /v1/videos · black-forest-labs/flux-video-upscale: upscale_factor.minimum: 1.5; upscale_factor.maximum: 3

Black Forest Labs: FLUX Video Upscale