Skip to main content
POST
GPT-Image-2.5: генерация через официальный канал
Обе модели GPT-Image-2.5 доступны через официальный канал Azure. После отправки сразу возвращается ID асинхронной задачи. Изображения генерируются в фоне и перед выдачей сохраняются в R2. Указывайте полное имя модели из таблицы. gpt-image-2.5-official обозначает серию и не является допустимым значением model. Для материкового Китая замените https://api.toapis.com на https://api.toapis.cn. Создайте API Key в консоли и задайте переменную окружения TOAPIS_API_KEY.

Отправка и проверка

Отправьте запрос на одно изображение Flare. Для Sunburst замените model:
Сохраните id из ответа и подставьте его вместо TASK_ID:
При отправке возвращается pending. При опросе возможны queued и in_progress, затем completed или failed. При completed URL изображений в R2 находятся в result.data[].url, при failed читайте error. Проверяйте тот же ID задачи каждые несколько секунд. Генерация высокого качества может занять несколько минут; продолжайте опрос без повторной отправки. Все поля описаны в API статуса изображений.

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

string
обязательно
Используйте ToAPIs API Key в формате Bearer YOUR_API_KEY. Учетные данные Azure не нужны.
string
обязательно
gpt-image-2.5-sunburst-official / gpt-image-2.5-flare-official.
string
обязательно
Описание изображения. Для запросов с референсами укажите, что сохранить и что изменить.
string
по умолчанию:"high"
Поддерживаются low, medium, high, xhigh и max. Качество и размеры влияют на фактический расход токенов и время обработки.
string
по умолчанию:"1024x1024"
Указывайте размеры в пикселях, например 1024x1024, 1536x1024 или 1024x1536. Произвольные размеры должны пройти проверку провайдера. В этих примерах отдельное поле resolution не требуется.
string
Необязательный параметр. Укажите transparent для прозрачного фона. Если параметр пропущен, используется значение провайдера по умолчанию. Формат PNG по умолчанию сохраняет прозрачность.
integer
по умолчанию:1
Сейчас официальный канал создает одно изображение на запрос. Укажите 1.

URL референсных изображений

Для генерации по изображению добавьте image_urls в тот же JSON-запрос генерации. URL должны быть доступны серверу. Получить URL можно через API загрузки изображений. Референсы оплачиваются как входные токены изображений. Отправка и опрос используют тот же асинхронный процесс.

Тарифы на токены

Стандартные цены проверены 2026-09-11. Для обеих официальных моделей действует 80% официального тарифа на токены, то есть скидка 20%: При отправке резервируется квота, а после успешного выполнения разница рассчитывается по фактическим текстовым и графическим токенам провайдера. Все пять уровней качества используют эти ставки; фиксированной цены за изображение для каждого качества нет. Перед отправкой нужны достаточный баланс и квота API Key. Формула стоимости в USD:
Например, 17 некэшированных текстовых токенов на входе и 196 токенов изображения на выходе стоят (17 * 4 + 196 * 24) / 1,000,000 = $0.004772. Это не фиксированная цена за изображение. Индивидуальные цены и скидки аккаунта продолжают действовать. Итоговое списание проверяйте в журнале использования. Актуальные цены определяются страницей тарифов и настройками аккаунта.

Другие варианты

У стандартной версии и VIP-версии свои полные имена моделей. Для описанного здесь официального канала используйте суффикс -official.