Введение
Генерация Sunburst по тексту начинается с описания без входного изображения. Модель с акцентом на точность предлагает пять настроек качества для управления детализацией и размеры до примерно 8,3 мегапикселя.
| Характеристика | Значение |
|---|---|
| Ввод | Текст |
| Вывод | Изображение |
| Разработчик | OpenAI |
| Дата выпуска | 2026-11-05 |
| Модель API | gpt-image-2.6-sunburst |
| Публичные эндпоинты | openai/gpt-image-2.6-sunburst/text-to-image; openai/gpt-image-2.6-sunburst/edit |
| Качество | low, medium (по умолчанию), high, xhigh, max |
| Разрешение | 1k: около 1 МП; 2k: около 3,7 МП; 4k: около 8,3 МП |
| Размеры при 16:9 | 2k: 2560 x 1440; 4k: 3840 x 2160 |
| Соотношения сторон | 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 |
| Количество результатов | 1–10 изображений за запрос |
| Исходники для редактирования | 1–16 входных изображений |
| Маска | Необязательная PNG-маска с размерами первого изображения; прозрачные пиксели отмечают область перерисовки |
| Фон | auto, opaque, transparent; прозрачность требует PNG или WebP |
| Форматы файлов | PNG (по умолчанию), JPEG, WebP; GIF (только генерация по тексту) |
Ключевые возможности и особенности
Поворот на балконе
Цикл Sunburst показывает поворот от ночного города к камере и уверенную улыбку на балконе. Чёткая последовательность действий помогает Sunburst точно спланировать анимационный цикл.
Тост в джаз-клубе
Анимация Sunburst объединяет поднятый бокал, игривое подмигивание и улыбку в джаз-баре. Чёткая последовательность действий помогает Sunburst точно спланировать анимационный цикл.
Пальто на парижской улице
Инструкция для Sunburst сначала определяет, кого сохранить, а затем просит добавить пальто и дождливую обстановку.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Обязательное описание сцены для Sunburst длиной до 5 000 символов; готового текста по умолчанию нет. Очень длинные промпты требуют небольшой доплаты за токен. Не менее 1 символов · Не более 5000 символов |
aspect_ratio | Нет | Sunburst использует 1:1 по умолчанию для статичных изображений и предлагает 15 соотношений от 1:3 до 3:1; для GIF обязательно укажите |
resolution | Нет | Sunburst: для статичных изображений доступны 1k, 2k и 4k; для GIF параметр resolution задаёт размер одного кадра: 512 (около 0,26 МП) допускает до 16 кадров, а 768 (около 0,59 М… |
quality | Нет | Выберите детализацию Sunburst: low, medium (по умолчанию), high, xhigh или max; повышение уровня добавляет детали, время отрисовки и стоимость. |
reasoning_effort | Нет | Sunburst: |
num_outputs | Нет | Запросите у Sunburst 1–10 изображений за раз; число по умолчанию здесь не указано, каждый результат оплачивается. |
background | Нет | Sunburst поддерживает auto, opaque и transparent; прозрачность требует PNG или WebP и недоступна для GIF. |
output_format | Нет | Sunburst возвращает png по умолчанию, также доступны jpeg, webp и gif; анимированный GIF поддерживается только при генерации по тексту и несовместим с прозрачным фоном. |
frame_count | Нет | Sunburst: |
frame_duration_ms | Нет | Sunburst: |
output_quality | Нет | Задайте сжатие JPEG или WebP для Sunburst от 0 до 100: чем выше значение, тем больше деталей и тяжелее файл, PNG и GIF его игнорируют, а цена Sunburst не меняется. |
Стоимость
Sunburst рассчитывает плату за каждое изображение по уровню качества и разрешению; при увеличении числа результатов сумма растёт пропорционально. При редактировании за каждый исходник добавляется небольшая плата, а за очень длинные промпты — небольшая доплата за токен. Отклонённые запросы Sunburst не оплачиваются. В Sunburst GIF оплачивается по листам из 8 кадров с учётом уровня качества: для 9 кадров нужны 2 листа.
| Разрешение | Качество: low | Качество: medium | Качество: high | Качество: xhigh | Качество: max |
|---|---|---|---|---|---|
| $0.02232 / изображение | $0.03915 / изображение | $0.04743 / изображение | $0.08433 / изображение | $0.18972 / изображение |
| $0.027 / изображение | $0.04752 / изображение | $0.05742 / изображение | $0.10206 / изображение | $0.22941 / изображение |
| $0.04131 / изображение | $0.07299 / изображение | $0.08847 / изображение | $0.15723 / изображение | $0.35379 / изображение |
| $0.04392 / изображение | $0.07776 / изображение | $0.09432 / изображение | $0.1674 / изображение | $0.37638 / изображение |
| $0.07479 / изображение | $0.13221 / изображение | $0.16011 / изображение | $0.28512 / изображение | $0.64044 / изображение |
Сценарии использования
Иллюстрации для туристической рекламы
Создайте приморский плакат с названием места, коротким заголовком и заданной палитрой.
Изображения меню кафе
Опишите расположение элементов на меловой доске, заключите позиции меню в кавычки и задайте утреннюю обстановку.
Редактирование портретов
Перенесите загруженный портрет на дождливую улицу, указав, что нужно сохранить от исходника.
Руководство по промптам и практические советы
Составьте визуальный бриф
Опишите объект, материалы и свет, а нужные короткие надписи заключите в кавычки.
Выберите детализацию и размер
Начните с качества medium и выберите 1k, 2k или 4k с учётом того, где будет размещено изображение.
Опишите правку
Для редактирования поставьте исходник первым и сначала перечислите, что сохранить, а затем — что заменить.
Выделите область
Если изменение касается конкретного участка, передайте PNG-маску с размерами первого изображения.
Введение
В Sunburst точно опишите сцену и последовательность движений перед генерацией.
Возможности
- Для статичных изображений Sunburst предлагает 1k, 2k и 4k, а также пять уровней качества.
- GIF-циклы в Sunburst: опишите движение и повтор, выберите
output_format: gif и обязательно задайтеaspect_ratio. - Sunburst: для статичных изображений доступны 1k, 2k и 4k; для GIF параметр resolution задаёт размер одного кадра: 512 (около 0,26 МП) допускает до 16 кадров, а 768 (около 0,59 МП) — до 12.
- Sunburst:
frame_countзадаёт от 2 до 16 кадров, по умолчанию 9; верхний предел зависит от выбранного размера кадра. - Sunburst:
frame_duration_msзадаёт от 20 до 2000 мс на кадр, по умолчанию 200 мс. - В Sunburst GIF оплачивается по листам из 8 кадров с учётом уровня качества: для 9 кадров нужны 2 листа.
- Sunburst возвращает png по умолчанию, также доступны jpeg, webp и gif; анимированный GIF поддерживается только при генерации по тексту и несовместим с прозрачным фоном.
Советы
- В Sunburst подберите
reasoning_effortпод композицию: high используется по умолчанию и помогает с плотным текстом; дополнительное планирование требует времени, но не меняет стоимость.
Быстрый старт 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"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.
