GPT Image 2.5 API: цена $0.03 за изображение, нативное 4K

​

Выбор маршрута

• Для пересылки через официальный API нужен токен в группе OpenAI Official (раньше Sora2Official) или OpenAI Official Enterprise (раньше GPTImage2 Sora2 Enterprise) с режимом оплаты «сначала по использованию» (в консоли — 按量优先) или «оплата по использованию» (按量计费). Тарифы за токены те же, что у gpt-image-2 на этом маршруте; подробнее в разделе «Оплата при пересылке через официальный API» ниже.
• Для VIP и веб-маршрута нужен токен с режимом «сначала по использованию» (按量优先) или «оплата за вызов» (按次计费); название другой группы изображений показывает консоль.
• Веб-маршрут рендерит нативно примерно до 2K. Если нужна детализация 4K, берите модель VIP или модель с пересылкой через официальный API; см. раздел «Веб-маршрут» ниже.
• Способ маршрутизации и оплаты определяют группа и режим оплаты токена, а не поле model. Все три маршрута работают через /v1/images/generations и /v1/images/edits. Если вы уже используете GPT Image 2, см. руководство по GPT Image 2.

​

Цена и возможности

​

Стоимость изображения по уровням качества

• Стоимость при пересылке через официальный API = токены изображения на выходе × $30 за 1M в группе OpenAI Official. Входные токены текста и референсных изображений оплачиваются отдельно, а OpenAI Official Enterprise добавляет 20%.
• Цена VIP одинакова при любом размере и качестве, с референсными изображениями и без них, для генерации и редактирования.
• Начиная с уровня high, изображение через VIP обходится дешевле.

​

Модели и группы для пересылки через официальный API

1. В разделе Управление токенами создайте токен с режимом оплаты «сначала по использованию» (按量优先, рекомендуется) или «оплата по использованию» (按量计费) и убедитесь, что он разрешает нужную модель.
2. Поместите токен в группу с пересылкой через официальный API. Группа — часть токена, а не запроса.
   • OpenAI Official тарифицируется по официальной цене OpenAI.
   • OpenAI Official Enterprise — корпоративная группа по официальной цене плюс 20% (множитель группы 1.2).
   • Источники: OpenAI Official сочетает ключи OpenAI и Azure OpenAI, а OpenAI Official Enterprise использует только ключи OpenAI.
3. Оставьте прежний код для Images API с пересылкой через официальный API, включая авторизацию и обработку результата. Измените только model на алиас или снимок из таблицы.

​

Генерация и редактирование через пересылку

export LAOZHANG_API_KEY="YOUR_OFFICIAL_FORWARD_GROUP_KEY"
export BASE_URL="https://api.laozhang.ai/v1"

​

Генерация через Flare

curl --fail-with-body "$BASE_URL/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-flare",
    "prompt": "A product photo of a white ceramic mug on a gray desk in soft natural light",
    "size": "1024x1024",
    "quality": "medium"
  }' \
  -o generation.json

​

Редактирование через Sunburst

curl --fail-with-body "$BASE_URL/images/edits" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -F "model=gpt-image-2.5-sunburst" \
  -F "image=@source.png" \
  -F "prompt=Keep the mug shape, composition, and lighting. Change only the mug body to dark blue." \
  -F "size=1024x1024" \
  -F "quality=medium" \
  -o edit.json

​

Сохранение и проверка изображения

import base64
import json
import sys
import urllib.request
from pathlib import Path

response_file, stem = sys.argv[1], sys.argv[2]
response = json.loads(Path(response_file).read_text())
if not response.get("data"):
    sys.exit(f"В {response_file} нет изображения: {response}")

for number, item in enumerate(response["data"], start=1):
    if item.get("b64_json"):
        # Убираем необязательный префикс data:image/...;base64, и восстанавливаем padding.
        value = item["b64_json"].split(",", 1)[-1]
        image = base64.b64decode(value + "=" * (-len(value) % 4))
    else:
        with urllib.request.urlopen(item["url"], timeout=120) as download:
            image = download.read()
    if image.startswith(b"\x89PNG"):
        extension = "png"
    elif image[:4] == b"RIFF" and image[8:12] == b"WEBP":
        extension = "webp"
    else:
        extension = "jpg"
    path = Path(f"{stem}-{number}.{extension}")
    path.write_bytes(image)
    print(f"Сохранено: {path}")

python3 save_images.py generation.json generation
python3 save_images.py edit.json edit

​

Оплата при пересылке через официальный API

​

Модели VIP с оплатой за вызов

​

Размер и качество

• Ширина и высота кратны 16.
• Ни одна сторона не превышает 3840 пикселей.
• Длинная сторона не больше чем в 3 раза длиннее короткой, то есть соотношение сторон от 1:3 до 3:1.
• Общее число пикселей (ширина × высота) — от 655 360 до 8 294 400.

​

Генерация через модель VIP

export LAOZHANG_API_KEY="YOUR_DEFAULT_GROUP_KEY"

curl --fail-with-body "https://api.laozhang.ai/v1/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-flare-vip",
    "prompt": "A product photo of a white ceramic mug on a gray desk in soft natural light",
    "size": "2048x2048",
    "quality": "medium"
  }' \
  -o vip-generation.json

python3 save_images.py vip-generation.json vip-generation

​

