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

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

Сохраните свой API Key в переменную окружения 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-vip или gpt-image-2.5-sunburst-vip.
string
обязательно
Описание изображения. При редактировании опишите, что нужно сохранить, а что изменить.
string
по умолчанию:"high"
Поддерживаются пять уровней: low, medium, high, xhigh и max. По умолчанию high. Используйте значения в нижнем регистре.Качество влияет на результат генерации и на фактический расход выходных токенов. Изображения с одинаковым качеством тоже могут стоить по-разному из-за размеров и содержимого.
string
по умолчанию:"1024x1024"
Размер выходного изображения в пикселях в формате ширинахвысота, например 1024x1024, 1536x1024, 1024x1536, 1280x1024.Поддерживаются пользовательские размеры в пикселях, допустимые у вышестоящего провайдера, а не только примеры выше. Допустимый диапазон размеров проверяется валидацией эндпоинта. В примерах VIP-версии не используются значения-соотношения вроде 1:1, и дополнительный resolution не требуется.
string
Необязательный параметр фона. Значение "transparent" включает генерацию изображения с прозрачным фоном. Без этого поля выполняется обычная генерация.Поддерживается для генерации по тексту и редактирования по референсному изображению.
integer
по умолчанию:1
Используйте 1 на запрос, чтобы сгенерировать одно изображение.

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

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

Редактирование по референсу

Для редактирования используется POST /v1/images/edits с телом multipart/form-data. Передайте локальное изображение в файловом поле image, а вместе с ним model, prompt, quality, size и n. Редактирование тоже является асинхронной задачей: после отправки возвращается ID задачи, а опрос выполняется так же, как при генерации. В примере ниже Sunburst VIP добавляет жёлтый шарф маленькой выдре из otter.png:
Пусть curl сам задаст Content-Type и boundary для multipart. Используйте ID задачи из ответа для опроса эндпоинта статуса и читайте URL отредактированного изображения из result.data. Flare VIP поддерживает такой же способ редактирования: измените модель на gpt-image-2.5-flare-vip. Ввод референсного изображения создаёт расход входных токенов изображения.

Цены за токены

Ниже указаны стандартные цены, проверенные 2026-09-09. Обе VIP-модели одинаковы и тарифицируются с 20% скидкой от официальных цен за токены: Все пять уровней качества используют эти цены за токены. В VIP-версии нет фиксированной цены за изображение в зависимости от качества: после завершения задачи расчёт идёт по фактическому расходу. При отправке задачи средства сначала резервируются, а после завершения расчёт идёт по фактическим текстовым токенам и токенам изображения, с возвратом разницы или доплатой. Перед вызовом всё равно нужны достаточный баланс аккаунта и лимит API Key. Формула стоимости в USD:
Например, одно текст→изображение 1024x1024 с качеством low содержит 27 входных токенов текста и 196 выходных токенов изображения, и стоит:
Одно измеренное редактирование по референсу содержало 21 входной токен текста, 1024 входных токена изображения и 196 выходных токенов изображения. По формуле получается 0.0113416,апослеокруглениядоминимальнойединицыквотыплатформысписывается0.0113416, а после округления до минимальной единицы квоты платформы списывается 0.011342. Это примеры конкретных запросов, а не фиксированная стоимость за изображение при одинаковом качестве. Индивидуальные тарифы или скидки аккаунта могут отличаться; актуальные цены смотрите на странице тарифов моделей и в настройках аккаунта. Итоговое списание можно проверить в журнале использования.

Переход со стандартной версии

  1. Замените полное имя модели на соответствующее имя с -vip.
  2. Замените size с соотношения на размеры в пикселях и уберите resolution.
  3. И для текст→изображение, и для редактирования по референсу опрашивайте результат по ID задачи и читайте URL изображения из result.data.
  4. Для редактирования по референсу перейдите на /v1/images/edits и загружайте файл изображения.
  5. Оценивайте стоимость по фактическим токенам.
Примеры отправки и опроса задачи в стандартной версии см. в документации GPT-Image-2.5.