Перейти к основному содержанию
POST
Модель gpt-image-2.6-ext, параметр version: flare / sunburst. Оплата за изображение. Поддерживается resolution 1k / 2k / 4k при n: 1, все уровни качества и PNG / JPEG / WebP / SVG / GIF.
Это API Ext. Имя модели и правила параметров отличаются от GPT-Image-2.6 с оплатой за токены.

Аутентификация

string
обязательно
Используйте ключ платформы как Bearer Token. Получите его на странице API-ключей. Отправляйте Content-Type: application/json.

Выбор версии

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

Значения перечислений нечувствительны к регистру; крайние пробелы удаляются. В примерах используется нижний регистр.
string
обязательно
Фиксированное значение gpt-image-2.6-ext.
string
обязательно
Обязательные непустые инструкции. При нескольких образцах укажите первое или второе изображение и опишите изменения и сохраняемые элементы.
string
по умолчанию:"flare"
flare / sunburst; по умолчанию flare. Другие значения: HTTP 400. Цены версий могут различаться.
string
по умолчанию:"1k"
1k / 2k / 4k (также принимаются 1K / 2K / 4K). Вместе с пропорцией size определяет выходные пиксели; см. таблицу «Пропорции и размеры» ниже. Цена за изображение зависит от уровня; другие значения, например hd / 8k, — HTTP 400.
string
по умолчанию:"auto"
Только auto или 10 пропорций ниже, не пиксели вроде 1024x1024. Для генерации по тексту auto даёт 1:1. Для редактирования выбирается ближайшая допустимая пропорция первого образца с читаемыми размерами. Для GIF опустите поле или задайте auto.
string
Псевдоним size; достаточно одного поля. Если указаны оба, они должны совпадать, иначе HTTP 400. Для GIF также только отсутствие поля или auto.
integer
по умолчанию:"1"
Сейчас используйте целое 1.
string
auto / low / medium / high / xhigh / max. Если не указано, поле не передаётся поставщику, и он выбирает автоматически. auto не фиксируется на low. Цена за изображение не меняется; высокие уровни обычно требуют больше времени. Другие значения: HTTP 400.
string
по умолчанию:"png"
png / jpeg / webp / svg / gif; jpg — псевдоним jpeg. SVG и GIF поддерживают только генерацию по тексту. Другие форматы: HTTP 400.
Вывод SVG пока не поддерживается.
string
low / medium / high; без поля выбирает поставщик. Управляет сложностью: low для простых значков и плоских иллюстраций, high для богатых деталей. На цену не влияет.
string[]
До 16 изображений, каждое до 20 MB. PNG / JPEG / WebP / GIF / BMP. Публичные HTTP(S) URL или Data URL изображения вроде data:image/png;base64,.... Наличие образцов включает редактирование. SVG и GIF не допускают образцы.
При resolution 2k / 4k референсы не могут быть в формате GIF / BMP.
Допустимые псевдонимы: image_url, image, images, input_image, input_images. Рекомендуется image_urls. URL должны быть доступны публично без входа.

Пропорции и размеры

При auto генерация по тексту использует 1:1: 1024×1024 для 1k, 2048×2048 для 2k, 2880×2880 для 4k. Редактирование выбирает ближайшую пропорцию из таблицы без гарантии исходных пиксельных размеров.

Пример с образцами

Редактирование также использует POST /v1/images/generations. Замените примерные URL доступными изображениями.

Вывод SVG

Укажите output_format: "svg". Только генерация по тексту с n=1. size принимает пропорции; complexity: "low" подходит для простой векторной графики.
object
Необязательная конфигурация модели, создающей SVG, только для SVG. Весь объект можно опустить. Текстовая модель не оплачивается дополнительно.

Анимированные GIF

Укажите output_format: "gif". Только генерация по тексту. Опустите size / aspect_ratio или задайте auto; пропорции и пиксельные размеры дают HTTP 400. Опишите движение и цикл.

Неподдерживаемые и игнорируемые параметры

Отправка и результаты

Успешная отправка: HTTP 200. Прочитайте data[0].task_id и опрашивайте API статуса каждые 3–5 секунд до completed или failed. При таймауте клиента продолжайте проверять ту же задачу вместо повторной генерации.
Пример показывает объект задачи. Если ответ обёрнут в {code, data}, сначала прочитайте data. Примеры Python / JavaScript обрабатывают оба варианта.
result.images[0].url — массив; первая ссылка: result.images[0].url[0]. Скачайте до expires_at; рекомендуемый срок действия — 24 часа после завершения. cost / credits_cost показывают итоговое списание. Пакетная проверка: POST /v1/tasks/batch с {"task_ids":["task_xxx","task_yyy"]}.

Оплата

Цена за изображение зависит только от version × resolution. Качество, формат, включая SVG / GIF, сложность, пропорции, число образцов и svg.model цену не меняют. Сейчас используйте n=1; неудачные задачи полностью возмещаются. Тарифы: страница цен APIMart или /api/pricing.

Обработка ошибок