OpenAI: GPT Image 2.5 Sunburst
GPT Image 2.5 Sunburst создаёт и редактирует изображения по тексту и визуальным референсам с акцентом на точность правок. Он поддерживает маски, последовательную доработку, собственные размеры кадра, прозрачный фон и уровни качества от low до max.
О модели
Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.
GPT Image 2.5 Sunburst — модель OpenAI для генерации и редактирования изображений с акцентом на точность. Она принимает текст и изображения и выдаёт изображения. Используйте её, когда творческая задача зависит от аккуратного изменения существующих материалов, работы с визуальными референсами или доработки композиции в несколько шагов. Задание может создать новую сцену, преобразовать существующее изображение или направить правку выбранной области. Sunburst и Flare — разные версии: Sunburst делает акцент на точности редактирования, а Flare позиционируется для быстрой повседневной генерации.
Для нового изображения опишите объект, окружение, композицию, освещение и стиль, затем укажите нужную форму и применение. Для концепции продукта запросите стеклянную лампу на каменной поверхности с мягким боковым светом, хорошо видимым силуэтом и свободным местом для заголовка. Для правки назовите изменение и элементы, которые должны остаться узнаваемыми: замените фон, скорректируйте свет или измените материал, сохранив выбранную композицию. Прямые процессы генерации и редактирования поставщика допускают запрос до 32,000 символов и от одного до десяти результатов.
Редактирование по референсам может использовать до шестнадцати входных изображений. Задайте роль каждому изображению, чтобы инструкция различала сохраняемый объект, нужное окружение и применяемый стиль. Модель также умеет работать с маской, указывающей область изменения. Исходник и маска должны иметь одинаковые формат и размеры, а маска — альфа-канал; руководство задаёт ограничение размера менее 50 MB. При нескольких исходных изображениях маска применяется к первому. Она направляет нужное изменение, а не гарантирует жёсткую границу, поэтому включайте требования к сохранению в задание и проверяйте окружающую область в результате.
Настройки качества — low, medium, high, xhigh, max и auto; по умолчанию — auto. Low подходит для быстрого визуального черновика, а более высокие настройки полезно сравнить, когда важны мелкие детали. Качество отделено от размеров результата и сжатия файла. Стандартные размеры включают 1024 × 1024, 1536 × 1024 и 1024 × 1536 пикселей; доступны также автоматические и собственные размеры. Выбирайте форму с учётом конечного макета, прежде чем определять, сколько деталей требуется изображению.
Собственные размеры должны быть кратны шестнадцати пикселям, ни одна сторона не может превышать 3840 пикселей, соотношение сторон должно оставаться между 1:3 и 3:1, а общая площадь — между 655,360 и 8,294,400 пикселей. Эти условия действуют одновременно. Горизонтальное изображение 3840 × 2160 соответствует верхнему пределу площади, но сама по себе длинная сторона не делает произвольную пару размеров допустимой. Разрешения выше 2560 × 1440 описаны как экспериментальные. Держите важные объекты, текст и полезное свободное пространство в пределах намеченного кадрирования, не рассчитывая, что большее число пикселей решит композицию.
Формат результата по умолчанию — PNG; JPEG и WebP также поддерживаются. Для JPEG и WebP можно выбрать сжатие от 0 до 100. Прозрачный, непрозрачный и автоматически выбираемый фон отвечают разным потребностям макета. Для прозрачности выбирайте PNG или WebP, чтобы результат мог сохранить альфа-канал. Прозрачный материал затем можно поместить в другую композицию, тогда как непрозрачное изображение содержит собственный фон. Храните сам завершённый файл вместе с заданием и выбранными настройками вывода.
OpenAI документирует прямую генерацию и редактирование, а также диалоговый инструмент генерации изображений, который может сохранять предыдущие результаты и применять последующие инструкции. В этом диалоговом процессе действие может выбираться автоматически либо принудительно задаваться как генерация или редактирование, когда изображение есть в контексте. Используйте выбранное изображение как отправную точку следующей правки, не переключаясь незаметно на другую вариацию. Документированный потоковый процесс может выдать до трёх промежуточных изображений перед окончательным результатом; промежуточный просмотр показывает ход работы, но не является готовым материалом. Интерфейс производителя также поддерживает пакетную обработку.
Проверяйте изменённый объект, надписи, расположение предметов и границу правки по маске в предполагаемом размере показа. GPT Image по-прежнему может испытывать трудности с точным размещением текста, структурированными макетами или согласованностью повторяющихся объектов и элементов бренда. Сфокусированная следующая инструкция должна обозначать видимую проблему и сохраняемые элементы. Sunburst полезен для точного творческого процесса на основе референсов, в котором итоговый артефакт оценивается по конкретному визуальному заданию, а более высокое качество, размеры и прозрачность выбираются под этот артефакт.
Ailoot Ultra · Картинки POST /v1/images/generations openai/gpt-image-2.5-sunburst
openai/gpt-image-2.5-sunburstНачало
GPT Image 2.5 Sunburst создаёт и редактирует изображения по тексту и визуальным референсам с акцентом на точность правок. Он поддерживает маски, последовательную доработку, собственные размеры кадра, прозрачный фон и уровни качества от low до max.
- Допустимые входные данные
- Текст · Картинки
- Результаты
- Картинки
Доступно в Ailoot · входные данные и методы
Ailoot Ultra · Картинки POST /v1/images/generations
- Входные данные
text,image- Результат
image
| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Полеmodel | Типstring | ТребованиеОбязательно | Значения и ограничения openai/gpt-image-2.5-sunburst | По умолчанию— |
Полеprompt | Типstring | ТребованиеОбязательно | Значения и ограничения Минимальная длина: 1 | По умолчанию— |
Полеaspect_ratio | Типstring | ТребованиеНеобязательно | Значения и ограничения 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, auto | По умолчанию— |
Полеquality | Типstring | ТребованиеНеобязательно | Значения и ограничения auto, low, medium, high, xhigh, max | По умолчанию— |
Полеbackground | Типstring | ТребованиеНеобязательно | Значения и ограничения auto, transparent, opaque | По умолчанию— |
Полеn | Типinteger | ТребованиеНеобязательно | Значения и ограничения Минимум: 1 Максимум: 10 | По умолчанию— |
Полеinput_references | Типarray | ТребованиеНеобязательно | Значения и ограничения Минимум элементов: 0 Максимум элементов: 16 | По умолчанию— |
Полеoutput_compression | Типinteger | ТребованиеНеобязательно | Значения и ограничения Минимум: 0 Максимум: 100 | По умолчанию— |
Полеprovider | Типobject | ТребованиеНеобязательно | Значения и ограничения | По умолчанию— |
Параметры и жизненный цикл метода
| Параметр | Контракт |
|---|---|
Параметрcontent_type | Контрактapplication/json |
Параметрrequired | Контрактmodel, prompt |
Параметрmaterial_types | Контрактtext, image |
Жизненный цикл: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Фактически возвращённый task_id или запись в медиатеке
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Тарифы
Как рассчитывается итоговая плата
Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом.
Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.
- Быстрый режим
- Не указано При выборе быстрого режима
- Режим flex
- Не указано При выборе режима flex
- Максимальная интенсивность рассуждений
- Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)
Оценочные ставки для сравнения
Цены по конфигурациям
Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.
| Конфигурация | Шкала ставок | Прогноз количества | Плата |
|---|---|---|---|
| КонфигурацияБазовые тарифы на токены | Шкала ставокБазовая ставка | Прогноз количества— | Плата Вход · Входные токены · Оценка только для сравнения — / 1K токенов Выход · Выходные токены · Оценка только для сравнения — / 1K токенов Вход · Чтение кэша · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш, 1 час · Оценка только для сравнения — / 1K токенов |
| КонфигурацияОриентировочная стоимость генерации | Шкала ставок— | Прогноз количестваОценка для одной генерации | Плата Выход · Оценочная стоимость генерации · Оценка только для сравнения $0.24576 оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации. |
Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →
Примеры запросов
Ailoot Ultra · Картинки
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
Получить и сохранить результаты
Ailoot Ultra · Картинки
Загрузите каждое полученное изображение или сохраните его содержимое Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Чтение другого содержимого
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.
Сохраняйте все готовые результаты
Сохраните каждое готовое изображение; загрузите содержимое по каждому полученному URL или декодируйте его содержимое Base64.
Сохраняйте полный ответ и заголовки, все фактические результаты, исходные возвращённые идентификаторы и все поля использования. Восстанавливайте исходную операцию без повторной отправки запроса создания.
Если нужно проверить исходный ответ
Сохраните возвращённый X-Client-Request-ID для сверки. Читайте только фактически возвращённые значения task_id/asset_id или собственную медиатеку; никогда не составляйте URL задачи из ID операции и никогда не отправляйте запрос создания повторно.
Поля ответа
| Поле | Тип |
|---|---|
Полеcreated | Тип |
Полеdata[].url | Тип |
Полеdata[].b64_json | Тип |
Полеusage | Тип |
Псевдонимы
Псевдонимы моделей
Ailoot Ultra openai/gpt-image-2.5-sunburst
Псевдонимы путей метода
/v1/images
Связанные ID для вызова
FAQ · OpenAI: GPT Image 2.5 Sunburst
- Какие входные данные и результаты доступны?
POST /v1/images/generations·openai/gpt-image-2.5-sunburst:text,image→image- Какие поля использует запрос?
POST /v1/images/generations·openai/gpt-image-2.5-sunburst:model,prompt,aspect_ratio,quality,background,n,input_references,output_compression,provider- Какие ограничения действуют?
POST /v1/images/generations·openai/gpt-image-2.5-sunburst:n.minimum:1;n.maximum:10;output_compression.minimum:0;output_compression.maximum:100