Wprowadzenie
FLUX.2 [klein] 4B, edycja obrazu zmienia lub łączy do trzech obrazów źródłowych za pomocą pisemnego polecenia w najmniejszym modelu FLUX.2 od Black Forest Labs, który jest open source na licencji Apache 2.0. Zachowaj kształt pierwszego obrazu przez auto albo wybierz proporcje i poziom rozmiaru 1k lub 2k. Każda edycja ma jedną stałą cenę za obraz i nie jest nakładany żaden filtr treści.
Wybierz tryb według materiału wyjściowego
| Co masz | Tryb |
|---|---|
| pisemny opis | FLUX.2 Klein 4B, tekst na obraz |
| od jednego do trzech obrazów do zmiany lub połączenia | FLUX.2 Klein 4B, edycja obrazu |
Najważniejsze funkcje
Do trzech obrazów referencyjnych
Połącz dwa portrety i lokalizację albo przestylizuj jedno zdjęcie. Cena nie zmienia się z liczbą źródeł.
Edycje, które zachowują osoby
Poproś o nowe tło, światło lub pogodę i zachowaj twarze, ubrania i pozę. Z jednym źródłem działa to czysto; przy trzech twarze mogą się lekko rozjeżdżać.
Otwarty, bez filtra
Nic nie jest weryfikowane ani odrzucane. W naszych testach edycje zachowywały nieprzefiltrowane źródło bez zmian; złagodzony został tylko poziom Bardzo silny.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
prompt | Tak | Napisz, co ma się zmienić i co ma pozostać bez zmian, do 5000 znaków. Przy kilku źródłach odwołuj się do nich jako image 1, image 2 i image 3. od 1 znaków · do 5000 znaków |
image_urls | Tak | Od jednego do trzech obrazów źródłowych, każdy do 10 MB, w kolejności, w jakiej odwołuje się do nich prompt. Wymagane. od 1 elementów · do 3 elementów |
aspect_ratio | Nie | Auto (domyślnie) zachowuje kształt pierwszego źródła w około jednym megapikselu. Albo wybierz jedną z dziewięciu proporcji od 21:9 do 9:21. |
resolution | Nie | 1k (domyślnie) lub 2k, czyli 2048 pikseli po dłuższym boku. Obowiązuje tylko wtedy, gdy wybierzesz proporcje; przy auto rozmiar to około jeden megapiksel. |
seed | Nie | Liczba od 0 do 2147483647. Użyj jej ponownie, żeby porównywać edycje, gdy zmieniasz jeden szczegół promptu. |
Cennik
$0.013 / obraz
Rozliczane za obraz według jednej stałej ceny, niezależnie od liczby obrazów źródłowych i poziomu rozmiaru. Za nieudane żądania nie pobieramy opłaty.
Zastosowania
Zmiany tła i nastroju
Przenieś parę ze słonecznej ulicy w deszczową neonową noc jednym przebiegiem.
Wprowadzanie osób do miejsca
Umieść dwa portrety na zdjęciu lokalizacji, do storyboardów, okładek i arkuszy postaci.
Szybkie zmiany stylu
Zmień światło, porę roku lub paletę, podczas gdy kompozycja zostaje.
Wskazówki
Najpierw chroń, potem zmieniaj
Zacznij od tego, co musi pozostać takie samo, a potem opisz tylko zmianę. Krótkie, konkretne polecenia sprawdzają się najlepiej.
Daj każdemu źródłu rolę
Przy kilku obrazach napisz, co wnosi każdy z nich: ta osoba, tamta osoba, to miejsce.
Sprawdź szczegóły
Przy dwóch lub trzech źródłach przyjrzyj się dłoniom, włosom i akcesoriom; może pojawić się drobny dodatkowy przedmiot. Uruchom inny seed, jeśli coś jest nie tak.
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-2-klein-4b/edit",
"input": {
"aspect_ratio": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"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.
