Skip to main content
POST
GPT-Image-2.5 Генерация изображений
Стандартная версия создаёт задачу генерации изображения через POST /v1/images/generations и возвращает ID задачи. После завершения задачи получите URL изображения через эндпоинт статуса. Обе модели используют одинаковый формат запроса: gpt-image-2.5 — это название серии. В запросе всегда указывайте полное имя модели из таблицы.
Эта страница описывает стандартную версию. Если нужно платить по фактическому расходу токенов, используйте отдельную документацию GPT-Image-2.5 VIP. Обе версии работают как асинхронные задачи; основные различия — формат size и модель оплаты.
Для пользователей из материкового Китая: используйте https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.
API Key создаётся в консоли.

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

Сохраните свой API Key ToAPIs в переменную окружения TOAPIS_API_KEY и отправьте задачу:
Пример ответа на отправку:
Сохраните полученный id, подставьте его вместо TASK_ID в примере ниже и запросите результат:
Задача проходит статусы pending, queued и in_progress, а затем переходит в completed или failed. При статусе completed читайте URL изображения из result.data, при failed — из error. Запрашивайте статус каждые несколько секунд. Полный список полей описан в разделе Статус задачи изображения. Успешная отправка означает только то, что задача создана. Дождитесь статуса completed, прежде чем скачивать изображение, и продолжайте опрашивать тот же ID задачи.

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

string
обязательно
Аутентификация через Bearer YOUR_TOAPIS_API_KEY.
string
обязательно
gpt-image-2.5-flare или gpt-image-2.5-sunburst.
string
обязательно
Описание изображения. При работе с референсными изображениями опишите, что нужно сохранить, а что изменить.
string
по умолчанию:"high"
Сейчас стандартная версия фиксирует качество high на каналах W8X, поэтому параметр можно не передавать. Любое другое строковое значение игнорируется и заменяется на high. В Playground опция качества не отображается.Сейчас стандартная версия тарифицируется по resolution.
string
по умолчанию:"1:1"
Соотношение сторон, например 1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, 21:9.Рекомендуем указывать соотношение и явно передавать resolution. Сервер рассчитывает размеры выходного изображения в пикселях по этим двум значениям. В стандартной версии используются соотношения, а в VIP-версии — размеры в пикселях.
string
по умолчанию:"1K"
Уровень разрешения. Поддерживаются 1K, 2K и 4K, также принимаются значения в нижнем регистре. Это поле определяет тарифный уровень стандартной версии.
string
Необязательный параметр фона. Значение "transparent" включает генерацию изображения с прозрачным фоном. Без этого поля выполняется обычная генерация.Поддерживается для генерации по тексту и запросов с reference_images.
integer
по умолчанию:1
Используйте 1 на запрос, чтобы сгенерировать одно изображение.
string[]
Необязательный список URL референсных изображений. Изображения должны быть доступны серверу. Для локальных файлов сначала получите URL через API загрузки изображений.Также поддерживается поле image_urls. Используйте одно из двух полей. В примерах на этой странице применяются URL референсных изображений; если нужно загружать локальные файлы напрямую для редактирования, см. раздел Редактирование по референсу.

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

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

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

Используйте тот же эндпоинт генерации и добавьте reference_images. В примере ниже применяется Sunburst, и ответ по-прежнему является асинхронной задачей:
Замените https://example.com/otter.png на URL своего референсного изображения, затем запросите результат по полученному ID задачи.

Цены

Ниже указаны стандартные цены, проверенные 2026-09-09, за одно изображение на запрос. Обе модели стандартной версии стоят одинаково: Все три цены действуют для low, medium, high, xhigh и max. Сейчас за ввод референсных изображений отдельная плата за изображение не взимается. Индивидуальные тарифы или скидки аккаунта могут отличаться; актуальные цены смотрите на странице тарифов моделей и в настройках аккаунта.

Отличия от VIP-версии

При переходе на VIP-версию одновременно измените имя модели и параметры. Подробности см. в разделе GPT-Image-2.5 VIP.