flux-pro-1.0-depth API

Specyfikacja techniczna flux-pro-1-0-depth

Czym jest flux-pro-1-0-depth?

flux-pro-1-0-depth to identyfikator platformy CometAPI dla modelu FLUX Pro 1.0 Depth firmy Black Forest Labs — modelu generowania i edycji obrazów z uwzględnieniem głębi, zaprojektowanego tak, aby zachowywać trójwymiarową strukturę sceny podczas stosowania transformacji sterowanych promptem. Zamiast traktować obraz jako płaską zawartość pikseli, wykorzystuje sterowanie oparte na głębi, dzięki czemu edycje lepiej respektują perspektywę, rozmieszczenie obiektów i skalę względną.

Dzięki temu model jest szczególnie przydatny, gdy chcesz zmienić styl lub zmodyfikować istniejący obraz bez utraty spójności przestrzennej. W publicznych opisach FLUX.1 Depth dokumentacja Black Forest Labs i ekosystemu podkreśla przypadki użycia, takie jak sceny architektoniczne, wizualizacja produktów, transfer stylu z zachowaniem struktury oraz edycje, w których istotne jest utrzymanie realistycznej geometrii.

Warto też zauważyć, że pierwotny endpoint Black Forest Labs z tą nazwą modelu został wycofany ze skutkiem od 31 października 2025 r. Nie zmienia to kodu modelu CometAPI, którego należy tu używać, ale jest to istotny kontekst dla deweloperów oceniających długoterminową kompatybilność i planowanie migracji.

Najważniejsze funkcje flux-pro-1-0-depth

• Kontrola z uwzględnieniem głębi: Model został zbudowany tak, aby wykorzystywać sterowanie oparte na głębi, dzięki czemu generowane edycje naturalniej odpowiadają geometrii sceny i perspektywie.
• Zachowanie relacji przestrzennych: Zaprojektowany, by utrzymywać trójwymiarowe relacje między obiektami, co pomaga zachować wiarygodność kompozycji po transformacji.
• Przekształcanie obrazu z zachowaniem struktury: Workflej FLUX oparty na głębi jest opisywany jako użyteczny do reteksturyzacji, kontrolowanej zmiany stylu i przekształcania uporządkowanych danych wejściowych w bogatsze wizualnie wyniki przy zachowaniu układu.
• Bardzo dobre dopasowanie do przepływów pracy wizualizacyjnych: Publiczna dokumentacja modelu podkreśla wizualizacje architektoniczne, lokowanie produktu oraz precyzyjną kompozycję sceny jako kluczowe mocne strony.
• Większa kontrola twórcza niż przy samej generacji opartej wyłącznie na promptach: Ponieważ model może podążać za strukturą obrazu oprócz instrukcji tekstowych, lepiej nadaje się do edycji, w których liczy się spójność i sterowalność. Jest to wniosek oparty na udokumentowanej konstrukcji sterowanej głębią i deklarowanych przypadkach użycia modelu.
• Profesjonalna integracja z ekosystemem FLUX: Należy do zestawu narzędzi FLUX Pro do zaawansowanej generacji i edycji obrazów.
• Status wycofania pierwotnego endpointu: Deweloperzy powinni mieć świadomość, że Black Forest Labs oznaczyło pierwotny endpoint flux-pro-1.0-depth jako wycofany od 31 października 2025 r.

Jak uzyskać dostęp i zintegrować flux-pro-1-0-depth

Krok 1: Zarejestruj się i uzyskaj klucz API

Aby rozpocząć, zarejestruj się w CometAPI i wygeneruj klucz API z poziomu pulpitu. Tego klucza użyjesz do autoryzacji wszystkich żądań do interfejsu API flux-pro-1-0-depth.

Krok 2: Wysyłanie żądań do interfejsu API flux-pro-1-0-depth

Użyj zgodnego z FLUX endpointu CometAPI pod adresem POST /flux/v1/{model}.

curl https://api.cometapi.com/flux/v1/flux-pro-1-0-depth \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $COMETAPI_API_KEY" \
  -d '{
    "prompt": "A breathtaking landscape painting with golden hour lighting",
    "width": 1024,
    "height": 768,
    "steps": 20,
    "prompt_upsampling": true
  }'

Krok 3: Pobierz i zweryfikuj wyniki

Interfejs API zwraca identyfikator zadania. Odpytuj GET /flux/v1/get_result?id={task_id}, aby sprawdzić status generowania i pobrać obraz wynikowy po zakończeniu.