models

OpenAI: GPT Image 2.5 Sunburst

Markdown · JSON

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

OpenAI /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 · Картинки

curl
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}/content
  • GET /v1/media/assets
  • GET /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 для вызова

openai/gpt-image-2.5-sunburst

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

Подробнее

Подключите Ailoot к Claude Code, OpenCode, Hermes или своему приложению.

Компания и портфель её проектов

Компания и портфель её проектов: миллионы клиентов; продажи на миллиарды ежемесячно.

Покупайте токены со скидкой.

Скидка по подписке для регулярной работы. Промокоды — до 50% на покупку токенов.

Подписка
Выберите тариф со скидкой для своих регулярных запросов.
Промокод до 50%
Введите код при покупке. Цена пересчитается с учётом действующей акции.
Расходы в истории
Модель, токены и сумма сохраняются для каждого запроса.

Выбрать подписку · Посмотреть цены моделей

Подключайте API к продукту, который вы продаёте.

SaaS, приложения и боты — по оферте и лицензионному договору Ailoot. Для перепродажи запросите реселлерскую лицензию.

Коммерческое приложение
Встраивайте генерацию текста, картинок, видео и звука в платные функции своего сервиса.
Лицензия для реселлера
Пришлите описание проекта и схему доступа. Запросите письменные условия использования и перепродажи.
Документы на сайте
Оферта, лицензионный договор и политика обработки данных доступны до подключения.

Запросить реселлерскую лицензию · Оферта и лицензионный договор