Перейти к основному содержанию
POST
Генерация изображений GPT-Image-2.6
Стандартный уровень создаёт задачу генерации изображения через POST /v1/images/generations и возвращает ID задачи. После завершения получите URL изображения через endpoint статуса. Обе модели используют одинаковый формат запроса: 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 и отправьте задачу:
Пример ответа при отправке:
Сохраните возвращённый id, замените TASK_ID ниже на это значение и запросите результат:
Задача проходит через pending, queued, in_progress и завершается статусом completed или failed. При completed читайте URL изображения из result.data, при failed — error. Опрашивайте каждые несколько секунд. Полный набор полей описан в API статуса задачи изображения. Успешная отправка означает только создание задачи. Дождитесь completed перед скачиванием изображения и продолжайте опрашивать тот же ID задачи.

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

string
обязательно
Аутентификация через Bearer YOUR_TOAPIS_API_KEY.
string
обязательно
gpt-image-2.6-flare или gpt-image-2.6-sunburst.
string
обязательно
Описание изображения. При использовании референсных изображений опишите, что сохранить и что изменить.
string
по умолчанию:"high"
Три уровня: low, medium, high. В Playground по умолчанию high. Если не передать, используется значение по умолчанию на стороне провайдера.
string
по умолчанию:"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, чтобы провайдер сам выбрал размеры, но итоговое соотношение сторон и размеры в пикселях не гарантируются.
string
по умолчанию:"1K"
Уровень разрешения. Поддерживаются 1K, 2K и 4K, строчные буквы тоже принимаются. На стандартном уровне это поле определяет тариф.
integer
по умолчанию:1
Передайте 1 на запрос для генерации одного изображения.
string
Необязательная настройка фона. Передайте "transparent" для генерации изображения с прозрачным фоном. Для обычной генерации поле не передаётся.Работает и для текстовых запросов, и для запросов с reference_images.
string
Формат вывода: png, jpeg, webp, gif или svg. Если не передать, используется формат по умолчанию у провайдера. Дополнительные параметры и ограничения GIF и SVG описаны в соответствующих разделах ниже.
integer
по умолчанию:9
Только для GIF. Количество кадров от 2 до 64. Текст-в-GIF использует это значение; image-to-GIF всегда рендерится с 9 кадрами.
integer
по умолчанию:200
Только для GIF. Длительность кадра в миллисекундах от 20 до 2000 с шагом 10.
string[]
Необязательный список URL референсных изображений, до 10 штук. Изображения должны быть доступны серверу. Поддерживаются только URL: локальные файлы и base64 не принимаются. Для локальных изображений сначала получите URL через API загрузки изображений.Также принимается image_urls. Используйте одно из двух полей.В сочетании с "output_format": "gif" референсные изображения дают вывод image-to-GIF.

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

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

Вывод GIF

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

Image-to-GIF

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

Вывод SVG

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

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

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

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

Используйте тот же endpoint генерации и добавьте reference_images — до 10 изображений. Пример ниже использует Sunburst и также возвращает асинхронную задачу:
Замените https://example.com/otter.png на URL своего референсного изображения и запросите результат по возвращённому ID задачи.

Тарификация

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

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

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