GPT Image 2.6

GPT Image 2.6 przyjmuje prompty tekstowe i opcjonalne obrazy referencyjne. Wyślij raz do POST /v1/images/generations, zachowaj identyfikator zadania i odpytuj GET /v1/tasks/{id} o wynik. Gotowe pliki są zwracane jako linki.

ID modeli i ceny

Użyj GET /v1/models, aby znaleźć modele dostępne dla Twojego klucza. Skonfigurowane ID Sunburst to gpt-image-2.6-sunburst-official i gpt-image-2.6-sunburst. ID Flare, jeśli są na liście, korzystają z tego samego kontraktu parametrów. Sam identyfikator modelu używa swojej grupy Default; dodatkowe grupy korzystają z ID model:group zwróconego przez zapytanie o dostępne modele.

Sprawdź aktualne ceny i Playground. Modele rozliczane za tokeny naliczają rzeczywiste zużycie; modele rozliczane za obraz korzystają ze skonfigurowanej ceny obrazu. Odpowiedzi SVG raportują tokeny modelu piszącego kod osobno w svg_usage, rozliczane według własnej ceny tego modelu w SeedRouter.

Generowanie obrazu

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-sunburst-official",
    "prompt": "A red paper crane on a pale blue table, soft daylight",
    "size": "1024x1024",
    "quality": "low",
    "complexity": "high"
  }'

Odpowiedź zawiera id. Odpytuj ten identyfikator zamiast ponownie wysyłać żądanie generowania:

curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

Po zakończeniu output.data zawiera obiekty z url. Pobierz plik spod tego adresu, aby zachować oryginalny format, a w przypadku GIF każdą klatkę animacji. Nieudane zadanie ma error i nie jest naliczane. Zobacz stany zadań i odpytywanie.

Parametry

Jest 18 pól najwyższego poziomu. Wymagane są tylko model i prompt. Pola opcjonalne przyjmują null, co działa tak samo jak pominięcie. Nieznane pola są pomijane. Nieprawidłowe wartości obsługiwanych parametrów nie przechodzą walidacji przed generowaniem obrazu.

Linki referencyjne muszą używać HTTP lub HTTPS i nie mogą zawierać danych uwierzytelniających. ID plików, osadzony base64 i przesyłanie multipart nie są przyjmowane; najpierw prześlij pliki i podaj ich publiczne linki. Żądania korzystają z asynchronicznego odpytywania zadań zamiast stream lub partial_images. input_fidelity, response_format i prompt_rewriter nie są udostępniane w tym kontrakcie.

Rozmiar obrazu

Przy generowaniu PNG, JPEG i obrazu referencyjnego SVG każdy wymiar musi być podzielny przez 16 i nie większy niż 3840 pikseli. Łączna liczba pikseli musi wynosić 655 360–8 294 400, a proporcje muszą mieścić się między 1:3 a 3:1. Przykłady: 1024x1024, 1536x1024, 2160x3840, 2880x2880.

Wymiary GIF muszą być dodatnimi wielokrotnościami 16; można też użyć auto. GIF ma osobny łączny budżet pikseli dzielony przez liczbę klatek, wymiary klatek i n; OpenAI nie opublikowało jego limitu liczbowego. GIF 512x512 nie podlega regule minimalnej liczby pikseli obrazu statycznego.

Animowany GIF

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "A red paper crane flapping its wings in a seamless loop on pale blue",
  "output_format": "gif",
  "size": "512x512",
  "quality": "low",
  "frame_count": 4,
  "frame_duration_ms": 200
}

GIF można wygenerować z promptu lub zażądać go z obrazów referencyjnych. Nie łącz go z maską ani kompresją. Dostępność podglądu może zależeć od dostępu wybranego modelu.

Rozbieżność w dokumentacji, sprawdzono 5 listopada 2026: Przewodnik OpenAI po generowaniu obrazów podaje 2–64 klatki i 20–2000 ms oraz twierdzi, że punkt końcowy edycji nie zwraca GIF. Dokumentacja Images API podaje 2–16 klatek, bez maksymalnego czasu wyświetlania, i wymienia wynik GIF przy edycji. Żądania do bazowego API 5 listopada 2026 potwierdziły dokumentację: 17 klatek odrzucono, a klatkę z 3 000 ms przyjęto. To API stosuje reguły z dokumentacji.

SVG

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "A simple geometric red paper-crane logo, clean editable vector paths",
  "output_format": "svg",
  "n": 1
}

SVG jest dostępny tylko przy generowaniu i wymaga n: 1. Nie wysyłaj obrazów, maski, oznaczeń ani kompresji. Plik to statyczny XML w UTF-8 zawierający kształty wektorowe; skrypty, zasoby zewnętrzne i osadzone obrazy rastrowe nie są obsługiwane.

Gdy wybór modelu piszącego kod jest dostępny, dodaj svg: {"model":"YOUR_AUTHOR_MODEL_ID"}. Jawnie podany obiekt svg wymaga niepustego model. Możesz też ustawić svg.reasoning.effort na none, minimal, low, medium, high, xhigh lub max; wybrany model piszący kod określa obsługiwane wartości. Pomiń reasoning, aby użyć jego ustawienia domyślnego. OpenAI nie publikuje listy dozwolonych modeli piszących kod ani uniwersalnego ustawienia domyślnego. Jeśli ten wybór modelu jest niedostępny, pomiń cały obiekt svg.

Gotowy wynik może zawierać svg_usage z model, input_tokens, output_tokens, reasoning_tokens i total_tokens. To dane odrębne od usage obrazu, a nie dodatkowa liczba tokenów obrazu.

Obrazy referencyjne, maska i oznaczenia

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "Replace the marked background with a pale blue studio backdrop",
  "images": [{"image_url":"https://example.com/reference.png"}],
  "markup": {"image_url":"https://example.com/transparent-markup.png"},
  "output_format": "png",
  "complexity": "low"
}

Obrazy referencyjne obsługują PNG, JPEG i WebP, maksymalnie 50 MB każdy. Maska i oznaczenia muszą być PNG i odpowiadać wymiarom pierwszego obrazu referencyjnego po uwzględnieniu orientacji. Oznaczenia muszą zawierać przezroczyste piksele; zarówno oznaczenia, jak i pierwszy obraz referencyjny mogą mieć maksymalnie 16 777 216 pikseli, a oznaczenia maksymalnie 50 MB. Maska i oznaczenia wzajemnie się wykluczają.

Pola odpowiedzi

Gotowy wynik obrazowy zawiera created, data: [{url}] oraz, jeśli są raportowane, size, quality, background, output_format, usage, svg_usage i safety_identifier. usage może dzielić tokeny wejściowe i wyjściowe na tekstowe i obrazowe oraz wyszczególniać wejście z pamięci podręcznej. Publiczny wynik nie zawiera bajtów obrazu w base64 ani pól kosztu.

Schemat OpenAPI · Dokumentacja generowania OpenAI · Dokumentacja edycji OpenAI · Przewodnik OpenAI po obrazach