Генерация изображений GPT-Image-2.6

POST

/v1/images/generations

Стандартный уровень создаёт задачу генерации изображения через POST /v1/images/generations и возвращает ID задачи. После завершения получите URL изображения через endpoint статуса. Обе модели используют одинаковый формат запроса:

Модель	`model` в запросе
Flare	`gpt-image-2.6-flare`
Sunburst	`gpt-image-2.6-sunburst`

gpt-image-2.6 — название серии. Всегда передавайте полное имя модели из таблицы.

Для пользователей из материкового Китая: используйте https://api.toapis.cn в качестве API endpoint (Base URL). Замените https://api.toapis.com на https://api.toapis.cn в примерах этого документа.

Создайте API Key в консоли.

Быстрый старт

Установите свой ToAPIs API Key в переменную окружения TOAPIS_API_KEY и отправьте задачу:

curl --fail-with-body --request POST \
  --url https://api.toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.6-flare",
    "prompt": "Стиль детской книжки: ветеринар слушает стетоскопом сердцебиение детёныша выдры",
    "quality": "high",
    "size": "1:1",
    "resolution": "1K",
    "n": 1
  }'

Пример ответа при отправке:

{
  "id": "tsk_img_example",
  "object": "generation.task",
  "model": "gpt-image-2.6-flare",
  "status": "pending",
  "progress": 0,
  "created_at": 1788951900,
  "metadata": {}
}

Сохраните возвращённый id, замените TASK_ID ниже на это значение и запросите результат:

curl --fail-with-body \
  --url https://api.toapis.com/v1/images/generations/TASK_ID \
  --header "Authorization: Bearer $TOAPIS_API_KEY"

Задача проходит через pending, queued, in_progress и завершается статусом completed или failed. При completed читайте URL изображения из result.data, при failed — error. Опрашивайте каждые несколько секунд. Полный набор полей описан в API статуса задачи изображения.

Успешная отправка означает только создание задачи. Дождитесь completed перед скачиванием изображения и продолжайте опрашивать тот же ID задачи.

Параметры запроса

Authorizationstringзаголовокобязательно

Аутентификация через Bearer YOUR_TOAPIS_API_KEY.

modelstringтелообязательно

gpt-image-2.6-flare или gpt-image-2.6-sunburst.

promptstringтелообязательно

Описание изображения. При использовании референсных изображений опишите, что сохранить и что изменить.

qualitystringтелопо умолчанию: high

Всегда используется high. Поле можно не передавать. Другие строковые значения, например medium, игнорируются, и генерация выполняется с high. Цена стандартных моделей зависит от resolution, а не от quality.

sizestringтелопо умолчанию: 1:1

Соотношение сторон, например 1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, 21:9.

Рекомендуем задавать size как соотношение сторон и явно передавать resolution; выходные размеры в пикселях вычисляются из обоих значений.

Можно передать auto, чтобы провайдер сам выбрал размеры, но итоговое соотношение сторон и размеры в пикселях не гарантируются.

resolutionstringтелопо умолчанию: 1K

Уровень разрешения. Поддерживаются 1K, 2K и 4K, строчные буквы тоже принимаются. На стандартном уровне это поле определяет тариф.

nintegerтелопо умолчанию: 1

Передайте 1 на запрос для генерации одного изображения.

backgroundstringтело

Необязательная настройка фона. Передайте "transparent" для генерации изображения с прозрачным фоном. Для обычной генерации поле не передаётся.

Работает и для текстовых запросов, и для запросов с reference_images.

output_formatstringтело

Формат вывода: png, jpeg, webp, gif или svg. Если не передать, используется формат по умолчанию у провайдера. Дополнительные параметры и ограничения GIF и SVG описаны в соответствующих разделах ниже.

frame_countintegerтелопо умолчанию: 9

Только для GIF. Количество кадров от 2 до 64. Текст-в-GIF использует это значение; image-to-GIF всегда рендерится с 9 кадрами.

frame_duration_msintegerтелопо умолчанию: 200

Только для GIF. Длительность кадра в миллисекундах от 20 до 2000 с шагом 10.

reference_imagesstring[]тело

