Black Forest Labs: FLUX Video Upscale

FLUX Video Upscale powiększa istniejący klip przez wierne źródłu lub twórcze wzbogacanie detali. Udokumentowany profil oferuje skalowanie 1,5×–3×, zachowuje źródłowe audio i kadrowanie oraz ogranicza długość źródła, rozdzielczość wejściową i powierzchnię klatki wyjściowej.

Ailoot Ultra · Wideo POST /v1/videos black-forest-labs/flux-video-upscale

O modelu

Ten opis przedstawia możliwości modelu. Dane wejściowe, wyniki i opcje dostępne w Ailoot podano poniżej dla wybranej metody.

FLUX Video Upscale to proces superrozdzielczości wideo Black Forest Labs oparty na FLUX 3. Przyjmuje istniejący klip i zwraca powiększony MP4, przenosząc do wyniku źródłowe kadrowanie i audio. Krótki opcjonalny opis może kierować wzbogacaniem detali wizualnych. Dwa tryby stanowią istotny wybór między bliskością dostarczonego wyglądu a agresywniejszym generowaniem detali, zamiast uznawać każdy większy obraz za równie wierną rekonstrukcję.

Wybierz powiększenie precyzyjne lub twórcze

Ustawienie kreatywności wybiera tryb. Wartość 0 oznacza profil precyzyjny, wierny źródłu: producent zaleca go, gdy twarz, produkt lub zasób marki mają zachować tożsamość. Wartość 1 włącza twórcze wzbogacanie detali i jest domyślna. Może agresywniej odtwarzać lub wymyślać teksturę, co przydaje się do generowanego materiału, krajobrazów, tłumów lub powierzchni, których detale można twórczo rozwinąć.

Producent wprost ostrzega, że twórcze wzbogacanie nie zachowuje tak ściśle twarzy i produktów. Sprawdzaj cechę, która musi pozostać rozpoznawalna: wygląd twarzy, obrys produktu, litery, wzór materiału lub logo. Obraz wyglądający ostrzej nadal może zawierać zmieniony lub nowo wymyślony szczegół. W demonstracji produktu kryterium oceny powinien być zamierzony wygląd produktu, zamiast wyboru wersji wyłącznie z bardziej rozbudowaną teksturą.

Opcjonalny prompt opisuje treść klipu, aby kierować wzbogacaniem; pusty opis żąda neutralnego powiększenia. Oryginalny brief generowanej sceny może wskazywać kamienny mur porośnięty mchem, miękkie światło dzienne i drobną fakturę liści. Skup słowa na materiale, który ma być dopracowany. Prośba o podmianę obiektu, przebudowę scenerii lub zmianę dialogu należy do decyzji edycyjnej, podczas gdy ten profil zachowuje źródłową ścieżkę audio.

Skala i powierzchnia klatki wyjściowej

Udokumentowany upscale_factor ma zakres od 1.5 do 3, z 2 jako wartością domyślną. Powiększa rozdzielczość źródła, zachowując proporcje. Wybrany mnożnik i wymiary wejściowe określają zamierzone wyjście, więc klip poziomy i kompozycję pionową trzeba planować z rzeczywistych klatek. Przygotuj docelowy rozmiar wyświetlania przed wyborem użytecznego stopnia powiększenia.

Dokładna specyfikacja ogranicza każdą klatkę wyjściową do 13.75 jednostki megapikselowej producenta. Dokumentacja definiuje jedną taką jednostkę jako 1 048 576 pikseli, co daje pułap 14 417 920 pikseli, około 14,4 miliona. Wyjaśnia to zaokrąglony zapis 14,4 megapiksela w przewodniku. Duże źródło może więc otrzymać mniejsze powiększenie niż żądany mnożnik. Sprawdź dostarczone wymiary, zamiast zakładać, że żądanie 3× zawsze potraja każdy wymiar źródła.

Opublikowany pułap rozdzielczości źródła to 2560×1440. Ten proces powiększa kwalifikujące się źródło w kierunku 4K i wyżej; nie przyjmuje już większego źródła tylko dlatego, że pożądane jest wyższe wyjście. Przed użyciem udokumentowanego profilu pomniejsz lub przygotuj odpowiednią kopię roboczą. Zachowaj oryginalne nagranie osobno, aby końcowe porównanie nie ograniczało się do przeskalowanego pliku pośredniego.

Przygotuj krótkie, czytelne źródło

Zwykłe wskazówki przygotowania producenta ograniczają źródła do dwudziestu sekund i pięćdziesięciu MB. Klip dostarcza się przez URL wideo lub zakodowany MP4. Dokładna dokumentacja wskazuje, że przetwarzanie obejmuje pierwsze dwadzieścia sekund: niewielkie przekroczenie długości może zostać przetworzone tylko do tego miejsca, natomiast znacznie dłuższy klip zostanie odrzucony. Nie opublikowano liczbowej tolerancji. Przytnij do zamierzonego fragmentu trwającego dwadzieścia sekund lub krócej, zamiast polegać na nieokreślonym zachowaniu granicznym.

