Текущий раздел: GPT Image 2.5 Flare

GPT Image 2.5 Flare

Быстрое создание и редактирование изображений нового поколения

IDmodel-gpt-image-2-5-flarePOST/v1/generationsОриентирот 1,79 кредитов

Попробовать

Готовый запрос со значениями по умолчанию. Замените текст и ID файлов, оцените цену и запустите.

model-gpt-image-2-5-flare

curl -X POST https://lumv.app/v1/generations \
  -H "Authorization: Bearer $LUMV_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "model-gpt-image-2-5-flare",
  "values": {
    "prompt": "Describe the desired result",
    "image_size": "1024x1024",
    "quality": "medium",
    "num_images": 1,
    "background": "auto",
    "output_format": "png",
    "input_fidelity": "high"
  },
  "inputAssets": []
}'

Для оценки отправьте то же тело в POST /v1/generations/estimate без Idempotency-Key — ответ покажет costCents и блок billing с кошельком списания. Чтобы сохранить результат в папку, добавьте projectId.

Параметры

Передавайте значения в values, файлы — в inputAssets. Неизвестные параметры и null отклоняются.

Параметры10

promptstringобязательный
Что хотите создать? — Опишите изображение или точные изменения естественным языком.
По умолчанию
нет
Ограничения
до 32000 символов
image_urlsfile[] · inputAssetsнеобязательный
Референсы (необязательно) — Добавьте до 16 изображений — модель автоматически перейдёт в режим редактирования.
По умолчанию
нет
Ограничения
до 16 файлов · форматы: image/png,image/jpeg,image/webp
image_sizestring (размер)необязательный
Размер изображения — Выберите размер и соотношение сторон готового изображения.
По умолчанию
"1024x1024"
Допустимые значения
- autoAUTO
- 1024x10241024 × 1024 (1:1) · квадрат
- 1024x7681024 × 768 (4:3) · альбом
- 1536x10241536 × 1024 (3:2) · альбом
- 1920x10801920 × 1080 (16:9) · Full HD
- 2560x14402560 × 1440 (16:9) · 2K
- 3840x21603840 × 2160 (16:9) · 4K
- 3392x24003392 × 2400 (297:210) · A4 альбом
- 768x1024768 × 1024 (3:4) · портрет
- 1024x15361024 × 1536 (2:3) · портрет
- 1080x19201080 × 1920 (9:16) · Full HD
- 1440x25601440 × 2560 (9:16) · 2K
- 2160x38402160 × 3840 (9:16) · 4K
- 2400x33922400 × 3392 (210:297) · A4 портрет
- 2048x20481:1 · 2K
- 4096x40961:1 · 4K
- 2048x15364:3 · 2K
- 4096x30724:3 · 4K
- 1536x20483:4 · 2K
- 3072x40963:4 · 4K
- 1024x57616:9 · 1K
- 2048x115216:9 · 2K
- 4096x230416:9 · 4K
- 576x10249:16 · 1K
- 1152x20489:16 · 2K
- 2304x40969:16 · 4K
- 680x10242:3 · 1K
- 1368x20482:3 · 2K
- 2728x40962:3 · 4K
- 1024x6803:2 · 1K
- 2048x13683:2 · 2K
- 4096x27283:2 · 4K
- 1024x44021:9 · 1K
- 2048x88021:9 · 2K
- 4096x175221:9 · 4K
- 816x10244:5 · 1K
- 1640x20484:5 · 2K
- 3280x40964:5 · 4K
- 1024x8165:4 · 1K
- 2048x16405:4 · 2K
- 4096x32805:4 · 4K
image_resolutionstring (enum)необязательный
Разрешение при AUTO — Определяет детализацию, когда точные размеры выбирает модель.
По умолчанию
"1K"
Ограничения
активно, когда image_size = "auto"
Допустимые значения
- 1K
- 2K
- 4K
qualitystring (enum)необязательный
Качество
По умолчанию
"medium"
Допустимые значения
- lowБыстрое
- mediumСреднее
- highВысокое
- xhighОчень высокое
- maxМаксимальное
num_imagesnumberнеобязательный
Количество вариантов
По умолчанию
1
Ограничения
1–4
backgroundstring (enum)необязательный· расширенный
Фон
По умолчанию
"auto"
Допустимые значения
- autoАвто
- opaqueНепрозрачный
- transparentПрозрачный
output_formatstring (enum)необязательный· расширенный
Формат файла
По умолчанию
"png"
Допустимые значения
- pngPNG
- jpegJPEG
- webpWebP
input_fidelitystring (enum)необязательный· расширенный
Точность референса
По умолчанию
"high"
Допустимые значения
- lowОбычная
- highВысокая
mask_urlfile · inputAssetsнеобязательный· расширенный
Маска редактирования — Прозрачная область маски будет изменена.
По умолчанию
нет
Ограничения
форматы: image/png · требует image_urls

