Buduj z CometAPIPotrzebujesz jednego API dla wielu modeli?Przetestuj proces w Playground, a potem utwórz klucz API, gdy model i koszt pasują do Twojego zastosowania.
Twórz zdjęcia produktów, plakaty i edycje oparte na referencjach z FLUX 3 Image, dostępne przez CometAPI jako flux-3-image, z ceną od $0.0384 za żądanie. Ten przewodnik przeprowadzi Cię przez wybór ustawień obrazu, przygotowanie żądania, obsługę asynchronicznego zadania i przegląd gotowego obrazu. Potrzebujesz konta CometAPI, klucza API oraz konfiguracji żądania FLUX 3 Image przypisanej do Twojego konta.
Kluczowe wnioski
Wybierz text-to-image dla nowych kompozycji oraz edycję sterowaną referencją, gdy produkt lub temat muszą pozostać rozpoznawalne.
Użyj małego szkicu, aby ocenić kompozycję przed wydaniem środków na większy obraz finalny.
Używaj poświadczeń CometAPI i modelowego schematu żądania; natywne klucze BFL i przykłady należą do osobnej integracji.
Szacuj koszty na podstawie stawki CometAPI, a następnie mierz wydatki per zaakceptowany materiał.
Sprawdzone pod kątem przejrzystości, atrybucji źródeł i aktualnej terminologii API.
Zakończ jedną pętlę: wysłanie, pobranie wyniku, ściągnięcie i weryfikację wizualną przed uruchomieniem wsadu.
Czym jest FLUX 3 Image API?
FLUX 3 Image to model Black Forest Labs do tworzenia i modyfikowania obrazów statycznych. Tekstowy prompt opisuje nową scenę; obrazy referencyjne dostarczają materiał wizualny do zachowania, łączenia lub zmiany. Dla zespołu e-commerce może to oznaczać przygotowanie sceny produktowej z briefu, a następnie ponowne wykorzystanie zatwierdzonego zdjęcia produktu z innym otoczeniem.
Wybierz przepływ pracy przed napisaniem promptu. Dla nowej wizualizacji określ temat, scenerię, oświetlenie i kadrowanie. Dla edycji wskaż obraz źródłowy, nazwij zmianę i określ, które detale muszą pozostać nienaruszone. Dla kompozycji z kilkoma referencjami przypisz każdej rolę, tak aby tożsamość produktu i styl wizualny nie konkurowały.
Specyfikacje FLUX 3 Image i parametry API
Zaplanuj obraz, korzystając z poniższych ustawień. Kontrole modelu podążają za BFL FLUX 3 Image API reference; uwierzytelnianie i trasowanie żądania zgodnie z Twoją integracją CometAPI. Używaj nazw pól akceptowanych przez trasę FLUX 3 Image w CometAPI.
Wybierz wymiary na trzy sposoby: poziom rozdzielczości plus proporcje, width plus height dla dokładnego płótna lub match_input dla edycji. Zachowaj oryginalną referencję, aby porównać kadrowanie i detale po generacji. Natywny endpoint odrzuca nieobsługiwane pola; używaj schematu trasy, którą wywołujesz.
FLUX.2 vs FLUX 3 Image
Zachowaj obecną integrację FLUX.2 jako punkt odniesienia przy ocenie FLUX 3 Image. Uruchom te same briefy i zasoby referencyjne w obu przepływach, a następnie porównaj zaakceptowane wyniki, czas realizacji i całkowity koszt.
Jak generować obraz przy użyciu FLUX 3 Image API w CometAPI?
POST https://api.cometapi.com/flux/v1/flux-3-image
Uwierzytelnianie wykorzystuje token Bearer (styl CometAPI). Żądania są domyślnie asynchroniczne.
3. Podstawowy przykład text-to-image (cURL)
curl https://api.cometapi.com/flux/v1/flux-3-image \
-H "Authorization: Bearer $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Ultra-wide cinematic shot of a fog-drenched coastal highway at dawn, cliffs on one side, turquoise sea on the other, a single vintage car with headlights on, soft golden rim light",
"aspect_ratio": "21:9",
"resolution": "1k"
}'
Odpytuj, aż status będzie równy "Ready". Adres URL obrazu pojawi się w result.sample (pobierz szybko; podpisane adresy są tymczasowe).
Aby czekać synchronicznie w tym samym żądaniu, dodaj "async": false do ciała (połączenie pozostaje otwarte; ustaw długi timeout klienta).
5. Przykład w Pythonie (wysłanie + odpytywanie)
import os
import time
import requests
API_KEY = os.environ["COMETAPI_KEY"]
BASE = "https://api.cometapi.com/flux/v1"
def generate_image(payload, name="flux3_image"):
# Submit
r = requests.post(
f"{BASE}/flux-3-image",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json=payload,
timeout=60,
)
r.raise_for_status()
task = r.json()
task_id = task["id"]
# Poll
while True:
time.sleep(1.5)
result = requests.get(
f"{BASE}/get_result",
params={"id": task_id},
headers={"Authorization": f"Bearer {API_KEY}"},
timeout=60,
).json()
status = result.get("status")
if status not in ("Pending", "Reasoning", "Generating"):
break
if status != "Ready":
raise RuntimeError(result)
# Download
img_url = result["result"]["sample"]
img = requests.get(img_url, timeout=120)
with open(f"{name}.png", "wb") as f:
f.write(img.content)
return f"{name}.png"
# Example call
generate_image({
"prompt": "A two-color risograph narrative illustration... a rabbit rides a pumpkin...",
"aspect_ratio": "16:9",
"resolution": "1k",
})
FLUX 3 Image obsługuje czyste text-to-image ORAZ edycję/wieloreferencyjność w tym samym endpointcie — po prostu dołącz images i opisz ich użycie w promcie (brak osobnego pola „mode”).
Alternatywa: trasa zgodna z OpenAI
Możesz też wypróbować zunifikowany endpoint obrazów z ID modelu:
POST https://api.cometapi.com/v1/images/generations
(Natywne `/flux/v1/...` jest preferowane dla pełnych parametrów FLUX 3).
### Wskazówki
* Sprawdź bieżącą dostępność i dokładne ceny na [CometAPI FLUX 3 Image — strona modelu](https://www.cometapi.com/models/flux/flux-3-image/).
* Zawsze szybko pobieraj adres URL `result.sample`.
* Po najnowszą listę parametrów lub przykłady playgroundu zajrzyj do dokumentacji Flux w CometAPI i oficjalnej referencji FLUX 3 Image w Black Forest Labs.
To odzwierciedla oficjalny przepływ BFL, korzystając z uwierzytelniania i zunifikowanej infrastruktury CometAPI.
## Jak tworzyć prompty dla FLUX 3 Image? Przykłady
### Przykład: Prompt do fotografii produktowej
Użyj tego promptu na pierwszy test fotografii produktowej.
A premium amber perfume bottle centered on matte limestone,
three-quarter product perspective, exact bottle silhouette,
softbox key light camera-left, detailed contact shadow,
subtle natural reflections, beige seamless studio backdrop,
no extra bottles, no watermark, no altered brand lettering.
Output: clean 4:5 e-commerce hero creative.
Zastąp wartość promptu w request.json tym briefem, zachowując ciało żądania zgodne z trasą CometAPI. Płótno 4:5 pasuje do pionowego ujęcia produktu. Jeśli Twoja trasa akceptuje natywne sterowanie wymiarami, 1024 × 1280 to dokładna opcja 4:5; podaj obie wartości razem.
Zacznij od małego szkicu i sprawdź sylwetkę butelki, etykietę, odbicia i obiekty dodatkowe. Jeśli dokładna tożsamość produktu ma znaczenie, użyj referencji produktu zamiast oczekiwać, że prompt tekstowy wiernie go odtworzy. Zapisz prompt i ustawienia wyjściowe przed wprowadzaniem zmian.
### Przykład: Typografia i układ plakatu
Prompt do plakatu z jednoznacznie określonym tytułem.
An editorial art poster on warm off-white paper.
Title text exactly: THE SEED PARADE.
Three stylized walking seed characters below the title.
Two-color risograph-inspired printing, generous margins,
balanced hierarchy, crisp legible typography, portrait format.
Użyj tego briefu jako promptu w żądaniu CometAPI i wybierz pionowe płótno. Zacznij od szkicu, aby sprawdzić pozycję nagłówka i układ postaci, a następnie zwiększ rozmiar wyjściowy dla finalnej pracy.
Traktuj poprawność liter jako mierzalny warunek akceptacji. Przejrzyj każdą literę i znak w finalnej rozdzielczości; imponujące obrazy poglądowe nie gwarantują braku błędów w Twoim konkretnym tekście brandowym.
## Jak edytować obrazy z referencjami
Dla edycji opisz zarówno żądaną zmianę, jak i detale do zachowania. Natywne API FLUX 3 Image przyjmuje referencje w `images`; zmapuj je na odpowiednie pole wejściowe w przykładzie CometAPI. Umieść referencję produktu jako pierwszą i utrzymaj tę kolejność w promcie.
### Edycja pojedynczego obrazu: Zmień tło, zachowaj produkt
Trzymaj edit.py obok submit.py, poll.py i download.py. Ustaw PRODUCT\_IMAGE\_URL na publicznie dostępne HTTPS ze zdjęciem produktu, a następnie uruchom python edit.py. Poniższy przykład wymaga trasy akceptującej natywną tablicę images. Użyj ciała żądania edycji bez konfliktujących pól obrazu źródłowego i zmień mapowanie, jeśli Twój przykład CometAPI używa innego pola wejścia. Aby wznowić zapisane zadanie edycji, uruchom python poll\_download.py editing-task.json.
import json
import os
from pathlib import Path
from submit import submit
from poll import wait_for_image
from download import download_image
This request variant requires a route accepting the native images array.
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["images"] = [os.environ["PRODUCT_IMAGE_URL"]]
payload["prompt"] = (
"Use image 1 as the authoritative product reference. "
"Replace only the studio background with pale limestone and warm "
"morning window light. Preserve bottle shape, cap, label text, logo "
"position, and product color. Do not crop the product or add objects."
)
task_id = submit(payload, "editing-task.json")
image_url = wait_for_image(task_id)
print(download_image(image_url, "edited-product"))
Wybierz ostre zdjęcie produktu z czytelną etykietą i wyraźną sylwetką. Prześlij je w formacie wejściowym obrazu akceptowanym przez Twoją trasę CometAPI. Jeśli trasa wspiera natywne ustawienie rozdzielczości, użyj match\_input, aby zachować kadrowanie i rozmiar referencji w granicach limitów edycji modelu.
[BFL gallery](https://bfl.ai/models/flux-3-image) pokazuje zlokalizowaną edycję z dodaniem dwóch nurków. Te oficjalne materiały „przed i po” ilustrują, co sprawdzać; nie są wynikami z żądania CometAPI uruchomionego na potrzeby tego artykułu.
Oficjalny przykład edycji BFL, przed: oryginalna podwodna scena z jednym nurkiem.
Oficjalny przykład edycji BFL, po: do sceny dodano dwóch nurków. Sprawdź niezmienione tło oraz nowe obiekty.
### Edycja wieloreferencyjna: Połącz styl i tożsamość produktu
Zachowaj produkt jako pierwszy, a referencję oświetlenia/stylu jako drugą. Ustaw PRODUCT\_IMAGE\_URL i STYLE\_IMAGE\_URL, zapisz poniższy kod jako multi\_edit.py obok trzech plików klienta i uruchom python multi\_edit.py. Ten przykład wymaga trasy akceptującej co najmniej dwie referencje w images. Zacznij od ciała żądania edycji bez konfliktujących pól obrazu źródłowego. Wznów zapisane zadanie poleceniem python poll\_download.py multi-edit-task.json.
import json
import os
from pathlib import Path
from submit import submit
from poll import wait_for_image
from download import download_image
Preserve this order: product first, lighting/style second.
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["images"] = [
os.environ["PRODUCT_IMAGE_URL"],
os.environ["STYLE_IMAGE_URL"],
]
payload["prompt"] = (
"Image 1 defines product identity. Image 2 defines lighting and color. "
"Create one promotional image with the exact product from image 1 "
"and the lighting mood of image 2. Preserve product lettering and "
"geometry. Do not copy logos, text, or extra objects from image 2."
)
task_id = submit(payload, "multi-edit-task.json")
print(download_image(wait_for_image(task_id), "multi-edited-product"))
Dołącz obie referencje, używając formatu specyficznego dla CometAPI. Najpierw sprawdź, czy produkt zachował tożsamość; następnie oceń, czy druga referencja wniosła zamierzone światło i kolor. Jeśli wprowadza też niechciane obiekty lub liternictwo, uprość tę referencję lub doprecyzuj prompt.
## Jak używać ramek (bounding boxes) do kontroli układu
Używaj ramek, gdy butelka i nagłówek muszą zajmować przewidywalne obszary. Napisz podpis sceny z ID każdego elementu, a następnie dołącz do promptu tablicę JSON. Format BFL używa bbox w kolejności [top, left, bottom, right] na siatce 0–1000; ramki należą do promptu, nie do osobnego pola API.
Poniższy przykład rezerwuje miejsce na nagłówek nad butelką. Utrzymaj pionowe ustawienie wyjściowe w request.json i zapisz ten plik jako layout.py obok submit.py. Uruchom python layout.py, a następnie python poll\_download.py layout-task.json. Użyj trasy, która obsługuje tę składnię układu; sprawdź, czy butelka i nagłówek zajmują zamierzone obszary.
import json
from pathlib import Path
from submit import submit
caption = (
"A portrait perfume advertisement: an amber bottle <bottle_1> "
"below a headline <title_1>, on a warm beige background."
)
elements = [
{"id": "title_1", "bbox": [80, 120, 220, 880],
"desc": "Dark brown text reading AMBER, centered"},
{"id": "bottle_1", "bbox": [300, 300, 880, 700],
"desc": "One amber glass perfume bottle with a black cap"},
]
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["prompt"] = caption + " " + json.dumps(elements)
print(submit(payload, "layout-task.json"))
Utrzymaj proporcje zgodne z układem. Ramki kierują rozmieszczeniem, a nie przycinają obiektu do twardej granicy. Skontroluj pisownię i odstępy w nagłówku na zapisanym obrazie; dodaj finalne liternictwo marki w narzędziu DTP, gdy niezbędna jest idealna typografia.
## Ile kosztuje FLUX 3 Image API?
CometAPI oferuje FLUX 3 Image od [$0.0384 za żądanie](https://www.cometapi.com/models/flux/flux-3-image/) (9 listopada 2026 r.). Użyj tej stawki początkowej jako wstępnego budżetu, a następnie zastosuj stawkę pokazaną dla wybranej konfiguracji. Poniższe przykłady zakładają, że każde rozliczane żądanie używa stawki początkowej.
| Rozliczane żądania | Założona stawka / żądanie | Przykładowy koszt |
| ------------------ | ------------------------- | ----------------- |
| 1 | $0.0384 | $0.0384 |
| 10 | $0.0384 | $0.3840 |
| 100 | $0.0384 | $3.84 |
| 1000 | $0.0384 | $38.40 |
Sprawdź stawkę dla wybranej konfiguracji i konta przed uruchomieniem wsadu. Cena publiczna startowa nie determinuje ceny każdej rozdzielczości czy opcji edycji. Śledź odrzucone próby kreatywne oraz zatwierdzone materiały: jeśli wydasz $3.84 na 100 rozliczanych żądań i zatwierdzisz 80 materiałów, koszt API na zaakceptowany materiał wyniesie $0.048, przed weryfikacją ludzką i przechowywaniem. To kalkulacja poglądowa, a nie zmierzony wskaźnik akceptacji.
### Wybór rozdzielczości wg przepływu pracy
| Przepływ pracy | Pierwszy test | Kontrola akceptacji |
| ----------------------------- | ------------------------------------------------ | ------------------------------------------------- |
| Eksploracja promptów | Najmniejszy użyteczny wspierany poziom | Kompozycja i rozmieszczenie tematu |
| Zdjęcia produktowe e-commerce | Szkic z docelowym kadrowaniem | Geometria produktu, etykiety, detale krawędzi |
| Kampanie lub prace editorial | Najpierw szkic; większy output po akceptacji układu | Typografia i detale w rozmiarze dostawy |
| Edycje oparte na referencjach | Wspierane ustawienie dopasowane do źródła | Obszary niezmienione, tożsamość produktu, światło |
## Kiedy użyć FLUX 3 Video zamiast tego?
Używaj FLUX 3 Image do materiałów statycznych, takich jak hero produktu, plakat lub ujęcie kampanii. Jeśli materiał ma zawierać ruch, sprawdź [FLUX 3 Video na CometAPI](https://www.cometapi.com/models/flux-3/), dostępne pod osobnym ID modelu flux-3. Jego [workflow wideo](https://apidoc.cometapi.com/api/video/flux-3/create) używa ustawień i rozliczeń specyficznych dla wideo. Trzymaj żądania obrazów i wideo osobno; czas trwania, audio i kontrola klatek wideo nie należą do żądania obrazu statycznego.
Dla kampanii w obu formatach najpierw zaakceptuj kompozycję obrazu statycznego, a następnie przygotuj oddzielny brief wideo. Sprawdź wymagania wejść referencyjnych modelu wideo przed ponownym użyciem zatwierdzonego obrazu jako materiału źródłowego.
## Zakończenie
Zacznij od jednego briefu produktowego i jednego małego zadania obrazowego. Wyślij je przez swoją trasę FLUX 3 Image w CometAPI, zapisz ID zadania, pobierz ukończony obraz i przejrzyj wynik przed skalowaniem. Używaj width i height, gdy potrzebujesz dokładnego płótna, albo match\_input dla edycji referencyjnej tam, gdzie jest wspierane. Porównuj łączne wydatki z liczbą zatwierdzonych obrazów, aby budżet odzwierciedlał użyteczne wyniki.
## Metadane SEO
Meta title: FLUX 3 Image API Guide: Generowanie, edycja i CometAPI
Meta description: Używaj FLUX 3 Image w CometAPI do generowania i edycji. Poznaj parametry obrazu, obsługę zadań asynchronicznych, przykłady promptów i ceny od $0.0384 za żądanie.
Keywords: FLUX 3 Image API, CometAPI FLUX 3 Image, edycja obrazów FLUX 3, ceny FLUX 3, generowanie z obrazów referencyjnych, migracja FLUX.2
URL slug: flux-3-image-api-guide
Zdolność / ustawienie
Co kontroluje
Jak używać z CometAPI
Tożsamość modelu
FLUX 3 Image; katalogowe ID flux-3-image
Użyj trasy specyficznej dla modelu i konwencji routingu z przykładu Twojego konta.
Generowanie / prompt
Scena, kompozycja lub instrukcja edycji
Zacznij od jednego wyraźnego tematu i jednego zamierzonego wyniku.
Obrazy referencyjne / native images
Uporządkowana lista 1–10 obrazów referencyjnych, dostarczona jako adresy HTTP(S) lub base64 w natywnym API.
Potwierdź nazwę pola, format wejścia i limit referencji w bramce.
Proporcje / native aspect_ratio
Proporcje płótna. Przy auto, proporcje zażądane w promcie mają pierwszeństwo; w przeciwnym razie edycje zachowują kadrowanie pierwszej referencji.
Wybierz proporcje pod format dostawy i potwierdź akceptowane wartości.
Rozdzielczość / native resolution
Natywne poziomy: 768sq, 1k (domyślna), 1.5k, 2k i 4k. Dokładne wymiary zależą od proporcji.
Dla edycji, match_input zachowuje rozmiar pierwszej referencji, zredukowany do 4 MP jeśli większy; jawne aspect_ratio wybiera najbliższy poziom. Jawne width i height mają priorytet.
Dokładne wymiary / width + height
Podaj obie liczby całkowite, każda 256–6256 px. Nadpisują resolution i aspect_ratio. Łączny obszar ograniczony do 16,822,272 pikseli, lub 4,194,304 pikseli przy użytych referencjach.
Użyj dokładnych wymiarów dla stałej powierzchni dostawy, np. 1024 × 1280. Potwierdź, że Twoja trasa CometAPI akceptuje te natywne ustawienia.
Kontrola układu
Wskazówki dot. rozmieszczenia elementów na bazie ramek (bounding boxes)
Użyj udokumentowanej składni układu, gdy liczy się dokładne pozycjonowanie.
Edycje ukierunkowane
Zmiany wybranych obiektów lub regionów
Wymiar
FLUX 2 MAX / FLUX 2 PRO
FLUX 3 Image
Ocena praktyczna
Zastosowanie
Mocne text-to-image/edytowanie, warianty rodzinne
Szczegółowa kompozycja obrazu i edycje zachowujące piksele
Porównaj te same prompty brandowe
Rozdzielczość
Generowanie w wysokiej rozdzielczości zależnie od wariantu
Jawne natywne 2K/4K
Oglądaj drobne detale przy pełnym powiększeniu
Edycja
Wieloreferencyjność w wybranych wariantach
Prezentacje lokalnych edycji
Mierz dryf obszarów nieedytowanych
Koszt
Zależny od wariantu i platformy
Ceny CometAPI dla wybranej konfiguracji
Porównuj koszt per zaakceptowany obraz
Dostęp przez CometAPI
Dostępny jako FLUX 2 PRO i FLUX 2 MAX
Dostępny jako flux-3-image
Zweryfikuj żądanie specyficzne dla modelu przed zmianą routingu produkcyjnego
Ewaluacja
Użyj dokładnie tego wariantu, który dziś wdrożono
Uruchom ten sam prompt i zestaw referencji
Porównaj zaakceptowane wyniki i całkowity koszt przepływu
Porównaj źródło i wynik w obszarach, które powinny pozostać niezmienione.
Uwierzytelnianie
Klucz API CometAPI dla żądań do bramki
Postępuj zgodnie z nagłówkami uwierzytelniającymi z przykładu CometAPI; trzymaj klucz po stronie serwera.
Obsługa wyników
Asynchroniczne generowanie: wyślij zadanie, śledź jego task ID i pobierz gotowy obraz.
Użyj poniższego szablonu w Pythonie, jeśli trasa konta podąża za kontraktem zadania CometAPI FLUX.
Cennik
Ceny CometAPI zaczynają się od $0.0384 za żądanie (9 listopada 2026 r.).
Skorzystaj z sekcji cen poniżej jako przykładowego budżetu; zweryfikuj wybraną konfigurację.
Dodatkowe pola
Natywne i bramkowe schematy różnią się między generacjami modeli
Natywne FLUX 3 Image akceptuje width i height. Nie używaj seed ani input_image ze starszego modelu; użyj images dla natywnych wejść referencyjnych i zastosuj schemat bramki CometAPI.