Wybierz najmniej skompresowaną dostępną wersję. Artefakty kompresji ograniczają ilość prawdziwych detali, które upscaler może odzyskać, a twórcze wzbogacanie może tworzyć wiarygodną fakturę bez ustalenia zawartości oryginalnej sceny. Ukończ zamierzony montaż i przycięcie przed powiększeniem wybranego klipu. Oryginalny proces może najpierw dokończyć ujęcie produktu, wybrać użyteczny przedział akcji, a następnie powiększyć końcowy wybór, zachowując niezmodyfikowane źródło do porównania.

Wynik zachowuje źródłową ścieżkę audio. Sprawdź jej synchronizację z obrazem, szczególnie na początku i końcu wybranego segmentu. Udokumentowany profil nie udostępnia niezależnego wyboru liczby klatek na sekundę, generowania nowego dialogu ani parametrów edycji z referencją obrazową. Jego celem jest większe wideo i wybrany sposób opracowania detali, z zachowaniem czasowego i dźwiękowego materiału źródła w przetwarzanym segmencie.

Zachowaj i sprawdź dostarczony klip

Proces producenta jest asynchroniczny: wysłane zadanie dostarcza tożsamość i adres statusu, a ukończony wynik zawiera podpisany link dostarczenia MP4. Link wygasa po około godzinie. Zachowaj rzeczywisty klip, źródło, wybrany mnożnik, tryb kreatywności i opis treści, zamiast polegać na tymczasowym adresie. Odróżniaj status niepowodzenia lub moderacji od ukończonego filmu.

Sprawdź pojedyncze klatki pod kątem twarzy, oznaczeń i zmian powierzchni, a następnie obejrzyj sekwencję pod kątem ciągłości, ruchu i synchronizacji audio. Wyjścia precyzyjne i twórcze odpowiadają różnym wymaganiom wizualnym; użytecznym materiałem jest powiększony klip realizujący wybrany cel wierności przy docelowym rozmiarze wyświetlania. Sama większa rozdzielczość nie dowodzi, że oryginalna tożsamość, słowa lub drobne detale pozostały poprawne.

Ailoot Ultra · Wideo POST /v1/videos black-forest-labs/flux-video-upscale

black-forest-labs/flux-video-upscale

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

Start

Akceptowane dane wejściowe: Tekst · Obrazy · Audio · Wideo
Wyniki: Wideo

Dostępne w Ailoot · dane wejściowe i metody

Ailoot Ultra · Wideo POST /v1/videos

Wejście: text, image, audio, video
Wyjście: video

Pole	Typ	Wymaganie	Wartości i limity	Domyślnie
Pole`model`	Typ`string`	WymaganieWymagane	Wartości i limity black-forest-labs/flux-video-upscale	Domyślnie—
Pole`input_references`	Typ`array`	WymaganieWymagane	Wartości i limity Minimalna liczba elementów: 1 Maksymalna liczba elementów: 1	Domyślnie—
Pole`upscale_factor`	Typ`number`	WymaganieWymagane	Wartości i limity Minimum: 1,5 Maksimum: 3	Domyślnie—
Pole`creativity`	Typ`integer`	WymaganieWymagane	Wartości i limity 0, 1	Domyślnie—

Parametry i cykl życia metody

Parametr	Kontrakt
Parametr`content_type`	Kontraktapplication/json
Parametr`required`	Kontraktmodel, input_references, upscale_factor, creativity
Parametr`material_types`	Kontrakttext, image, audio, video
Parametr`material_conditions`	KontraktUżyj dokładnie jednego rzeczywistego adresu URL treści ukończonego zasobu wideo należącego do użytkownika wraz ze zwróconym podpisem. Właściciel zasobu, jego typ i zapisane potwierdzenie bajtów muszą odpowiadać żądaniu.

Cykl życia: asynchronous_job_then_owned_outputs

GET /v1/videos/{request_id} · faktycznie zwrócone id lub polling_url

GET /v1/videos/{request_id}/content

Cennik

Jak obliczana jest ostateczna opłata

Wyświetlane stawki służą do oszacowania kosztu przed generowaniem. Ostateczna opłata jest obliczana na podstawie kosztu zarejestrowanego dla pierwotnego generowania. Zmierzony czas trwania wyniku i prognozowane ilości nie stanowią ostatecznej ilości podlegającej rozliczeniu.

Informacje taryfowe nie dodają opcji żądania. Obsługiwane parametry podano przy wybranej metodzie.