number и boolean — настоящие JSON-числа и логические значения, dimensions — строка из допустимых вариантов, json — JSON-значение или строка с JSON. «Обязательный» относится к активному сценарию: поля других сценариев и поля с невыполненным условием «активно, когда» не проверяются.

Сценарии

Сервер выбирает сценарий по values и файлам: при нескольких совпадениях — первый по порядку, сценарий без условия — запасной.

`scenario-0`передан файл image_urls

Активные поля: prompt, image_urls, image_size, image_resolution, quality, num_images, background, output_format, input_fidelity, mask_url

scenario-0 · тело запроса

{
  "model": "model-gpt-image-2-5-flare",
  "values": {
    "prompt": "Describe the desired result",
    "image_size": "1024x1024",
    "quality": "medium",
    "num_images": 1,
    "background": "auto",
    "output_format": "png",
    "input_fidelity": "high"
  },
  "inputAssets": [
    {
      "fieldName": "image_urls",
      "assetId": "REPLACE_WITH_READY_ASSET_ID",
      "position": 0
    }
  ]
}

`scenario-1`по умолчанию

Активные поля: prompt, image_urls, image_size, image_resolution, quality, num_images, background, output_format, input_fidelity, mask_url

scenario-1 · тело запроса

{
  "model": "model-gpt-image-2-5-flare",
  "values": {
    "prompt": "Describe the desired result",
    "image_size": "1024x1024",
    "quality": "medium",
    "num_images": 1,
    "background": "auto",
    "output_format": "png",
    "input_fidelity": "high"
  },
  "inputAssets": []
}

Цена и результат

Ориентир при стандартных настройках — 1,79 кредитов; точная цена зависит от параметров и кошелька, поэтому проверяйте её через estimate. Запуск возвращает HTTP 202, дальше опрашивайте GET /v1/generations/:id раз в 3–5 секунд до completed или failed.

Готовые файлы — в assets[] (url, downloadUrl, mediaAssetId), текст — в textOutput, 3D — в viewerUrl/modelUrl, а выбор форматов скачивания (GLB, FBX, OBJ) — в modelFormats[]. Ответ также содержит prompt, reuseValues, projectId, billingMode и usageUsdMicros. Подробнее — в разделах Запуск и статус и Ошибки и лимиты.

Машиночитаемая схема: GET /v1/generation-models/model-gpt-image-2-5-flare. Схема обновляется вместе с каталогом; выключенная модель возвращает 404.

GPT Image 2.5 Flare

Быстрое создание и редактирование изображений нового поколения

IDmodel-gpt-image-2-5-flarePOST/v1/generationsОриентирот 1,79 кредитов

Попробовать

Готовый запрос со значениями по умолчанию. Замените текст и ID файлов, оцените цену и запустите.

model-gpt-image-2-5-flare

curl -X POST https://lumv.app/v1/generations \
  -H "Authorization: Bearer $LUMV_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "model-gpt-image-2-5-flare",
  "values": {
    "prompt": "Describe the desired result",
    "image_size": "1024x1024",
    "quality": "medium",
    "num_images": 1,
    "background": "auto",
    "output_format": "png",
    "input_fidelity": "high"
  },
  "inputAssets": []
}'

Параметры

Передавайте значения в values, файлы — в inputAssets. Неизвестные параметры и null отклоняются.

Параметры10

