Wprowadzenie
GPT Image 2.5 Flare Edycja obrazu stosuje gpt-image-2.5-flare od OpenAI do obrazów, które już masz. Przyjmuje od jednego do szesnastu źródeł, maskę PNG i opcję przezroczystego tła, a edycje zwraca na tyle szybko, że nadaje się do pracy interaktywnej.
Wybierz tryb według materiału wyjściowego
| Co masz | Tryb |
|---|---|
| pisemny brief | GPT Image 2.5 Flare Tekst na obraz |
| obraz do zmiany | GPT Image 2.5 Flare Edycja obrazu |
Najważniejsze funkcje
Szybkie kompozycje z wielu źródeł
Dwa lub więcej źródeł staje się jedną sceną, a twarze zostają zachowane ze swoich obrazów. Nasz przykład z dwoma źródłami zakończył się w znacznie mniej niż minutę.
Maski i wycinki
Maska PNG ogranicza przemalowanie do jednego obszaru; background transparent zwraca prawdziwy kanał alfa w PNG lub WebP, gotowy do układu bez kluczowania.
Kilka zmian w jednym przebiegu
Strój, pora dnia i pogoda mogą zmienić się razem, o ile prompt mówi też, co ma zostać bez zmian. Nasz przykład z tarasem zmienił suknię i światło w jednym żądaniu.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
prompt | Tak | Do 5000 znaków. Każde słowo, które ma pojawić się na obrazie, ujmij w podwójny cudzysłów i napisz, gdzie ma się znaleźć; reszta jest czytana jako opis. od 1 znaków · do 5000 znaków |
image_urls | Tak | Od 1 do 16 obrazów źródłowych. W prompcie odwołuj się do nich według kolejności (pierwszy obraz, drugi obraz). od 1 elementów · do 16 elementów |
mask_url | Nie | Opcjonalny PNG w tym samym rozmiarze co pierwszy obraz źródłowy. Przezroczyste piksele wskazują obszar do przemalowania, nieprzezroczyste zostają bez zmian. |
aspect_ratio | Nie | Piętnaście proporcji od 1:3 do 3:1, domyślnie 1:1. Wynik dostaje wybrane proporcje, nie proporcje źródła, a proporcje wpływają na cenę. |
resolution | Nie | 1k (domyślnie), 2k lub 4k. Kwadratowy obraz ma bok 1024, 2048 lub 2880 pikseli; wyższy poziom kosztuje więcej za obraz. |
quality | Nie | low, medium, high (domyślnie), xhigh lub max. Każdy poziom dodaje szczegółów, czasu i kosztu; zachowaj xhigh i max na wersje końcowe. |
num_outputs | Nie | Od 1 do 10 obrazów na żądanie, domyślnie 1. Każdy obraz jest rozliczany osobno. |
input_fidelity | Nie | low (domyślnie) lub high. High wierniej zachowuje twarze, tkaniny i nadrukowane detale ze źródeł. |
background | Nie | auto (domyślnie), transparent lub opaque. Transparent wymaga wyjścia png lub webp i zwraca prawdziwy kanał alfa. |
output_format | Nie | png (domyślnie), jpeg lub webp. Nie zmienia ceny. |
output_quality | Nie | Jakość kompresji dla jpeg i webp, od 0 do 100: wyższe wartości zachowują więcej szczegółów i dają większe pliki. Nie działa z png i nie zmienia ceny. |
official_fallback | Nie | Domyślnie włączone. Domyślnie: |
Cennik
Rozliczenie za obraz wyjściowy według jakości, poziomu rozmiaru i proporcji; na oficjalnej trasie każdy obraz źródłowy dodaje też stałą opłatę za każdy obraz wyjściowy. Wycena pokazuje sumę przed wysłaniem. Żądanie o jedną edycję z wynikiem PNG w jakości high i rozmiarze 1k, w proporcjach 1:1, 3:2, 2:3, 4:3, 3:4, 16:9 lub 9:16, bez maski, z input fidelity low i background auto zaczyna się na trasie ekonomicznej, po cenie ekonomicznej. Przy włączonej opcji Official fallback (domyślnie włączona) żądanie, które ta trasa odrzuci albo którego nie zrealizuje, jest wykonywane ponownie na oficjalnej trasie po cenie oficjalnej, dlatego wycena pokazuje cenę startową i maksymalną kwotę. Odrzucone żądania nie są rozliczane. Na oficjalnej trasie długie prompty dodają niewielką opłatę za tokeny wejściowe ponad pierwsze 100, raz na żądanie; tekst chiński, japoński i koreański liczy się mniej więcej jako jeden token na znak.
| Specyfikacja | Cena |
|---|---|
| $0.001816 / obraz |
| $0.001816 / obraz |
| $0.00244 / obraz |
| $0.00244 / obraz |
| $0.002752 / obraz |
| $0.002752 / obraz |
| $0.00304 / obraz |
| $0.00304 / obraz |
| $0.003568 / obraz |
| $0.003568 / obraz |
| $0.003808 / obraz |
| $0.003808 / obraz |
| $0.003856 / obraz |
| $0.003856 / obraz |
| $0.004192 / obraz |
| $0.004192 / obraz |
| $0.004744 / obraz |
| $0.004744 / obraz |
| $0.005104 / obraz |
| $0.00568 / obraz |
| $0.00568 / obraz |
| $0.00652 / obraz |
| $0.00652 / obraz |
| $0.007312 / obraz |
| $0.007312 / obraz |
| $0.008176 / obraz |
| $0.008176 / obraz |
| $0.008728 / obraz |
| $0.008728 / obraz |
| $0.010936 / obraz |
| $0.01396 / obraz |
| $0.01396 / obraz |
| $0.018592 / obraz |
| $0.018592 / obraz |
| $0.020998 / obraz (Z opcją Official fallback: do $0.023992) |
| $0.020998 / obraz (Z opcją Official fallback: do $0.023992) |
| $0.021472 / obraz |
| $0.021472 / obraz |
| $0.022 / obraz (Z opcją Official fallback: do $0.028) |
| $0.022 / obraz (Z opcją Official fallback: do $0.028) |
| $0.022864 / obraz (Z opcją Official fallback: do $0.031456) |
| $0.022864 / obraz (Z opcją Official fallback: do $0.031456) |
| $0.024136 / obraz |
| $0.024136 / obraz |
| $0.025636 / obraz (Z opcją Official fallback: do $0.042544) |
| $0.0316 / obraz |
| $0.0316 / obraz |
| $0.034504 / obraz |
| $0.034504 / obraz |
| $0.037864 / obraz |
| $0.037864 / obraz |
| $0.043504 / obraz |
| $0.043504 / obraz |
| $0.049816 / obraz |
| $0.049816 / obraz |
| $0.054616 / obraz |
| $0.054616 / obraz |
| $0.055624 / obraz |
| $0.055624 / obraz |
| $0.059872 / obraz |
| $0.059872 / obraz |
| $0.07144 / obraz |
| $0.07144 / obraz |
| $0.075328 / obraz |
| $0.082936 / obraz |
| $0.082936 / obraz |
| $0.096472 / obraz |
| $0.096472 / obraz |
| $0.110728 / obraz |
| $0.110728 / obraz |
| $0.124624 / obraz |
| $0.124624 / obraz |
| $0.135064 / obraz |
| $0.135064 / obraz |
| $0.168976 / obraz |
| $0.002872 / obraz |
| $0.002872 / obraz |
| $0.004456 / obraz |
| $0.004456 / obraz |
| $0.005152 / obraz |
| $0.005152 / obraz |
| $0.005704 / obraz |
| $0.005704 / obraz |
| $0.006328 / obraz |
| $0.006328 / obraz |
| $0.006712 / obraz |
| $0.006712 / obraz |
| $0.007312 / obraz |
| $0.007312 / obraz |
| $0.008128 / obraz |
| $0.008128 / obraz |
| $0.009088 / obraz |
| $0.009088 / obraz |
| $0.009928 / obraz |
| $0.01108 / obraz |
| $0.01108 / obraz |
| $0.01276 / obraz |
| $0.01276 / obraz |
| $0.014176 / obraz |
| $0.014176 / obraz |
| $0.015904 / obraz |
| $0.015904 / obraz |
| $0.017296 / obraz |
| $0.017296 / obraz |
| $0.021808 / obraz |
| $0.024112 / obraz |
| $0.024112 / obraz |
| $0.03688 / obraz |
| $0.03688 / obraz |
| $0.041896 / obraz |
| $0.041896 / obraz |
| $0.043072 / obraz |
| $0.043072 / obraz |
| $0.048064 / obraz |
| $0.048064 / obraz |
| $0.055432 / obraz |
| $0.055432 / obraz |
| $0.062416 / obraz |
| $0.062416 / obraz |
| $0.062944 / obraz |
| $0.062944 / obraz |
| $0.067984 / obraz |
| $0.067984 / obraz |
| $0.07624 / obraz |
| $0.07624 / obraz |
| $0.086032 / obraz |
| $0.087496 / obraz |
| $0.087496 / obraz |
| $0.095248 / obraz |
| $0.095248 / obraz |
| $0.098968 / obraz |
| $0.098968 / obraz |
| $0.110656 / obraz |
| $0.110656 / obraz |
| $0.121312 / obraz |
| $0.121312 / obraz |
| $0.142816 / obraz |
| $0.142816 / obraz |
| $0.152632 / obraz |
| $0.171016 / obraz |
| $0.171016 / obraz |
| $0.19456 / obraz |
| $0.19456 / obraz |
| $0.220456 / obraz |
| $0.220456 / obraz |
| $0.248464 / obraz |
| $0.248464 / obraz |
| $0.274216 / obraz |
| $0.274216 / obraz |
| $0.342928 / obraz |
| $0.003736 / obraz |
| $0.003736 / obraz |
| $0.006016 / obraz |
| $0.006016 / obraz |
| $0.0076 / obraz |
| $0.0076 / obraz |
| $0.008368 / obraz |
| $0.008368 / obraz |
| $0.009304 / obraz |
| $0.009304 / obraz |
| $0.011176 / obraz |
| $0.011176 / obraz |
| $0.01192 / obraz |
| $0.01192 / obraz |
| $0.0124 / obraz |
| $0.0124 / obraz |
| $0.01324 / obraz |
| $0.01324 / obraz |
| $0.016216 / obraz |
| $0.0166 / obraz |
| $0.0166 / obraz |
| $0.02116 / obraz |
| $0.02116 / obraz |
| $0.023872 / obraz |
| $0.023872 / obraz |
| $0.026296 / obraz |
| $0.026296 / obraz |
| $0.028552 / obraz |
| $0.028552 / obraz |
| $0.032272 / obraz |
| $0.032272 / obraz |
| $0.035992 / obraz |
| $0.050776 / obraz |
| $0.050776 / obraz |
| $0.056176 / obraz |
| $0.056176 / obraz |
| $0.0652 / obraz |
| $0.0652 / obraz |
| $0.080464 / obraz |
| $0.080464 / obraz |
| $0.086752 / obraz |
| $0.086752 / obraz |
| $0.094288 / obraz |
| $0.094288 / obraz |
| $0.103984 / obraz |
| $0.103984 / obraz |
| $0.11296 / obraz |
| $0.11296 / obraz |
| $0.115576 / obraz |
| $0.115576 / obraz |
| $0.127864 / obraz |
| $0.127864 / obraz |
| $0.14272 / obraz |
| $0.14272 / obraz |
| $0.14272 / obraz |
| $0.168592 / obraz |
| $0.168592 / obraz |
| $0.184552 / obraz |
| $0.184552 / obraz |
| $0.197104 / obraz |
| $0.197104 / obraz |
| $0.201832 / obraz |
| $0.201832 / obraz |
| $0.253408 / obraz |
| $0.259552 / obraz |
| $0.259552 / obraz |
| $0.320608 / obraz |
| $0.320608 / obraz |
| $0.37588 / obraz |
| $0.37588 / obraz |
| $0.414736 / obraz |
| $0.414736 / obraz |
| $0.456544 / obraz |
| $0.456544 / obraz |
| $0.569656 / obraz |
Zastosowania
Przymiarki i zmiany stylizacji
Pokaż tę samą osobę w nowym stroju lub w nowym miejscu do lookbooka albo szkicu kampanii, z kilkoma opcjami na żądanie.
Łączenie osób z osobnych zdjęć
Umieść dwie osoby sfotografowane osobno na jednym obrazie do plakatu, miniatury lub panelu relacji.
Sezonowe odświeżenia
Zamień obraz letniej kampanii w wersję jesienną lub nocną na kolejny sezon, z niezmienioną osobą i produktem.
Wskazówki
Daj każdemu źródłu zadanie
Mężczyzna i drzwi z pierwszego obrazu, kobieta z drugiego: napisz to, bo kolejność to jedyne powiązanie między promptem a źródłami.
Grupuj powiązane zmiany
Nowy strój i inna pora dnia dobrze wyrażają się w jednym żądaniu; niepowiązane zmiany działają lepiej jako osobne edycje.
Podnieś wierność dla twarzy
Ustaw input_fidelity na high, gdy twarz musi pozostać rozpoznawalna po edycji; cena się nie zmienia.
Maska do wymiany tła
Gdy ma się zmienić tylko tło, zostaw obiekt nieprzezroczysty, a tło przezroczyste w masce PNG w rozmiarze pierwszego źródła.
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": "openai/gpt-image-2.5-flare/edit",
"input": {
"aspect_ratio": "1:1",
"background": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"input_fidelity": "low",
"num_outputs": 1,
"output_format": "png",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# 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.