Tryb szybki: Nie określono Gdy wybrany jest tryb szybki
Tryb flex: Nie określono Gdy wybrany jest tryb flex
Maksymalna intensywność rozumowania: Nie określono Gdy dla maksymalnej intensywności rozumowania stosowana jest domyślna korekta (default)

Szacunkowe stawki do porównania

Ceny według konfiguracji

Dopasuj każdą opłatę do pokazanych warunków. Użyj jednej stawki dla każdego zestawu alternatywnych konfiguracji.

Konfiguracja	Tabela stawek	Przewidywana ilość	Jednostka rozliczeniowa	Warunki rozliczania	Piksele na megapiksel	Opłata
KonfiguracjaBazowe stawki za tokeny	Tabela stawekStawka podstawowa	Przewidywana ilość—	Jednostka rozliczeniowa—	Warunki rozliczania—	Piksele na megapiksel—	Opłata Wejście · Tokeny wejściowe · Szacunek tylko do porównania — / 1K tokenów Wyjście · Tokeny wyjściowe · Szacunek tylko do porównania — / 1K tokenów Wejście · Odczyt cache · Szacunek tylko do porównania — / 1K tokenów Wejście · Zapis do cache · Szacunek tylko do porównania — / 1K tokenów Wejście · Zapis do cache, 1 godz. · Szacunek tylko do porównania — / 1K tokenów
KonfiguracjaCena wideo	Tabela stawek—	Przewidywana ilość—	Jednostka rozliczeniowaza megapikselosekundę	Warunki rozliczaniajakość: creative	Piksele na megapiksel1 048 576	Opłata Wyjście · Cena wideo · Szacunek tylko do porównania $0.21 za megapikselosekundę
KonfiguracjaCena wideo	Tabela stawek—	Przewidywana ilość—	Jednostka rozliczeniowaza megapikselosekundę	Warunki rozliczaniaquality: precise	Piksele na megapiksel1 048 576	Opłata Wyjście · Cena wideo · Szacunek tylko do porównania $0.15 za megapikselosekundę
KonfiguracjaSzacowany koszt generowania	Tabela stawek—	Przewidywana ilośćszacunek dla jednego generowania	Jednostka rozliczeniowa—	Warunki rozliczania—	Piksele na megapiksel—	Opłata Wyjście · Szacowany koszt generowania · Szacunek tylko do porównania $0.15 szacunek przed generowaniem Ten szacunek nie jest dodatkową opłatą ani stałą stawką za ukończone generowanie.

Ailoot rezerwuje szacowaną kwotę przed żądaniem. Po otrzymaniu wyniku rozlicza ostateczną opłatę według zmierzonego użycia. Rozliczenie strumieniowania korzysta z końcowego rekordu użycia. Jak działają rezerwacja i rozliczenie →

Przykładowe żądania

Ailoot Ultra · Wideo

Użyj rzeczywistych danych wejściowych i zachowaj kompletny wynik

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.

Odbieranie i zapisywanie wyników

Ailoot Ultra · Wideo

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

Zapisz wszystkie ukończone zasoby

Pobierz wszystkie ukończone zasoby przez 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

Zachowaj wszystkie ukończone wyniki

Zapisz każde ukończone wideo lub zwrócony plik; pobierz każdy faktycznie zwrócony URL zasobu.

Zachowaj pełną odpowiedź i nagłówki, wszystkie rzeczywiście uzyskane wyniki, pierwotnie zwrócone identyfikatory oraz wszystkie pola zużycia. Odzyskaj pierwotną operację bez ponownego wysyłania żądania utworzenia.

Jeśli trzeba sprawdzić pierwotną odpowiedź

Zachowaj X-Client-Request-ID, X-Ailoot-Task-Id oraz faktycznie zwrócone id/polling_url. Kontynuuj pierwotne zadanie; nie wysyłaj ponownie żądania utworzenia.

Pola odpowiedzi

Pole	Typ
Pole`id`	Typ
Pole`status`	Typ
Pole`data[]`	Typ
Pole`outputs[]`	Typ

Aliasy

Aliasy modelu

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

Aliasy ścieżek metod

Użyj ścieżek metod podanych powyżej.

Powiązane ID modeli

black-forest-labs/flux-video-upscale

FAQ · Black Forest Labs: FLUX Video Upscale

Jakie dane wejściowe i wyniki są dostępne?: POST /v1/videos · black-forest-labs/flux-video-upscale: text, image, audio, video → video
Jakich pól używa żądanie?: POST /v1/videos · black-forest-labs/flux-video-upscale: model, input_references, upscale_factor, creativity
Jakie limity obowiązują?: POST /v1/videos · black-forest-labs/flux-video-upscale: upscale_factor.minimum: 1.5; upscale_factor.maximum: 3

Black Forest Labs: FLUX Video Upscale