GPT-Image-2.6-All: генерация и редактирование

​

Обзор

• Цена: $0.025 за изображение, тарификация за вызов; стоимость 2K/4K такая же
• Скорость: около 10–46 с (1K: 10–22 с, 2K: 12–24 с, 4K: 15–42 с; задержка в отдельных случаях может превышать 60 с)
• Качество: длинная сторона 512–1536 — нативный диапазон: наиболее управляемый уровень качества веб-версии ChatGPT с fingerprint; 2K/4K — это суперразрешение, которое позволяет получить изображение на большом холсте, но не обязательно больше деталей, чем при 1,5K
• Форматы: PNG / JPEG / GIF / SVG, прозрачный фон и URL сроком действия 24 часа; GIF / SVG поддерживаются нативно этим маршрутом и недоступны в 2.5-all
• Китайский язык: нативные prompt на китайском языке; качественная отрисовка текста для плакатов, вывесок и инфографики

​

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

​

Из текста в изображение (curl)

curl https://api.apiyi.com/v1/images/generations \
  -H "Authorization: Bearer $APIYI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-all",
    "prompt": "A beige paper-textured autumn reading club poster, vertical Chinese title in the center, hand-drawn maple leaf at the bottom right",
    "size": "1536x1024",
    "response_format": "b64_json"
  }'

​

Редактирование изображения (Python, multipart)

import base64
import os

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["APIYI_API_KEY"],
    base_url="https://api.apiyi.com/v1",
    timeout=600,
)

with open("input.png", "rb") as f:
    result = client.images.edit(
        model="gpt-image-2.6-all",
        image=f,
        prompt="Replace the background with light gray, keep the subject and text",
        size="1536x1024",
    )

image_bytes = base64.b64decode(result.data[0].b64_json)
with open("edited.png", "wb") as f:
    f.write(image_bytes)

​

Возможности

​

Размеры

​

Нативный диапазон (≤1536, нативный режим веб-версии ChatGPT)

• Выравнивание по 16/64 не требуется. На нативном маршруте значения 1537, 1600x900 и 1920x1080 отклоняются.
• Значение size=auto определяется выше по цепочке. Мы наблюдали 1312x1199, 1402x1122 и 1448x1086; фиксированное значение не гарантируется.
• На нативном маршруте size в ответе совпадает с фактическим размером результата.

​

Диапазон сверхвысокого разрешения (2K / 4K, совместимость с большими холстами)

​

Выбор размера

• Максимально близко к нативному виду ChatGPT / стабильное качество: выбирайте size не больше 1536; оптимальное значение — около 1,5K. Это наиболее управляемый диапазон с характерным стилем ChatGPT.
• Совместимость с большими холстами 2K: используйте 2048x2048, 2048x1152, 2048x1536; распространённые размеры возвращаются без изменений, но не ожидайте большей детализации, чем при 1,5K.
• Альбомная ориентация 4K: используйте 3840x2160; обычно возвращается 3840x2160, иногда — 4096x2731. Проверьте фактическое количество пикселей.
• Большие квадраты: максимальный размер — 2880; 4096x4096 возвращается как 2880x2880.
• Баннеры с соотношением сторон 4:1: не поддерживаются; 4096x1024 возвращает 400.

​

Форматы

• Прозрачный фон: background=transparent + PNG. В разрешении 2K результат имеет формат RGBA, при этом около 40% пикселей полностью прозрачны. Прозрачный результат в разрешении 4K не соответствует size; размеры не гарантируются.
• URL: response_format=url работает в группе Default; группа Image2_OSS не требуется. Ссылка является подписанным URL, действительным в течение 24 часов.
• Без WebP: ошибка имеет вид output_format 'webp' is not supported; use png, jpeg, gif or svg.

​

GIF

curl https://api.apiyi.com/v1/images/generations \
  -H "Authorization: Bearer $APIYI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-all",
    "prompt": "A looping animation of a yellow doll frowning, puffing its cheeks and stomping, pure white background, seamless loop",
    "size": "2048x2048",
    "output_format": "gif",
    "frame_count": 8,
    "frame_duration_ms": 150
  }'

• output_format=gif является обязательным. Если в промпте запросить только зацикливание и не указать формат, слой совместимости ожидает PNG, и запрос завершается ошибкой 502 image 1 is gif, png was asked for.
• frame_count / frame_duration_ms соблюдаются точно: 8 кадров / 150 мс, 4 кадра / 300 мс и 6 кадров / 120 мс во всех случаях соответствовали запросу.
• size не определяет размер результата: результаты в 1K включали 384x512, 507x506 и 619x623; в 2K был получен размер 327x585; в 4K — 621x621. Гарантируются только количество кадров и длительность.
• Чтобы получить GIF фиксированного размера, измените размер или обрежьте изображение на стороне клиента после генерации.

​

SVG

curl https://api.apiyi.com/v1/images/generations \
  -H "Authorization: Bearer $APIYI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-all",
    "prompt": "A flat rocket icon, exactly three colors, no text",
    "size": "2048x2048",
    "output_format": "svg"
  }'

