Wprowadzenie
GPT Image 2.5 Sunburst Edycja obrazu stosuje gpt-image-2.5-sunburst od OpenAI do obrazów, które już masz. Przyjmuje od jednego do szesnastu źródeł, opcjonalną maskę PNG i opcję przezroczystego tła, a OpenAI poleca go wtedy, gdy najbardziej liczy się precyzja edycji.
Wybierz tryb według materiału wyjściowego
| Co masz | Tryb |
|---|---|
| pisemny brief | GPT Image 2.5 Sunburst Tekst na obraz |
| obraz do zmiany | GPT Image 2.5 Sunburst Edycja obrazu |
Najważniejsze funkcje
Maski, wierność i przezroczystość
Maska ogranicza przemalowanie do swoich przezroczystych pikseli; input_fidelity high trzyma twarze i tkaniny bliżej źródeł; background transparent zwraca prawdziwy kanał alfa w PNG lub WebP.
Do szesnastu źródeł
Łącz osoby, otoczenia i produkty z maksymalnie szesnastu obrazów w jednym żądaniu, wskazując każde źródło według kolejności w prompcie. Każde źródło dolicza stałą opłatę za wejście do każdego obrazu wyjściowego, więc dołączaj tylko te referencje, które mają znaczenie.
Precyzja to cel
W naszej edycji karmazynowej sukni zmieniła się tylko tkanina: koronkowe rękawy, twarz, krzesło i jedno główne światło zostały na swoich miejscach.
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
Retusz zaakceptowanych zdjęć
Zmień ubranie, kolor lub światło na zaakceptowanym zdjęciu bez dotykania reszty obrazu, z maską lub bez.
Wycinki do układów
Osoby i produkty zwracane na przezroczystym tle, gotowe do układu, slajdu lub strony produktu bez osobnego kroku usuwania tła.
Warianty kolorystyczne produktu
Jedno zdjęcie produktu w kilku wykończeniach lub kolorach, z maską na produkcie, by scenografia i światło pozostały identyczne.
Wskazówki
Zbuduj maskę pod źródło
Ten sam rozmiar w pikselach co pierwsze źródło, zapisany jako PNG, przezroczysty tylko tam, gdzie ma być przemalowanie. Wszystko nieprzezroczyste jest chronione.
Wypisz listę chronionych elementów
Po zmianie wymień, co musi zostać: twarz, włosy, pozę, krzesło, światło. Model trzyma się spisanej listy pewniej niż domyślnych oczekiwań.
Przy wycinkach napisz, co zostaje
Wskaż obiekt, który ma zostać, i że tło ma być całkowicie przezroczyste, a output_format ustaw na png lub webp.
Sprawdź kanał alfa przed składem
Otwórz zwrócony PNG lub WebP w programie do składu: pusty obszar to prawdziwy kanał alfa, więc nie potrzebujesz dodatkowego kluczowania ani maskowania.
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-sunburst/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.





