Wprowadzenie
Sunburst w trybie tekst na obraz zaczyna od Twojego opisu, bez obrazu wejściowego. Wariant nastawiony na precyzję oferuje pięć ustawień jakości do regulacji szczegółowości oraz rozmiary wyników do około 8,3 megapiksela.
| Pole | Wartość |
|---|---|
| Wejście | Tekst |
| Wyjście | Obraz |
| Wydawca | OpenAI |
| Data wydania | 2026-11-05 |
| Model API | gpt-image-2.6-sunburst |
| Publiczne endpointy | openai/gpt-image-2.6-sunburst/text-to-image; openai/gpt-image-2.6-sunburst/edit |
| Jakość | low, medium (domyślnie), high, xhigh, max |
| Rozdzielczość | 1k: około 1 MP; 2k: około 3,7 MP; 4k: około 8,3 MP |
| Wymiary przy 16:9 | 2k: 2560 x 1440; 4k: 3840 x 2160 |
| Proporcje | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21, 2:1, 1:2, 3:1, 1:3, 5:4, 4:5 |
| Liczba wyników | 1–10 obrazów na żądanie |
| Źródła do edycji | 1–16 obrazów wejściowych |
| Maska | Opcjonalny PNG o wymiarach pierwszego obrazu; przezroczyste piksele wskazują obszar do przemalowania |
| Tło | auto, opaque, transparent; przezroczystość wymaga PNG lub WebP |
| Formaty plików | PNG (domyślnie), JPEG, WebP; GIF (tylko generowanie z tekstu) |
Najważniejsze funkcje
Obrót na balkonie
Pętla Sunburst pokazuje obrót od nocnej panoramy miasta do uśmiechu w stronę aparatu na balkonie. Określona kolejność działań pomaga Sunburst precyzyjnie zaplanować pętlę animacji.
Toast w klubie jazzowym
Animacja Sunburst łączy uniesienie kieliszka, figlarne mrugnięcie i uśmiech w barze jazzowym. Określona kolejność działań pomaga Sunburst precyzyjnie zaplanować pętlę animacji.
Zmiana płaszcza w Paryżu
Instrukcja edycji Sunburst określa, co zachować w postaci, zanim wprowadza płaszcz i deszczową scenerię.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
prompt | Tak | Wymagany opis sceny Sunburst do 5000 znaków, bez domyślnego tekstu; tokeny promptu są płatne, więc dłuższe prompty Sunburst kosztują nieco więcej. od 1 znaków · do 5000 znaków |
aspect_ratio | Nie | Sunburst domyślnie używa 1:1 dla obrazów statycznych i oferuje 15 proporcji od 1:3 do 3:1; dla GIF-a musisz podać |
resolution | Nie | Sunburst: dla obrazów statycznych wybierz 1k, 2k lub 4k; w GIF-ach resolution oznacza rozmiar jednej klatki: 512 (około 0,26 MP) pozwala na maksymalnie 16 klatek, a 768 (około 0… |
quality | Nie | Ustaw szczegółowość Sunburst na low, medium (domyślnie), high, xhigh lub max; wyższe poziomy zwiększają szczegółowość, czas renderowania i cenę. |
reasoning_effort | Nie | Sunburst: |
num_outputs | Nie | Zamów w Sunburst 1–10 obrazów na żądanie; tutaj nie określono domyślnej liczby, a każdy obraz wynikowy podlega opłacie. |
background | Nie | Sunburst obsługuje auto, opaque i transparent; przezroczystość wymaga PNG lub WebP i nie łączy się z GIF-em. |
output_format | Nie | Sunburst domyślnie zwraca png, obsługuje też jpeg, webp i gif; animowany GIF jest dostępny tylko przy generowaniu z tekstu i nie obsługuje przezroczystego tła. |
frame_count | Nie | Sunburst: |
frame_duration_ms | Nie | Sunburst: |
output_quality | Nie | Ustaw kompresję JPEG lub WebP dla Sunburst od 0 do 100: wyższa wartość zachowuje więcej szczegółów w większym pliku, PNG i GIF ją pomijają, a cena Sunburst się nie zmienia. |
Cennik
Sunburst rozlicza tokeny faktycznie użyte przez każde żądanie: tekst promptu oraz tokeny obrazu gotowego wyniku. Cena podana dla poziomu jakości i rozdzielczości dotyczy kwadratowego obrazu Sunburst, dlatego inne proporcje zwykle kosztują mniej. Zamówienie większej liczby obrazów Sunburst sumuje ich tokeny, a tokeny promptu są naliczane ponownie dla każdego obrazu. Sunburst rezerwuje maksymalną kwotę na początku zadania i zwraca niewykorzystaną część po jego zakończeniu. Za odrzucone żądania Sunburst nie pobiera się opłat. GIF-y w Sunburst są rozliczane tak samo: klatki współdzielą arkusze, więc więcej klatek zwykle oznacza więcej tokenów obrazu.
| Rozdzielczość | Jakość: low | Jakość: medium | Jakość: high | Jakość: xhigh | Jakość: max |
|---|---|---|---|---|---|
| $0.02232 / obraz | $0.03915 / obraz | $0.04743 / obraz | $0.08433 / obraz | $0.18972 / obraz |
| $0.027 / obraz | $0.04752 / obraz | $0.05742 / obraz | $0.10206 / obraz | $0.22941 / obraz |
| $0.04131 / obraz | $0.07299 / obraz | $0.08847 / obraz | $0.15723 / obraz | $0.35379 / obraz |
| $0.04392 / obraz | $0.07776 / obraz | $0.09432 / obraz | $0.1674 / obraz | $0.37638 / obraz |
| $0.07479 / obraz | $0.13221 / obraz | $0.16011 / obraz | $0.28512 / obraz | $0.64044 / obraz |
Zastosowania
Grafiki do kampanii turystycznych
Stwórz nadmorski plakat z nazwą miejscowości, krótkim nagłówkiem i określoną paletą barw.
Grafiki z menu kawiarni
Opisz układ tablicy z pozycjami menu w cudzysłowach i wyraźnie określoną poranną scenerią.
Edycja portretów
Przenieś dostarczony portret na deszczową ulicę, wskazując, co ma pozostać zgodne ze źródłem.
Wskazówki
Opisz zamysł wizualny
Opisz temat, materiały i światło, a potrzebne krótkie napisy ujmij w cudzysłowy.
Dobierz szczegółowość i wymiary
Zacznij od jakości medium i wybierz 1k, 2k lub 4k zależnie od miejsca wykorzystania obrazu.
Określ zakres edycji
Przy edycji umieść źródło na początku i opisz, co ma zostać zachowane, zanim wskażesz zmianę.
Zaznacz wybrany obszar
Jeśli zmiana dotyczy konkretnego miejsca, dostarcz maskę PNG o wymiarach pierwszego obrazu.
Wprowadzenie
W Sunburst precyzyjnie opisz scenę i kolejność ruchów przed wygenerowaniem obrazu.
Funkcje
- Sunburst oferuje 1k, 2k i 4k dla obrazów statycznych oraz pięć poziomów jakości.
- Pętle GIF w Sunburst: opisz ruch i powtórzenie, wybierz
output_format: gif oraz podajaspect_ratio. - Sunburst: dla obrazów statycznych wybierz 1k, 2k lub 4k; w GIF-ach resolution oznacza rozmiar jednej klatki: 512 (około 0,26 MP) pozwala na maksymalnie 16 klatek, a 768 (około 0,59 MP) na 12.
- Sunburst:
frame_countprzyjmuje od 2 do 16 klatek, domyślnie 9; limit zależy od wybranego rozmiaru klatki. - Sunburst:
frame_duration_msustawia od 20 do 2000 ms na klatkę, domyślnie 200 ms. - W Sunburst GIF jest rozliczany według arkuszy po 8 klatek i poziomu jakości: 9 klatek wymaga 2 arkuszy.
- Sunburst domyślnie zwraca png, obsługuje też jpeg, webp i gif; animowany GIF jest dostępny tylko przy generowaniu z tekstu i nie obsługuje przezroczystego tła.
Wskazówki
- W Sunburst dopasuj
reasoning_effortdo kompozycji: high jest domyślny i pomaga przy gęstym tekście; dokładniejsze planowanie trwa dłużej, ale nie zmienia kosztu.
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.6-sunburst/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"quality": "medium",
"background": "auto",
"resolution": "1k",
"num_outputs": 1,
"aspect_ratio": "1:1"
}
}'
# 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.
