> ## Documentation Index > Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt > Use this file to discover all available pages before exploring further. # GPT Image 2.5 API: цена $0.03 за изображение, нативное 4K > Как вызвать GPT Image 2.5 Flare и Sunburst с API-ключом LaoZhang API: маршруты VIP, пересылка через официальный API и веб-маршрут, генерация и редактирование. GPT Image 2.5 — актуальная модель изображений OpenAI в двух вариантах: **Flare** для быстрой генерации высокого качества и **Sunburst** для точного редактирования. LaoZhang API отдаёт их по трём маршрутам, поэтому выберите один из них, прежде чем копировать запрос. Модели VIP (`-vip`) стоят \$0.03 за изображение при любом размере от 1K до 4K и любом уровне качества от `low` до `max`, как для генерации, так и для редактирования. 4K создаётся нативно в запрошенном размере, без апскейла. Лимитов параллельности и частоты запросов нет ни на одном маршруте, а запросы автоматически переключаются между несколькими upstream-маршрутами. ## Выбор маршрута | Маршрут | ID модели | Группа токена | Цена | | - | - | - | - | | Пересылка через официальный API | `gpt-image-2.5-flare`, `gpt-image-2.5-sunburst` | Группа с пересылкой через официальный API | По токенам | | VIP, оплата за вызов | `gpt-image-2.5-flare-vip`, `gpt-image-2.5-sunburst-vip` | `default` или другая группа изображений | \$0.03 за вызов | | Веб-маршрут | `gpt-image-2.5-web` | `default` или другая группа изображений | \$0.03 за вызов | * Для пересылки через официальный 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](https://docs.laozhang.ai/ru/api-capabilities/gpt-image-2.md). ## Цена и возможности Публичные цены на 24 сентября 2026 года, проверены 14 октября 2026 года; актуальный список — в разделе [Модели и цены](https://docs.laozhang.ai/ru/models.md). На маршрутах VIP и веб размер и все пять уровней качества стоят одинаково, а редактирование стоит столько же, сколько генерация. Модель приходит по официальному каналу OpenAI: пересылка через официальный API тарифицируется по токенам OpenAI, а маршруты с оплатой за вызов берут одну фиксированную цену, которая при высоком разрешении и высоком качестве ниже, чем оплата по токенам. ### Стоимость изображения по уровням качества Оба маршрута обслуживают одну и ту же модель, поэтому запрос тратит одинаковое число токенов на любом из них, а отличается только оплата. Число токенов ниже получено для запроса на генерацию с этой страницы при размере 1024×1024; замеры в LaoZhang API проведены 9 сентября и 14 октября 2026 года: | `quality` | Токены изображения на выходе | Пересылка через официальный API, за изображение | VIP, за вызов | | - | -: | -: | -: | | `low` | 196 | \$0.0059 | \$0.03 | | `medium` | 439 | \$0.0132 | \$0.03 | | `high` | 1,756 | \$0.0527 | \$0.03 | | `xhigh` | 3,122 | \$0.0937 | \$0.03 | | `max` | 7,024 | \$0.2107 | \$0.03 | * Стоимость при пересылке через официальный API = токены изображения на выходе × \$30 за 1M в группе `OpenAI Official`. Входные токены текста и референсных изображений оплачиваются отдельно, а `OpenAI Official Enterprise` добавляет 20%. * Цена VIP одинакова при любом размере и качестве, с референсными изображениями и без них, для генерации и редактирования. * Начиная с уровня `high`, изображение через VIP обходится дешевле. ![Белая керамическая кружка на сером столе в мягком естественном свете, сгенерировано GPT Image 2.5 Flare VIP](https://mintcdn.com/laozhangai-edd05f2c/YuJHjB7ivlJQODe0/images/samples/gpt25-en-generate.jpg?fit=max\&auto=format\&n=YuJHjB7ivlJQODe0\&q=85\&s=c5d4c6e87ffcd637d3eaa141a35e70da) Пример генерации через VIP: Flare VIP, 2048×2048, medium. Промпт: A product photo of a white ceramic mug on a gray desk in soft natural light ![Та же кружка после редактирования GPT Image 2.5 Sunburst VIP: корпус тёмно-синий, композиция и освещение не изменились](https://mintcdn.com/laozhangai-edd05f2c/YuJHjB7ivlJQODe0/images/samples/gpt25-en-edit.jpg?fit=max\&auto=format\&n=YuJHjB7ivlJQODe0\&q=85\&s=943ccfe7d860344b062b888ba14d42c6) Пример редактирования через VIP: Sunburst VIP меняет цвет только корпуса кружки на тёмно-синий. Промпт: Keep the mug shape, composition, and lighting. Change only the mug body to dark blue. | Возможность | VIP, оплата за вызов | Пересылка через официальный API | | - | - | - | | Нужен ли аккаунт OpenAI | Нет, только API-ключ LaoZhang API | Нет | | Генерация по тексту и редактирование | Оба режима по одной цене | Оба режима, по токенам | | Прозрачный PNG | Да: `background="transparent"` и `output_format="png"` | Да, с теми же параметрами, что у OpenAI | | Референсные изображения | Редактирование загруженных изображений, несколько за запрос через `image[]`; без `mask` | До 16, с `mask` | | Размер и качество | Произвольные размеры до 3840 px по стороне, нативные 2K и 4K; от `low` до `max` по одной цене | Размеры и уровни качества OpenAI | | Параллельность и лимиты | Нет лимита RPM (запросов в минуту), IPM (изображений в минуту) и параллельности на ключ; `429` возникает из-за ёмкости апстрима, см. [Параллельность и 429](https://docs.laozhang.ai/ru/faq/api-concurrency.md) | То же | | Доступность | При сбое одного из upstream-маршрутов запрос автоматически уходит на другой | То же | | Неудачные запросы | Ответы не 200 не тарифицируются, см. [Оплата и ошибки](https://docs.laozhang.ai/ru/api-capabilities/image-billing-and-failures.md) | То же | ## Модели и группы для пересылки через официальный API | ID модели в запросе | Текущий снимок | Когда выбирать | | - | - | - | | `gpt-image-2.5-flare` | `gpt-image-2.5-flare-2026-09-08` | Быстрая повседневная генерация высокого качества | | `gpt-image-2.5-sunburst` | `gpt-image-2.5-sunburst-2026-09-08` | Генерация и редактирование, где важнее всего точность правок | В большинстве интеграций используйте алиас без даты. Если нужно зафиксировать снимок, берите ID с датой. Алиас в будущем может указывать на более новый снимок. 1. В разделе [Управление токенами](https://api.laozhang.ai/token) создайте токен с режимом оплаты **«сначала по использованию»** (按量优先, рекомендуется) или **«оплата по использованию»** (按量计费) и убедитесь, что он разрешает нужную модель. 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` на алиас или снимок из таблицы. ## Генерация и редактирование через пересылку Для генерации используется `POST /v1/images/generations`, для редактирования — `POST /v1/images/edits`; в OpenAI SDK это `images.generate` и `images.edit`. Сначала задайте ключ из группы с пересылкой через официальный API и базовый URL: ```bash theme={null} export LAOZHANG_API_KEY="YOUR_OFFICIAL_FORWARD_GROUP_KEY" export BASE_URL="https://api.laozhang.ai/v1" ``` ### Генерация через Flare ```bash theme={null} 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 Положите в текущую папку файл `source.png` и выполните: ```bash theme={null} 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 ``` Оба варианта принимают текст и изображения: Flare тоже умеет редактировать, а Sunburst — генерировать. Запросы с пересылкой через официальный API используют параметры OpenAI, описанные в [руководстве OpenAI по генерации изображений](https://developers.openai.com/api/docs/guides/image-generation). Не смешивайте их с параметрами маршрутов с оплатой за вызов, которые описаны ниже. ### Сохранение и проверка изображения Сохраните скрипт как `save_images.py`. Он записывает на диск все изображения из ответа, будь то `b64_json` или `url`: ```python save_images.py theme={null} 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}") ``` ```bash theme={null} python3 save_images.py generation.json generation python3 save_images.py edit.json edit ``` Откройте сохранённый файл и проверьте размеры. После редактирования убедитесь, что изменилось именно то, что вы просили, а остальные детали остались прежними. Затем сверьте модель, группу, расход и списание в [журнале вызовов](https://api.laozhang.ai/log). При ошибке авторизации или доступа к модели сначала проверьте ключ, его группу и ID модели. Некорректные параметры исправьте по тексту ошибки. Если в ответе нет изображения, сохраните ошибку без секретных данных и время запроса, сверьтесь со [справочником Images API](https://docs.laozhang.ai/ru/api-reference/images.md) и обратитесь в поддержку, не пересылая ключ целиком. ## Оплата при пересылке через официальный API `gpt-image-2.5-flare` и `gpt-image-2.5-sunburst` тарифицируются по фактическому расходу: входной текст, входные изображения и изображение на выходе оплачиваются по тем же тарифам за токены, что и `gpt-image-2` на этом маршруте. В группе `OpenAI Official` они стоят: | Тип расхода | Цена за 1M токенов | | - | - | | Входной текст | \$5 | | Входной текст из кэша | \$1.25 | | Входные изображения | \$8 | | Входные изображения из кэша | \$2 | | Изображение на выходе | \$30 | Эти тарифы совпадают с [опубликованными ценами OpenAI за токены](https://developers.openai.com/api/docs/guides/image-generation#cost-and-latency). В группе `OpenAI Official Enterprise` добавляется 20% (множитель группы 1.2), поэтому изображение на выходе там стоит \$36 за 1M токенов. Актуальные цены — в разделе [Модели и цены](https://docs.laozhang.ai/ru/models.md) и в [консоли](https://api.laozhang.ai/account/pricing); за корпоративными условиями обращайтесь в поддержку. Одинаковые тарифы за токены не означают одинаковую цену изображения: размер, качество и референсные изображения меняют расход, поэтому оценивайте стоимость по типичным запросам. ## Модели VIP с оплатой за вызов Обе модели VIP используют ту же интеграцию и ту же оплату за вызов, что и `gpt-image-2-vip`. Нужен токен группы `default` с режимом оплаты **«сначала по использованию»** (按量优先, рекомендуется) или **«оплата за вызов»** (按次计费). Оставляйте суффикс `-vip`: ID без суффикса — это модели с пересылкой через официальный API и оплатой по токенам, а группа `default` их не обслуживает. Параметры из этого раздела относятся только к двум моделям `-vip`. Не рассчитывайте, что они работают с `gpt-image-2.5-web`. С 16 по 22 сентября 2026 года обе модели `-vip` были недоступны, сейчас они снова работают; см. [объявление о восстановлении](https://docs.laozhang.ai/en/announcements/gpt-image-2-5-vip-restored-2026-09-22.md). ### Размер и качество Обе модели VIP принимают `size` и `quality` при генерации. Если значение выбирать не нужно, опустите поле. | Параметр | Значение | Примечания | | - | - | - | | `size` | `ШИРИНАxВЫСОТА`, например `2048x2048` | Стандартные размеры и произвольные размеры в пределах ограничений ниже | | `quality` | `low`, `medium`, `high`, `xhigh` или `max` | Обе модели поддерживают все пять уровней | Обе модели поддерживают стандартные размеры 1K, 2K и 4K в квадратной, альбомной и портретной ориентации. Принимается и любой произвольный `size`, например `1440x960`, `1536x864` или `2048x1152`, если выполнены все условия: * Ширина и высота кратны **16**. * Ни одна сторона не превышает **3840 пикселей**. * Длинная сторона не больше чем в **3 раза** длиннее короткой, то есть соотношение сторон от **1:3 до 3:1**. * Общее число пикселей (ширина × высота) — от **655 360 до 8 294 400**. Тот же синтаксис и те же ограничения размера описаны в [руководстве OpenAI по генерации изображений](https://developers.openai.com/api/docs/guides/image-generation). В выпадающем списке рабочей области могут быть только типовые пресеты, но прямые запросы к API принимают любой допустимый размер. Типовые примеры: | Пример | `size` | Соотношение сторон | | - | - | - | | Квадрат 1K | `1024x1024` | 1:1 | | Альбомная | `1536x1024` | 3:2 | | Портретная | `1024x1536` | 2:3 | | Квадрат 2K | `2048x2048` | 1:1 | | Альбомная 4K | `3840x2160` | 16:9 | | Портретная 4K | `2160x3840` | 9:16 | > [!TIP] > > Начните с `size="2048x2048"` и `quality="medium"`. Качество влияет на детализацию и время ответа, а цена остаётся за вызов. Одиночные запросы 1024×1024, измеренные 9 сентября и 14 октября 2026 года, занимали примерно 20–70 с на `medium`, 23–49 с на `high`, 46–77 с на `xhigh` и 73–156 с на `max`; при том же уровне Sunburst отвечал медленнее Flare. Задайте клиентский таймаут не меньше 300 секунд и не повторяйте запрос, пока не проверите [журнал вызовов](https://api.laozhang.ai/log). Нестандартные размеры могут быть скорректированы: например, на `1023x1024` может прийти `1024x1024`. Если важны точные пиксели, берите размер, подходящий под условия выше, и проверяйте размеры полученного изображения. ### Генерация через модель VIP Существующая интеграция с `gpt-image-2-vip` может сохранить базовый URL, авторизацию, эндпоинт и обработку результата; измените только `model`. Этот запрос генерирует квадрат 2K, а результаты в примерах этого раздела сохраняются скриптом из подраздела «Сохранение и проверка изображения»: ```bash theme={null} 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 Редактирование идёт через `/v1/images/edits` в том же формате multipart, что и у `gpt-image-2-vip`. Загрузите локальный файл `source.png` и опишите изменение: ```bash theme={null} 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 Обе модели VIP умеют **генерировать изображение с прозрачным фоном** и **удалять фон у загруженного изображения, оставляя объект**. Для этого задайте два поля: в JSON при генерации или в полях формы multipart при редактировании. ```json theme={null} { "background": "transparent", "output_format": "png" } ``` #### Генерация изображения с прозрачным фоном ```bash theme={null} 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 ``` #### Удаление фона у загруженного изображения Загрузите локальный файл `source.png` и опишите объект, который нужно оставить: ```bash theme={null} 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 ``` В обоих примерах подойдёт любая из двух моделей VIP. Сохранённый PNG сохраняет альфа-канал, поэтому объект можно поместить на другой фон. Не конвертируйте файл в JPEG: при этом прозрачность пропадёт. В этих примерах используется размер 1024×1024; при других размерах проверьте альфа-канал на нескольких результатах, прежде чем на него полагаться. > [!NOTE] > > Прозрачный фон и редактирование отдельной области через `mask` — разные функции. Модели VIP не поддерживают `mask`. Чтобы удалить фон, используйте `background="transparent"` и промпт с описанием объекта, который нужно оставить, как показано выше. ## Веб-маршрут: gpt-image-2.5-web `gpt-image-2.5-web` — веб-маршрут GPT Image 2.5: * Оплата за вызов. * Поддерживает генерацию (`/v1/images/generations`) и редактирование (`/v1/images/edits`), принимает `size`. * Рендерит нативно примерно до 2K. На запрос размера 4K придёт изображение запрошенных размеров, но с детализацией порядка 2K, увеличенной до 4K. Для детализации 4K используйте модель `-vip` или модель с пересылкой через официальный API. * Не позволяет выбрать Flare или Sunburst. Чтобы получить конкретный вариант, вызывайте его ID с пересылкой через официальный API или с суффиксом `-vip`. Поддерживаемые параметры зависят от настроек консоли и фактических результатов, поэтому проверьте права своего токена и полученное изображение, прежде чем на них полагаться. > [!WARNING] > > **`gpt-image-2.5-web` и `gpt-image-2-web` — разные маршруты; не считайте, что у них общая маршрутизация и параметры.** > > * `gpt-image-2-web` — прежний ID веб-маршрута, который используют существующие интеграции. > * Он тоже оплачивается за вызов, поддерживает и генерацию, и редактирование (`/v1/images/edits`) и так же рендерит нативно примерно до 2K. ## Частые вопросы ### Можно ли вызывать GPT Image 2.5 без аккаунта OpenAI? Да. Нужен только API-ключ LaoZhang API, аккаунт OpenAI не требуется. Все три маршрута используют совместимые с OpenAI эндпоинты Images, поэтому в существующем коде на OpenAI SDK достаточно сменить `base_url` и ключ. ### Как вызвать GPT Image 2.5 API по минимальной цене? Берите модель VIP (`gpt-image-2.5-flare-vip` или `gpt-image-2.5-sunburst-vip`) за \$0.03 за изображение. Размер (от 1K до 4K), качество (от `low` до `max`) и режим (генерация или редактирование) на цену не влияют. То же изображение 1024×1024 на `max` стоит около \$0.21 за выходные токены при пересылке через официальный API — в семь раз дороже, чем VIP. При пересылке большие размеры тратят больше токенов, а VIP остаётся на \$0.03. См. таблицу «Стоимость изображения по уровням качества» выше. ### VIP 4K нативное или увеличенное? Нативное. Обе модели `-vip` создают 2K и 4K сразу в запрошенном `size`, а не рисуют маленькое изображение с последующим апскейлом, поэтому детали остаются чёткими при увеличении. Для альбомного 4K используйте `3840x2160`, для портретного — `2160x3840`. Веб-маршрут `gpt-image-2.5-web` рендерит нативно примерно до 2K, поэтому для детализации 4K берите модель `-vip`. ### Будут ли ограничения при пакетной обработке? Нет. У одного ключа нет лимита RPM (запросов в минуту), IPM (изображений в минуту) и параллельности, а запросы переключаются между несколькими upstream-маршрутами. Редкий `429` связан с ёмкостью апстрима, не тарифицируется, и запрос можно повторить после короткой паузы; см. [Параллельность и 429](https://docs.laozhang.ai/ru/faq/api-concurrency.md). ### Стоят ли Flare и Sunburst одинаково и какую выбрать? Да. У двух моделей с пересылкой через официальный API общие тарифы за токены (см. раздел «Оплата при пересылке через официальный API»), а у двух моделей `-vip` одинаковая цена за вызов, поэтому выбирайте по результату: Flare — для быстрой повседневной генерации, Sunburst — для правок, где важнее всего сохранить детали исходного изображения. Обе модели умеют и генерировать, и редактировать, так что пользователям можно предложить обе. Один и тот же промпт на `max` 14 октября 2026 года потратил на обеих моделях по 7 024 выходных токена; Flare ответил за 73 с, Sunburst — за 156 с: ![Белая керамическая кружка на сером столе рядом с растением и блокнотом, сгенерировано GPT Image 2.5 Flare VIP на качестве max](https://mintcdn.com/laozhangai-edd05f2c/OW_Sg0uu2VZHhNxY/images/samples/gpt25-en-flare-max.jpg?fit=max\&auto=format\&n=OW_Sg0uu2VZHhNxY\&q=85\&s=9c96ca8e6c085890834be2ad65ddd190) Flare VIP, 1024×1024, max: 73 с ![Белая керамическая кружка на сером столе у окна рядом с ноутбуком и книгами, сгенерировано GPT Image 2.5 Sunburst VIP на качестве max](https://mintcdn.com/laozhangai-edd05f2c/OW_Sg0uu2VZHhNxY/images/samples/gpt25-en-sunburst-max.jpg?fit=max\&auto=format\&n=OW_Sg0uu2VZHhNxY\&q=85\&s=2aa6d8f86f21535fc141f62eaa49efd6) Sunburst VIP, 1024×1024, max: 156 с ### Что дешевле за изображение: VIP или пересылка через официальный API? Это зависит от уровня качества; см. таблицу «Стоимость изображения по уровням качества» выше. При 1024×1024 пересылка через официальный API дешевле на `low` и `medium`, а VIP дешевле начиная с `high`, где изображение по токенам уже стоит больше \$0.05. Кроме того, VIP держит цену \$0.03 для 2K и 4K и для правок с референсными изображениями. ### Стоит ли редактирование или референсное изображение дороже? На маршруте VIP — нет: правка с одним или несколькими референсами `image[]` — это один вызов за \$0.03. При пересылке через официальный API каждое референсное изображение тарифицируется как входные токены изображения по \$8 за 1M поверх выходных токенов, поэтому правка обходится дороже генерации того же качества. ### Можно ли оставить настройки качества gpt-image-2 для 2.5? Значения `low`, `medium` и `high` по-прежнему работают, но одна и та же настройка может давать разное число выходных токенов в GPT Image 2 и 2.5. По данным OpenAI, цена за выходной токен изображения у обеих моделей одинакова, а число токенов при одной и той же настройке качества может различаться. После перехода прогоните собственные промпты на маршруте с пересылкой через официальный API и сравните стоимость и время ответа по полю `usage` в ответе или по [журналу вызовов](https://api.laozhang.ai/log). В GPT Image 2.5 появились ещё `xhigh` и `max`; GPT Image 2 заканчивается на `high`. Модели VIP тарифицируются за вызов, поэтому все пять уровней стоят одинаково и меняют только детализацию и время ответа. ### Сколько стоит изображение при пересылке и почему цена меняется? Фиксированной цены за изображение нет: вы платите за фактически потраченные токены по тарифам из раздела «Оплата при пересылке через официальный API». Если одинаковые запросы стоят по-разному, причина обычно в том, что `quality` не задан или равен `auto`. Тогда модель сама выбирает уровень по генерируемому изображению, поэтому два одинаковых запроса могут попасть на разные уровни и дать разное число выходных токенов. Чтобы бюджет был предсказуемым, явно задавайте `size` и `quality` и оценивайте стоимость изображения по `usage` в нескольких типичных запросах. Фактическое списание по каждому запросу видно в [журнале вызовов](https://api.laozhang.ai/log). ### Списывается ли оплата при ошибке или таймауте? Запросы с ответом не 200 не тарифицируются: это неверные параметры, блокировки модерации, ошибки авторизации и лимиты. Если изображение создано и возвращено, маршрут с пересылкой через официальный API списывает фактические токены, а модели `-vip` и веб-модель — оплату за вызов. Таймаут или разрыв соединения на клиенте не отменяет генерацию на сервере, и готовое изображение всё равно тарифицируется. Высокие разрешения и уровни качества занимают больше времени, поэтому задавайте щедрый клиентский таймаут. После таймаута найдите предыдущий запрос в [журнале вызовов](https://api.laozhang.ai/log), прежде чем повторять, чтобы не сгенерировать и не оплатить изображение дважды. Фактическое списание видно в журнале. ### Ссылка вместо Base64: почему response\_format даёт ошибку? Маршрут с пересылкой через официальный API следует правилам OpenAI: модели GPT Image всегда возвращают данные изображения в Base64 и не поддерживают `response_format` — параметр времён DALL·E. Его передача может вернуть ошибку неверного параметра, поэтому уберите его. Если нужна ссылка, декодируйте `b64_json` и загрузите файл в собственное хранилище. У моделей с оплатой за вызов (`-vip`) формат результата выбирает `response_format`: * `b64_json` — только данные изображения в Base64, в `data[0].b64_json`. * `url` — ссылка на изображение. Ссылки истекают, поэтому скачайте изображение сразу и скопируйте в собственное хранилище. * Поле опущено — обычно Base64, иногда ссылка. Если ваш код читает только `b64_json`, явно передайте `response_format: "b64_json"`. Скрипт `save_images.py` с этой страницы сохраняет любое из двух полей; см. подраздел «Сохранение и проверка изображения». ### Можно ли редактировать с несколькими референсами или маской? Да, на маршруте с пересылкой через официальный API, который следует правилам OpenAI: * Отправляйте до 16 референсных изображений, повторяя поле `image[]` в запросе multipart. Они тарифицируются как входные токены изображения, поэтому больше референсов — выше стоимость. * `mask` применяется только к первому изображению. Она должна совпадать с ним по формату и размеру и содержать альфа-канал. Используйте маску PNG до 4 МБ; исходное изображение должно быть меньше 50 МБ. * Модель воспринимает маску как подсказку и может не следовать точным границам, поэтому проверьте результат на нескольких запросах, прежде чем на него полагаться. Две модели `-vip` принимают несколько референсных изображений в одном запросе через повторяющиеся поля `image[]`, но не поддерживают `mask`: они не гарантируют, что правка ограничится выделенной областью. Чтобы удалить фон, используйте настройки из раздела «Прозрачный PNG». ### Можно ли передать в эндпоинт редактирования URL изображения? Нет. `/v1/images/edits` принимает файлы изображений, загруженные как multipart form data. Поле `image_url` в теле JSON или URL в поле формы вернут ошибку. Если изображение лежит на CDN, сначала скачайте его, а затем загрузите файл: ```bash theme={null} 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](https://docs.laozhang.ai/ru/api-capabilities/gpt-image-2.md): существующие интеграции с `gpt-image-2` и `gpt-image-2-vip` * [Справочник Images API](https://docs.laozhang.ai/ru/api-reference/images.md): общий формат запросов и ответов * [Сравнение API изображений](https://docs.laozhang.ai/ru/api-capabilities/image-generation-guide.md): GPT Image 2.5 и другие модели изображений * [Журнал вызовов](https://docs.laozhang.ai/en/faq/call-logs.md): модель, группа и списание по каждому запросу * [Модели и цены](https://docs.laozhang.ai/ru/models.md): актуальные цены и группы ## Источники * [Руководство OpenAI по генерации изображений](https://developers.openai.com/api/docs/guides/image-generation) * [Справочник OpenAI Images API](https://developers.openai.com/api/reference/resources/images) * [OpenAI GPT Image 2.5 Flare](https://developers.openai.com/api/docs/models/gpt-image-2.5-flare) * [OpenAI GPT Image 2.5 Sunburst](https://developers.openai.com/api/docs/models/gpt-image-2.5-sunburst) * [Модели и цены LaoZhang API в консоли](https://api.laozhang.ai/account/pricing) * [Объявление о запуске GPT Image 2.5](https://docs.laozhang.ai/en/announcements/gpt-image-2-5-2026-09.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.