promptstringобязательный
Что хотите создать? — Опишите изображение или точные изменения естественным языком.
По умолчанию
нет
Ограничения
до 32000 символов
image_urlsfile[] · inputAssetsнеобязательный
Референсы (необязательно) — Добавьте до 16 изображений — модель автоматически перейдёт в режим редактирования.
По умолчанию
нет
Ограничения
до 16 файлов · форматы: image/png,image/jpeg,image/webp
image_sizestring (размер)необязательный
Размер изображения — Выберите размер и соотношение сторон готового изображения.
По умолчанию
"1024x1024"
Допустимые значения
- autoAUTO
- 1024x10241024 × 1024 (1:1) · квадрат
- 1024x7681024 × 768 (4:3) · альбом
- 1536x10241536 × 1024 (3:2) · альбом
- 1920x10801920 × 1080 (16:9) · Full HD
- 2560x14402560 × 1440 (16:9) · 2K
- 3840x21603840 × 2160 (16:9) · 4K
- 3392x24003392 × 2400 (297:210) · A4 альбом
- 768x1024768 × 1024 (3:4) · портрет
- 1024x15361024 × 1536 (2:3) · портрет
- 1080x19201080 × 1920 (9:16) · Full HD
- 1440x25601440 × 2560 (9:16) · 2K
- 2160x38402160 × 3840 (9:16) · 4K
- 2400x33922400 × 3392 (210:297) · A4 портрет
- 2048x20481:1 · 2K
- 4096x40961:1 · 4K
- 2048x15364:3 · 2K
- 4096x30724:3 · 4K
- 1536x20483:4 · 2K
- 3072x40963:4 · 4K
- 1024x57616:9 · 1K
- 2048x115216:9 · 2K
- 4096x230416:9 · 4K
- 576x10249:16 · 1K
- 1152x20489:16 · 2K
- 2304x40969:16 · 4K
- 680x10242:3 · 1K
- 1368x20482:3 · 2K
- 2728x40962:3 · 4K
- 1024x6803:2 · 1K
- 2048x13683:2 · 2K
- 4096x27283:2 · 4K
- 1024x44021:9 · 1K
- 2048x88021:9 · 2K
- 4096x175221:9 · 4K
- 816x10244:5 · 1K
- 1640x20484:5 · 2K
- 3280x40964:5 · 4K
- 1024x8165:4 · 1K
- 2048x16405:4 · 2K
- 4096x32805:4 · 4K
image_resolutionstring (enum)необязательный
Разрешение при AUTO — Определяет детализацию, когда точные размеры выбирает модель.
По умолчанию
"1K"
Ограничения
активно, когда image_size = "auto"
Допустимые значения
- 1K
- 2K
- 4K
qualitystring (enum)необязательный
Качество
По умолчанию
"medium"
Допустимые значения
- lowБыстрое
- mediumСреднее
- highВысокое
- xhighОчень высокое
- maxМаксимальное
num_imagesnumberнеобязательный
Количество вариантов
По умолчанию
1
Ограничения
1–4
backgroundstring (enum)необязательный· расширенный
Фон
По умолчанию
"auto"
Допустимые значения
- autoАвто
- opaqueНепрозрачный
- transparentПрозрачный
output_formatstring (enum)необязательный· расширенный
Формат файла
По умолчанию
"png"
Допустимые значения
- pngPNG
- jpegJPEG
- webpWebP
input_fidelitystring (enum)необязательный· расширенный
Точность референса
По умолчанию
"high"
Допустимые значения
- lowОбычная
- highВысокая
mask_urlfile · inputAssetsнеобязательный· расширенный
Маска редактирования — Прозрачная область маски будет изменена.
По умолчанию
нет
Ограничения
форматы: image/png · требует image_urls

Сценарии

`scenario-0`передан файл image_urls

Активные поля: prompt, image_urls, image_size, image_resolution, quality, num_images, background, output_format, input_fidelity, mask_url

scenario-0 · тело запроса

{
  "model": "model-gpt-image-2-5-flare",
  "values": {
    "prompt": "Describe the desired result",
    "image_size": "1024x1024",
    "quality": "medium",
    "num_images": 1,
    "background": "auto",
    "output_format": "png",
    "input_fidelity": "high"
  },
  "inputAssets": [
    {
      "fieldName": "image_urls",
      "assetId": "REPLACE_WITH_READY_ASSET_ID",
      "position": 0
    }
  ]
}

`scenario-1`по умолчанию

Активные поля: prompt, image_urls, image_size, image_resolution, quality, num_images, background, output_format, input_fidelity, mask_url

scenario-1 · тело запроса

{
  "model": "model-gpt-image-2-5-flare",
  "values": {
    "prompt": "Describe the desired result",
    "image_size": "1024x1024",
    "quality": "medium",
    "num_images": 1,
    "background": "auto",
    "output_format": "png",
    "input_fidelity": "high"
  },
  "inputAssets": []
}

Попробовать

Параметры

Сценарии

scenario-0передан файл image_urls

scenario-1по умолчанию

Цена и результат

Попробовать

Параметры

Сценарии

scenario-0передан файл image_urls

scenario-1по умолчанию

Цена и результат

`scenario-0`передан файл image_urls

`scenario-1`по умолчанию

`scenario-0`передан файл image_urls

`scenario-1`по умолчанию