GPT-Image-2.6 официальный канал генерации изображений

Через официальный канал доступны две модели GPT-Image-2.6. Отправка запроса сразу возвращает ID асинхронной задачи. Изображения генерируются в фоне и сохраняются в R2 перед выдачей.

В запросах нужно использовать полное имя модели из таблицы. gpt-image-2.6-official — это только название серии, его нельзя передавать в model.

Пользователи в материковом Китае могут заменить https://api.toapis.com в примерах на https://api.toapis.cn. Создайте API Key в консоли и установите переменную окружения TOAPIS_API_KEY.

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

Отправка изображения через Flare. Для Sunburst достаточно заменить model:

curl --fail-with-body --request POST \
  --url https://api.toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.6-flare-official",
    "prompt": "A small blue circle on a plain white background",
    "size": "1:1",
    "resolution": "1k",
    "quality": "medium",
    "n": 1
  }'

{
  "id": "tsk_img_example",
  "object": "generation.task",
  "model": "gpt-image-2.6-flare-official",
  "status": "pending",
  "progress": 0,
  "created_at": 1789099098,
  "metadata": {}
}

Сохраните id из ответа и подставьте его вместо TASK_ID ниже:

curl --fail-with-body \
  --url https://api.toapis.com/v1/images/generations/TASK_ID \
  --header "Authorization: Bearer $TOAPIS_API_KEY"

Ответ на отправку — pending. При опросе может отображаться queued или in_progress, финальные статусы — completed или failed. При completed URL результата, сохранённого в R2, находится в result.data[].url; при failed читайте error. Опрашивайте один и тот же ID задачи каждые несколько секунд; высококачественная генерация может занять несколько минут, не отправляйте запрос повторно во время ожидания. Все поля описаны в API статуса задачи изображения.

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

Референсные изображения и маски

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

mask_url указывает на PNG-маску с альфа-каналом; её размер должен совпадать с первым референсным изображением, и она используется только вместе с image_urls.

curl --fail-with-body --request POST \
  --url https://api.toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.6-sunburst-official",
    "prompt": "Keep the subject and replace the masked area with a snowy forest",
    "image_urls": ["https://example.com/reference.png"],
    "mask_url": "https://example.com/mask.png",
    "quality": "high",
    "size": "1024x1024",
    "n": 1
  }'

Редактирование по разметке

markup_url указывает на размеченное референсное изображение (либо передайте встроенный объект разметки через markup). Вместе с image_urls для исходного изображения модель редактирует по смыслу разметки. markup_url и mask_url взаимоисключающие — в одном запросе можно использовать только один из них.

curl --fail-with-body --request POST \
  --url https://api.toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.6-sunburst-official",
    "prompt": "Follow the markup annotations to adjust the layout",
    "image_urls": ["https://example.com/reference.png"],
    "markup_url": "https://example.com/markup.png",
    "quality": "high",
    "n": 1
  }'

Вывод GIF

Передайте gif в output_format, чтобы создать анимацию. frame_count задаёт число кадров (2-16), frame_duration_ms — длительность кадра. GIF поддерживает только text-to-image и не может сочетаться с image_urls, mask_url, markup_url, markup и output_compression. Передавайте size точным пиксельным значением (например 512x512) или опустите его, чтобы использовать размеры кадра по умолчанию от апстрима; соотношения вроде 1:1 для GIF отклоняются.

curl --fail-with-body --request POST \
  --url https://api.toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.6-flare-official",
    "prompt": "A paper airplane looping across a blue sky, flat illustration",
    "output_format": "gif",
    "frame_count": 8,
    "frame_duration_ms": 200,
    "size": "512x512",
    "n": 1
  }'

Вывод SVG

Передайте svg в output_format, чтобы создать векторное изображение. Также требуется объект svg с указанным svg.model. SVG поддерживает только text-to-image, n может быть только 1 и не может сочетаться с image_urls, mask_url, markup_url, markup и output_compression. SVG-генерация дополнительно вызывает текстовую модель, указанную в svg.model, и тарифицируется по её ставке.

curl --fail-with-body --request POST \
  --url https://api.toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.6-flare-official",
    "prompt": "A minimalist mountain logo, flat vector style",
    "output_format": "svg",
    "svg": { "model": "gpt-5" },
    "n": 1
  }'

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

Обе официальные модели тарифицируются по категориям токенов: текстовый ввод, кэшированный текстовый ввод, ввод изображений, кэшированный ввод изображений и вывод изображений оплачиваются отдельно. При отправке квота резервируется, а после успеха сумма уточняется по фактическому потреблению токенов с возвратом или доплатой.

Формула стоимости в USD:

USD = (
  uncached_text_input_tokens * text_input_price
  + cached_text_input_tokens * cached_text_input_price
  + uncached_image_input_tokens * image_input_price
  + cached_image_input_tokens * cached_image_input_price
  + image_output_tokens * image_output_price
) / 1,000,000

GIF тарифицируется по выходным токенам всей анимации. Вывод SVG дополнительно создаёт один вызов текстовой модели svg.model поверх токенов изображения.

Индивидуальные цены и скидки аккаунта продолжают действовать. Итоговое списание можно проверить в журнале использования; актуальные цены — на странице цен и в настройках аккаунта.

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

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