Wprowadzenie
FLUX 3 Klein Base, edycja obrazu zmienia lub łączy od jednego do trzech obrazów źródłowych na podstawie pisemnej instrukcji na FLUX 3 Image Klein Base od Black Forest Labs, nieudestylowanym punkcie kontrolnym 5.6B. Odwołuj się do źródeł jako image 1, image 2 i image 3, zachowaj kształt pierwszego obrazu przez auto albo wybierz jedną z piętnastu proporcji, a także 1k lub 2k. Edycje trwały w naszych testach około 20 do 40 sekund w 1k, a nic nie jest filtrowane.
Wybierz tryb według materiału wyjściowego
| Co masz | Tryb |
|---|---|
| pisemny opis | FLUX 3 Klein Base, tekst na obraz |
| od jednego do trzech obrazów do zmiany lub połączenia | FLUX 3 Klein Base, edycja |
Najważniejsze funkcje
Ubrania ze zdjęcia produktowego
Daj osobę jako image 1, a ubranie sfotografowane na wieszaku jako image 2, a edycja ubierze jedną w drugie. W naszych testach kobieta w zimowej parce wyszła w bordowej aksamitnej sukience na cienkich ramiączkach w przebieralni sauny, z zachowaną twarzą i włosami.
Ta sama osoba, nowe miejsce
Twarz, broda i sylwetka przetrwały pełną zmianę stroju i otoczenia: wędrowiec w czerwonej kurtce w zaśnieżonym lesie stał się tym samym mężczyzną w rozpiętej lnianej koszuli na cedrowej ławce. Krótkie, konkretne instrukcje najlepiej trzymały twarze.
Połącz do trzech obrazów
Dwa osobne zdjęcia dwóch kobiet stały się jedną sceną na ławce w saunie, w pasujących sukienkach, a obie twarze pozostały rozpoznawalne. Przy trzech źródłach napisz, co wnosi każde, żeby nic nie zginęło.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
prompt | Tak | Wymagane, do 5000 znaków. Najpierw nazwij, co ma zostać (twarz, włosy, sylwetka), potem zmianę. od 1 znaków · do 5000 znaków |
image_urls | Tak | Wymagane, od jednego do trzech publicznych linków do obrazów, do 10 MB każdy. Link, który się nie otwiera lub nie prowadzi do obrazu, kończy żądanie bez obciążenia. od 1 elementów · do 3 elementów |
aspect_ratio | Nie | auto (domyślnie) zachowuje kształt pierwszego źródła: portret 880 x 1184 wyszedł jako 880 x 1184 w 1k i 1760 x 2368 w 2k. |
resolution | Nie | 1k (domyślnie) lub 2k, stosowane także przy auto. 2k kosztuje około cztery razy więcej za wynik i dwa razy więcej za każde źródło. |
output_format | Nie | JPEG (domyślnie), PNG lub WebP. Nie zmienia ceny. |
seed | Nie | Opcjonalny, od 0 do 2 147 483 647. Użyj go ponownie, by porównywać zmiany instrukcji; powtórzone edycje wychodziły zbliżone, ale nie zawsze identyczne co do piksela. |
Cennik
Rozliczane za obraz: opłata za poziom rozmiaru wyjścia oraz opłata za każde źródło, obie wyższe w 2k. Proporcje i format wyniku nie zmieniają ceny.
| Specyfikacja | Cena |
|---|---|
| $0.054 / obraz |
| $0.216 / obraz |
Zastosowania
Lookbooki i stylizacja
Umieść ubranie ze zdjęcia produktowego na modelce z innego zdjęcia, w nowym miejscu i świetle, do lookbooków i moodboardów.
Zmiany miejsca i garderoby
Przenieś osobę w nowe otoczenie i strój jednym przejściem, zachowując jej tożsamość, do kart postaci i serii.
Wskazówki
Używaj numerów obrazów
Pisz image 1, image 2 i image 3 w kolejności wgrania i nadaj każdemu rolę: kobieta z image 1, sukienka z image 2. Pierwszy obraz określa też kształt, gdy proporcje są ustawione na auto.
Najpierw chroń, potem zmieniaj
Zacznij od tego, co ma pozostać takie samo, na przykład twarz, włosy i sylwetka, a potem opisz zmianę: ubranie, miejsce, pozę i światło. Model może zostawić ubranie na miejscu, więc napisz dokładnie, co ta osoba ma mieć na sobie.
Uważaj na cenę za źródło
Każde źródło dolicza się do ceny, a 2k podwaja tę opłatę. Używaj jednego źródła, jeśli jedno wystarcza, i szkicuj w 1k.
Szybki start z API
# 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-klein-base/edit",
"input": {
"aspect_ratio": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# 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"
Uwierzytelnianie, pełny schemat, odpytywanie i obsługę błędów opisuje dokumentacja API.


























