GPT Image 2.5 Sunburst

Изображения

Протоколы и возможности

generations, images_generations, images_edits

Режимы и параметры

text · text-to-image

Промпт: required; предел символов: 32000.

Параметр	Назначение	По умолчанию	Допустимые значения
`aspect_ratio`	Кадр	`"16:9"`	`{ "required": true, "values": [ "16:9", "9:16", "1:1", "4:3", "3:4", "3:2", "2:3" ] }`
`resolution`	Разрешение	`"2K"`	`{ "required": true, "values": [ "1K", "2K", "4K" ] }`
`quality`	Качество	`"medium"`	`{ "required": true, "values": [ "low", "medium", "high", "xhigh", "max" ] }`
`background`	Фон	`"auto"`	`{ "required": true, "values": [ "auto", "opaque", "transparent" ] }`
`output_format`	Формат файла	`"png"`	`{ "required": true, "values": [ "png", "jpeg", "webp" ] }`

Входные файлы

Параметр	Назначение	По умолчанию	Допустимые значения
`reference_images`	Изображения	—	`{ "media_kind": "image", "required": false, "min_items": 0, "max_items": 16, "collection": true, "ordered": false, "accept": [ "image/png", "image/jpeg", "image/webp" ], "max_bytes": 20971520 }`

edit · image-to-image

Промпт: required; предел символов: 32000.

Параметр	Назначение	По умолчанию	Допустимые значения
`aspect_ratio`	Кадр	`"16:9"`	`{ "required": true, "values": [ "16:9", "9:16", "1:1", "4:3", "3:4", "3:2", "2:3" ] }`
`resolution`	Разрешение	`"2K"`	`{ "required": true, "values": [ "1K", "2K", "4K" ] }`
`quality`	Качество	`"medium"`	`{ "required": true, "values": [ "low", "medium", "high", "xhigh", "max" ] }`
`background`	Фон	`"auto"`	`{ "required": true, "values": [ "auto", "opaque", "transparent" ] }`
`output_format`	Формат файла	`"png"`	`{ "required": true, "values": [ "png", "jpeg", "webp" ] }`

Входные файлы

Параметр	Назначение	По умолчанию	Допустимые значения
`reference_images`	Изображения	—	`{ "media_kind": "image", "required": true, "min_items": 1, "max_items": 16, "collection": true, "ordered": false, "accept": [ "image/png", "image/jpeg", "image/webp" ], "max_bytes": 20971520 }`

Совместимость настроек

json

[
  {
    "allowed": {
      "output_format": [
        "png",
        "webp"
      ]
    },
    "when": {
      "background": "transparent"
    }
  },
  {
    "allowed": {
      "background": [
        "auto",
        "opaque"
      ]
    },
    "when": {
      "output_format": "jpeg"
    }
  }
]

Расчёт стоимости

Цена зависит от выбранных настроек и входных файлов. Калькулятор рассчитывает стоимость без генерации. Для расчёта с файлами используйте POST /v1/generations/quote с API-ключом. Тариф и параметры фиксируются при создании задачи.

Пример запроса

bash

curl "${RENDERFOX_BASE_URL:-https://api.renderfox.ru/v1}/generations" \
  -H "Authorization: Bearer $RENDERFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  --data-binary @request.json

json

{
  "model": "gpt-image-2.5-sunburst",
  "mode": "text",
  "prompt": "Создай результат по этому описанию.",
  "settings": {
    "aspect_ratio": "16:9",
    "resolution": "2K",
    "quality": "medium",
    "background": "auto",
    "output_format": "png"
  },
  "inputs": {}
}

Новый логический запрос — новый Idempotency-Key. Сетевой повтор использует прежние ключ и тело. Резерв, списание и возврат FC · Ошибки · Каталог.

Версия тарифа: 0440bb2078fc9758f6b8a87b7cf6a578836d74140b273c198e40c4027be4aaf0. Версия каталога: d12314f1d1fbe542. Последнее обновление источника: версия опубликованного каталога.