Редактирование через модель VIP

curl --fail-with-body "https://api.laozhang.ai/v1/images/edits" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -F "model=gpt-image-2.5-sunburst-vip" \
  -F "image=@source.png" \
  -F "prompt=Keep the mug shape, composition, and lighting. Change only the mug body to dark blue." \
  -o vip-edit.json

python3 save_images.py vip-edit.json vip-edit

​

Прозрачный PNG

{
  "background": "transparent",
  "output_format": "png"
}

​

Генерация изображения с прозрачным фоном

curl --fail-with-body "https://api.laozhang.ai/v1/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-flare-vip",
    "prompt": "Один флакон духов из кобальтово-синего стекла с серебристой крышкой, по центру, чёткий силуэт и свободное место вокруг. Без текста, водяных знаков и шахматной сетки.",
    "size": "1024x1024",
    "quality": "medium",
    "background": "transparent",
    "output_format": "png"
  }' \
  -o transparent-generation.json

python3 save_images.py transparent-generation.json transparent-generation

​

Удаление фона у загруженного изображения

curl --fail-with-body "https://api.laozhang.ai/v1/images/edits" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -F "model=gpt-image-2.5-sunburst-vip" \
  -F "image=@source.png" \
  -F "prompt=Удали весь фон и оставь только чашку с этикеткой. Сохрани форму чашки, цвета и текст. Без стола, стены и теней за пределами объекта." \
  -F "size=1024x1024" \
  -F "quality=medium" \
  -F "background=transparent" \
  -F "output_format=png" \
  -o transparent-edit.json

python3 save_images.py transparent-edit.json transparent-edit

​

Веб-маршрут: gpt-image-2.5-web

• Оплата за вызов.
• Поддерживает генерацию (/v1/images/generations) и редактирование (/v1/images/edits), принимает size.
• Рендерит нативно примерно до 2K. На запрос размера 4K придёт изображение запрошенных размеров, но с детализацией порядка 2K, увеличенной до 4K. Для детализации 4K используйте модель -vip или модель с пересылкой через официальный API.
• Не позволяет выбрать Flare или Sunburst. Чтобы получить конкретный вариант, вызывайте его ID с пересылкой через официальный API или с суффиксом -vip.

​

Частые вопросы

​

Можно ли вызывать GPT Image 2.5 без аккаунта OpenAI?

​

Как вызвать GPT Image 2.5 API по минимальной цене?

​

VIP 4K нативное или увеличенное?

​

Будут ли ограничения при пакетной обработке?

​

Стоят ли Flare и Sunburst одинаково и какую выбрать?

​

Что дешевле за изображение: VIP или пересылка через официальный API?

​

Стоит ли редактирование или референсное изображение дороже?

​

Можно ли оставить настройки качества gpt-image-2 для 2.5?

​

Сколько стоит изображение при пересылке и почему цена меняется?

​

Списывается ли оплата при ошибке или таймауте?

​

Ссылка вместо Base64: почему response_format даёт ошибку?

• b64_json — только данные изображения в Base64, в data[0].b64_json.
• url — ссылка на изображение. Ссылки истекают, поэтому скачайте изображение сразу и скопируйте в собственное хранилище.
• Поле опущено — обычно Base64, иногда ссылка. Если ваш код читает только b64_json, явно передайте response_format: "b64_json".

​

Можно ли редактировать с несколькими референсами или маской?

• Отправляйте до 16 референсных изображений, повторяя поле image[] в запросе multipart. Они тарифицируются как входные токены изображения, поэтому больше референсов — выше стоимость.
• mask применяется только к первому изображению. Она должна совпадать с ним по формату и размеру и содержать альфа-канал. Используйте маску PNG до 4 МБ; исходное изображение должно быть меньше 50 МБ.
• Модель воспринимает маску как подсказку и может не следовать точным границам, поэтому проверьте результат на нескольких запросах, прежде чем на него полагаться.

​

Можно ли передать в эндпоинт редактирования URL изображения?

curl --fail -sS -o source.jpg "https://cdn.example.com/your-photo.jpg"

curl --fail-with-body "https://api.laozhang.ai/v1/images/edits" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -F "model=gpt-image-2.5-sunburst-vip" \
  -F "image=@source.jpg" \
  -F "prompt=Оставь человека и композицию, замени фон на пляж на закате." \
  -o edit.json

• Весь запрос должен занимать меньше 20 МБ. Уменьшите большие фотографии или конвертируйте их в JPEG перед загрузкой: чем больше файл, тем дольше он загружается и обрабатывается.
• Multipart отправляет сырые байты файла, примерно на четверть меньше, чем то же изображение в Base64.

​

Связанные материалы

• Руководство по GPT Image 2: существующие интеграции с gpt-image-2 и gpt-image-2-vip
• Справочник Images API: общий формат запросов и ответов
• Сравнение API изображений: GPT Image 2.5 и другие модели изображений
• Журнал вызовов: модель, группа и списание по каждому запросу
• Модели и цены: актуальные цены и группы

​

Источники

• Руководство OpenAI по генерации изображений
• Справочник OpenAI Images API
• OpenAI GPT Image 2.5 Flare
• OpenAI GPT Image 2.5 Sunburst
• Модели и цены LaoZhang API в консоли
• Объявление о запуске GPT Image 2.5