Необязательный список URL референсных изображений, до 10 штук. Изображения должны быть доступны серверу. Поддерживаются только URL: локальные файлы и base64 не принимаются. Для локальных изображений сначала получите URL через API загрузки изображений.

Также принимается image_urls. Используйте одно из двух полей.

В сочетании с "output_format": "gif" референсные изображения дают вывод image-to-GIF.

Прозрачный фон

Добавьте "background": "transparent" в запрос генерации, чтобы получить изображение с прозрачным фоном. Для обычной генерации поле не передаётся.

curl --fail-with-body --request POST \
  --url https://api.toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.6-flare",
    "prompt": "Красная круглая наклейка на прозрачном фоне",
    "quality": "high",
    "size": "1:1",
    "resolution": "1K",
    "background": "transparent",
    "n": 1
  }'

Задача запрашивается по ID как обычно; читайте URL изображения из result.data.

Вывод GIF

Установите output_format в gif для генерации анимации. frame_count задаёт количество кадров (от 2 до 64, по умолчанию 9), а frame_duration_ms — длительность кадра (от 20 до 2000 миллисекунд с шагом 10, по умолчанию 200).

curl --fail-with-body --request POST \
  --url https://api.toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.6-flare",
    "prompt": "Бумажный самолётик, кружащий по голубому небу, плоская иллюстрация",
    "output_format": "gif",
    "frame_count": 8,
    "frame_duration_ms": 200,
    "size": "1:1",
    "n": 1
  }'

Image-to-GIF

Добавьте reference_images, чтобы анимировать существующее изображение. Вывод image-to-GIF всегда рендерится с 9 кадрами; frame_count в этом режиме игнорируется, а frame_duration_ms продолжает действовать.

curl --fail-with-body --request POST \
  --url https://api.toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.6-flare",
    "prompt": "Оживить сцену мягким движением",
    "reference_images": ["https://example.com/scene.png"],
    "output_format": "gif",
    "frame_duration_ms": 200,
    "n": 1
  }'

Вывод SVG

Установите output_format в svg для генерации векторной графики. Дополнительные поля не требуются.

curl --fail-with-body --request POST \
  --url https://api.toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.6-flare",
    "prompt": "Минималистичный логотип горы, плоский векторный стиль",
    "output_format": "svg",
    "n": 1
  }'

Примеры соотношений и разрешений

size	1K	2K	4K
`1:1`	`1024x1024`	`2048x2048`	`2880x2880`
`3:2`	`1536x1024`	`2048x1360`	`3520x2336`
`2:3`	`1024x1536`	`1360x2048`	`2336x3520`
`16:9`	`1536x864`	`2048x1152`	`3840x2160`
`9:16`	`864x1536`	`1152x2048`	`2160x3840`

4K — это уровень разрешения; фактическая ширина и высота зависят от соотношения сторон. Например, квадратный вывод 4K — 2880x2880.

Генерация с референсными изображениями

Используйте тот же endpoint генерации и добавьте reference_images — до 10 изображений. Пример ниже использует Sunburst и также возвращает асинхронную задачу:

curl --fail-with-body --request POST \
  --url https://api.toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.6-sunburst",
    "prompt": "Сохранить детёныша выдры и ветеринара с референсного изображения и добавить детёнышу жёлтый шарф",
    "reference_images": ["https://example.com/otter.png"],
    "quality": "high",
    "size": "1:1",
    "resolution": "2K",
    "n": 1
  }'

Замените https://example.com/otter.png на URL своего референсного изображения и запросите результат по возвращённому ID задачи.

Тарификация

Стандартный уровень тарифицируется за каждое сгенерированное изображение, а уровень resolution определяет ценовой уровень. GIF и SVG вывод тарифицируются по той же цене за изображение. Ввод референсных изображений сейчас не имеет дополнительной платы. Индивидуальные цены или скидки могут отличаться; актуальные цены смотрите на странице тарифов и в настройках аккаунта.

Связанные модели

Версия GPT-Image-2.6 Official работает через официальный канал с шестью уровнями качества, произвольными размерами в пикселях, редактированием по разметке и тарификацией по токенам. Для этого канала используйте имена моделей с суффиксом -official.