OpenAI: GPT Image 2.5 Sunburst
GPT Image 2.5 Sunburst generuje i edytuje obrazy na podstawie tekstu i referencji wizualnych, z naciskiem na precyzję edycji. Obsługuje maski, stopniowe dopracowywanie wyników, niestandardowe wymiary kadru, przezroczyste tła i poziomy jakości od low do max.
O modelu
Ten opis przedstawia możliwości modelu. Dane wejściowe, wyniki i opcje dostępne w Ailoot podano poniżej dla wybranej metody.
GPT Image 2.5 Sunburst to model OpenAI do generowania i edycji obrazów, ukierunkowany na precyzję. Przyjmuje tekst i obrazy, a wyniki zwraca w postaci obrazów. Używaj go, gdy zadanie twórcze wymaga starannej modyfikacji istniejącego materiału, pracy z referencjami wizualnymi lub dopracowywania kompozycji w kilku krokach. Opis może prowadzić do utworzenia nowej sceny, przekształcenia istniejącego obrazu lub edycji wybranego obszaru. Sunburst i Flare to osobne wersje: Sunburst kładzie nacisk na precyzję edycji, a Flare jest przeznaczony do szybkiego codziennego generowania.
Przy nowym obrazie opisz główny obiekt, otoczenie, kompozycję, oświetlenie i styl, a następnie określ zamierzony kształt i zastosowanie. W koncepcji produktu poproś o szklaną lampę na kamiennej powierzchni, z miękkim światłem z boku, wyraźnie widoczną sylwetką i wolną przestrzenią na nagłówek. Przy edycji nazwij zmianę i elementy, które powinny pozostać rozpoznawalne: wymień tło, dostosuj światło lub zmień materiał, zachowując wybraną kompozycję. Bezpośrednie procesy generowania i edycji producenta dopuszczają prompt do 32 000 znaków i od jednego do dziesięciu wyników.
Edycja z referencjami może używać do szesnastu obrazów wejściowych. Przypisz każdemu obrazowi rolę, aby instrukcja rozróżniała obiekt do zachowania, otoczenie do wykorzystania i styl do zastosowania. Model może też pracować z maską wskazującą obszar do zmiany. Źródło i maska muszą mieć ten sam format i wymiary, a maska musi zawierać kanał alfa; przewodnik określa wymóg rozmiaru poniżej 50 MB. Przy kilku obrazach źródłowych maska dotyczy pierwszego. Ukierunkowuje żądaną zmianę, ale nie gwarantuje sztywnej granicy, dlatego w opisie uwzględnij instrukcje zachowania elementów i sprawdź otoczenie zmienionego obszaru w wyniku.
Ustawienia jakości to low, medium, high, xhigh, max i auto, z auto jako wartością domyślną. Low może służyć do szybkiego szkicu wizualnego, a wyższe ustawienia warto porównać, gdy znaczenie mają drobne szczegóły. Jakość jest niezależna od wymiarów wyniku i kompresji pliku. Standardowe rozmiary obejmują 1024 × 1024, 1536 × 1024 i 1024 × 1536 pikseli; dostępne są też wymiary automatyczne lub niestandardowe. Dobierz kształt do końcowego układu, zanim zdecydujesz, jak szczegółowy powinien być obraz.
Niestandardowe wymiary muszą być wielokrotnościami szesnastu pikseli, żaden bok nie może przekraczać 3840 pikseli, proporcje muszą mieścić się między 1:3 a 3:1, a całkowite pole obrazu musi wynosić od 655 360 do 8 294 400 pikseli. Wszystkie te warunki obowiązują jednocześnie. Poziomy obraz 3840 × 2160 mieści się w górnym limicie pola, natomiast sama długość dłuższego boku nie sprawia, że dowolna para wymiarów jest poprawna. Rozdzielczości powyżej 2560 × 1440 są opisane jako eksperymentalne. Umieść ważne obiekty, tekst i przydatną wolną przestrzeń w zamierzonym kadrze, zamiast oczekiwać, że większa liczba pikseli rozwiąże problemy kompozycji.
Domyślnym formatem wyniku jest PNG; obsługiwane są też JPEG i WebP. Dla JPEG i WebP można wybrać kompresję od 0 do 100. Tła przezroczyste, nieprzezroczyste i automatyczne odpowiadają różnym potrzebom układu. Przy przezroczystości wybierz PNG lub WebP, aby wynik mógł zachować kanał alfa. Przezroczysty element można następnie umieścić w innej kompozycji, podczas gdy nieprzezroczysty obraz zawiera własne tło. Przechowuj właściwy ukończony plik wraz z opisem i wybranymi ustawieniami wyniku.
OpenAI dokumentuje bezpośrednie generowanie i edycję oraz konwersacyjne narzędzie do generowania obrazów, które może zachowywać wcześniejsze wyniki i stosować kolejne instrukcje. W tym procesie konwersacyjnym działanie może być automatyczne albo wymuszać generowanie lub edycję, gdy obraz znajduje się w kontekście. Używaj wybranego obrazu jako punktu wyjścia do kolejnej zmiany, zamiast bez wyjaśnienia przechodzić do innego wariantu. Udokumentowany proces strumieniowania może dostarczyć do trzech obrazów częściowych przed wynikiem końcowym; częściowy podgląd pokazuje postęp, ale nie jest gotowym materiałem. Interfejs producenta obsługuje również przetwarzanie wsadowe.
Sprawdź edytowany obiekt, napisy, rozmieszczenie przedmiotów i granicę zmiany wskazanej maską w docelowym rozmiarze wyświetlania. GPT Image nadal może mieć trudności z precyzyjnym umiejscowieniem tekstu, uporządkowanymi układami lub spójnością powracających obiektów i elementów marki. Kolejna precyzyjna instrukcja powinna wskazywać widoczny problem i elementy do zachowania. Sunburst przydaje się w dokładnej pracy twórczej opartej na referencjach, której końcowy rezultat można ocenić względem konkretnego opisu wizualnego, dobierając do niego wyższą jakość, wymiary i przezroczystość.
Ailoot Ultra · Obrazy POST /v1/images/generations openai/gpt-image-2.5-sunburst
openai/gpt-image-2.5-sunburstStart
GPT Image 2.5 Sunburst generuje i edytuje obrazy na podstawie tekstu i referencji wizualnych, z naciskiem na precyzję edycji. Obsługuje maski, stopniowe dopracowywanie wyników, niestandardowe wymiary kadru, przezroczyste tła i poziomy jakości od low do max.
- Akceptowane dane wejściowe
- Tekst · Obrazy
- Wyniki
- Obrazy
Dostępne w Ailoot · dane wejściowe i metody
Ailoot Ultra · Obrazy POST /v1/images/generations
- Wejście
text,image- Wyjście
image
| Pole | Typ | Wymaganie | Wartości i limity | Domyślnie |
|---|---|---|---|---|
Polemodel | Typstring | WymaganieWymagane | Wartości i limity openai/gpt-image-2.5-sunburst | Domyślnie— |
Poleprompt | Typstring | WymaganieWymagane | Wartości i limity Minimalna długość: 1 | Domyślnie— |
Poleaspect_ratio | Typstring | WymaganieOpcjonalne | Wartości i limity 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, auto | Domyślnie— |
Polequality | Typstring | WymaganieOpcjonalne | Wartości i limity auto, low, medium, high, xhigh, max | Domyślnie— |
Polebackground | Typstring | WymaganieOpcjonalne | Wartości i limity auto, transparent, opaque | Domyślnie— |
Polen | Typinteger | WymaganieOpcjonalne | Wartości i limity Minimum: 1 Maksimum: 10 | Domyślnie— |
Poleinput_references | Typarray | WymaganieOpcjonalne | Wartości i limity Minimalna liczba elementów: 0 Maksymalna liczba elementów: 16 | Domyślnie— |
Poleoutput_compression | Typinteger | WymaganieOpcjonalne | Wartości i limity Minimum: 0 Maksimum: 100 | Domyślnie— |
Poleprovider | Typobject | WymaganieOpcjonalne | Wartości i limity | Domyślnie— |
Parametry i cykl życia metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, prompt |
Parametrmaterial_types | Kontrakttext, image |
Cykl życia: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Rzeczywiście zwrócony task_id lub wpis w bibliotece multimediów
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Cennik
Jak obliczana jest ostateczna opłata
Wyświetlane stawki służą do oszacowania kosztu przed generowaniem. Ostateczna opłata jest obliczana na podstawie kosztu zarejestrowanego dla pierwotnego generowania. Zmierzony czas trwania wyniku i prognozowane ilości nie stanowią ostatecznej ilości podlegającej rozliczeniu.
Informacje taryfowe nie dodają opcji żądania. Obsługiwane parametry podano przy wybranej metodzie.
- Tryb szybki
- Nie określono Gdy wybrany jest tryb szybki
- Tryb flex
- Nie określono Gdy wybrany jest tryb flex
- Maksymalna intensywność rozumowania
- Nie określono Gdy dla maksymalnej intensywności rozumowania stosowana jest domyślna korekta (default)
Szacunkowe stawki do porównania
Ceny według konfiguracji
Dopasuj każdą opłatę do pokazanych warunków. Użyj jednej stawki dla każdego zestawu alternatywnych konfiguracji.
| Konfiguracja | Tabela stawek | Przewidywana ilość | Opłata |
|---|---|---|---|
| KonfiguracjaBazowe stawki za tokeny | Tabela stawekStawka podstawowa | Przewidywana ilość— | Opłata Wejście · Tokeny wejściowe · Szacunek tylko do porównania — / 1K tokenów Wyjście · Tokeny wyjściowe · Szacunek tylko do porównania — / 1K tokenów Wejście · Odczyt cache · Szacunek tylko do porównania — / 1K tokenów Wejście · Zapis do cache · Szacunek tylko do porównania — / 1K tokenów Wejście · Zapis do cache, 1 godz. · Szacunek tylko do porównania — / 1K tokenów |
| KonfiguracjaSzacowany koszt generowania | Tabela stawek— | Przewidywana ilośćszacunek dla jednego generowania | Opłata Wyjście · Szacowany koszt generowania · Szacunek tylko do porównania $0.24576 szacunek przed generowaniem Ten szacunek nie jest dodatkową opłatą ani stałą stawką za ukończone generowanie. |
Ailoot rezerwuje szacowaną kwotę przed żądaniem. Po otrzymaniu wyniku rozlicza ostateczną opłatę według zmierzonego użycia. Rozliczenie strumieniowania korzysta z końcowego rekordu użycia. Jak działają rezerwacja i rozliczenie →
Przykładowe żądania
Ailoot Ultra · Obrazy
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'openai/gpt-image-2.5-sunburst', 'prompt': 'a red panda astronaut floating in space, studio lighting'}
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin
def save_images(items):
if not items: raise SystemExit("No completed images; retain the full response")
for index, item in enumerate(items):
encoded=item.get("b64_json")
uri=item.get("url", "")
if not encoded and uri.startswith("data:image/"):
header, separator, encoded=uri.partition(",")
if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
if encoded:
raw=base64.b64decode(encoded,validate=True)
elif uri:
uri=urljoin("https://api.ailoot.ai",uri)
parsed=urlsplit(uri)
if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
raise SystemExit("Invalid returned image URL")
owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
args=["curl","--fail-with-body","--silent","--show-error",uri]
if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
temporary=Path(f"image-{index}.bin")
subprocess.run(args+["-o",str(temporary)],check=True)
raw=temporary.read_bytes()
temporary.unlink()
else: raise SystemExit("Image has neither bytes nor URL")
if not raw: raise SystemExit("Empty image result")
ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
Path(f"image-{index}.{ext}").write_bytes(raw)
print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
Odbieranie i zapisywanie wyników
Ailoot Ultra · Obrazy
Pobierz każdy zwrócony obraz lub zapisz jego zawartość Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Inne odczyty treści
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
Zachowaj wszystkie ukończone wyniki
Zapisz każdy ukończony obraz; pobierz każdy zwrócony URL lub zdekoduj zawartość Base64.
Zachowaj pełną odpowiedź i nagłówki, wszystkie rzeczywiście uzyskane wyniki, pierwotnie zwrócone identyfikatory oraz wszystkie pola zużycia. Odzyskaj pierwotną operację bez ponownego wysyłania żądania utworzenia.
Jeśli trzeba sprawdzić pierwotną odpowiedź
Zachowaj zwrócony X-Client-Request-ID do uzgodnienia danych. Odczytuj wyłącznie rzeczywiście zwrócone wartości task_id/asset_id lub własną bibliotekę multimediów; nigdy nie buduj adresu URL zadania na podstawie identyfikatora operacji i nigdy nie wysyłaj ponownie żądania utworzenia.
Pola odpowiedzi
| Pole | Typ |
|---|---|
Polecreated | Typ |
Poledata[].url | Typ |
Poledata[].b64_json | Typ |
Poleusage | Typ |
Aliasy
Aliasy modelu
Ailoot Ultra openai/gpt-image-2.5-sunburst
Aliasy ścieżek metod
/v1/images
Powiązane ID modeli
FAQ · OpenAI: GPT Image 2.5 Sunburst
- Jakie dane wejściowe i wyniki są dostępne?
POST /v1/images/generations·openai/gpt-image-2.5-sunburst:text,image→image- Jakich pól używa żądanie?
POST /v1/images/generations·openai/gpt-image-2.5-sunburst:model,prompt,aspect_ratio,quality,background,n,input_references,output_compression,provider- Jakie limity obowiązują?
POST /v1/images/generations·openai/gpt-image-2.5-sunburst:n.minimum:1;n.maximum:10;output_compression.minimum:0;output_compression.maximum:100