• Настоящая векторная графика: ответ представляет собой текст <svg>, а не растровое изображение. Проверены варианты 2048², 3840x2160, 4096², 6144² и 8192².
• viewBox соответствует size: 2048x2048 дает viewBox="0 0 2048 2048"; 3840x2160 дает viewBox="0 0 3840 2160".
• Объект svg не требуется: достаточно output_format=svg. Официальные маршруты или некоторые SDK добавляют "svg": {"model": "..."}; версия 2.6-all принимает это поле, но игнорирует его: запрос не завершается ошибкой, и результат не меняется, поэтому не полагайтесь на это поле.
• В выводе нет <script> или встроенного растрового изображения.

​

Редактирование изображений

• Эндпоинт: POST /v1/images/edits, multipart/form-data.
• Принимаются одно изображение, маска или несколько референсов. Маска рассматривается как референс; не гарантируется, что изменения останутся в пределах маски, поэтому опишите, что нужно изменить, а что оставить без изменений.
• Явно заданное size соблюдается точно, включая 2K/4K (оба варианта — 2048x2048 и 3840x2160 — проверены).
• Если size не задан или указано auto, размер выходного изображения нормализуется примерно до 1.57 MP с сохранением исходного соотношения сторон; исходный размер в пикселях не гарантируется.
• На практике работают два референсных изображения. Если их больше, объедините их на стороне клиента или редактируйте поэтапно.

​

n и ответы

• n поддерживает 1–10 и тарифицируется за изображение. При разрешении 2K n=2 вернул две картинки 2048x2048; n=3 вернул три изображения с usage.image_count=3 и output_image_tokens=8160 (3 × 2720). При цене $0.025 за изображение это составляет $0.075; итоговая сумма указана в счёте.
• По умолчанию используется b64_json; response_format=url возвращает только url, но не оба варианта.
• Распространённые поля ответа: created, data[], usage. Поле size может отсутствовать для 2K/4K; при 1K оно обычно возвращается.
• Срок действия подписанных URL — 24 часа; после истечения срока создайте их заново.

​

Тайм-ауты и параллельные запросы

• Установите тайм-аут клиента на 600 секунд: для 1K требуется около 10–22 с, для 2K — 12–24 с, для 4K — 15–42 с; задержка в хвосте может превышать 60 с. Также увеличьте лимиты обратных прокси, serverless-сервисов и обработчиков очередей.
• Параллельные запросы: для 1K успешно прошли тесты с параметрами 12×2, 16×1 и 8×1536 без ошибок 429. Нагрузка для 2K/4K не тестировалась; начните с 4–8 параллельных запросов и следите за задержкой в хвосте.
• Тарификация выполняется синхронно: запрос тарифицируется при отправке; отключение клиента не приводит к возврату средств, а результат не сохраняется.

​

Ограничения

• 2K/4K — это сверхразрешение для совместимости с большими холстами. Это не нативное разрешение; не гарантируется, что детализация будет выше, чем на нативном уровне 1536. Для стабильного качества используйте разрешение не выше 1536.
• 2K/4K зависит от резервного маршрута. Запросы сначала поступают на нативный маршрут и переключаются на маршрут сверхразрешения, если размер выходит за допустимый диапазон. Если резервный маршрут недоступен, API может вернуть ошибку 400 wide_fallback_required; повторите запрос или используйте разрешение не выше 1536.
• Размер GIF не гарантируется. При 1K, 2K и 4K могут возвращаться изображения небольшого размера; гарантируются только количество кадров и продолжительность.
• WebP не поддерживается. Поддерживаются только PNG / JPEG / GIF / SVG.
• Соотношение сторон 4:1 не поддерживается. 4096x1024 возвращает ошибку 400; максимальное соотношение сторон — 3:1.
• Прозрачный вывод в 4K нестабилен. Наблюдались разные значения высоты при длине большей стороны 4096 пикселей; не гарантируйте размер 3840x2160. Для прозрачного вывода используйте разрешение не выше 2K.
• Не полагайтесь на quality. low / medium / high принимаются, но low может возвращать 2048x1153 при 2K, тогда как medium / high возвращают 2048x2048; различий в качестве при одинаковом начальном значении генератора не подтверждено.
• Редактирование с auto изменяет масштаб. Выходное изображение имеет размер около 1,57 Мп, а не размер входного изображения.
• Политика в отношении контента: модерация на стороне поставщика возвращает ошибку 400 content_policy_violation; измените prompt и повторите запрос.

​

Ошибки

​

Поручите подключение ИИ-агенту

​

Часто задаваемые вопросы

​

Является ли разрешение 2K/4K нативным?

​

Почему в ответе для 2K/4K отсутствует size?

​

Можно ли создать прозрачное изображение 4K?

​

Можно ли задать размеры GIF?

​

Поддерживается ли WebP?

​

Имеет ли значение quality?

​

Почему не работает 4096x1024?

​

См. также

• API для генерации изображений по тексту
• API для редактирования изображений
• Обзор GPT-Image-2.5-All
• Сравнение официального и реверс-инжинирингового вариантов
• Рекомендации по работе с API изображений