gensta DOCS
api-platform.gensta.ai/v1 Портал разработчика

Запрос и параметры

POST/v1/generationsGPT Image 2.5
json
{
  "model": "gpt-image-2.5",
  "variant": "sunburst",
  "mode": "image_generation",
  "input": { "prompt": "A product photograph on a blue background", "images": [] },
  "parameters": { "size": "1024x1024", "quality": "medium", "output_format": "png", "background": "auto", "num_outputs": 1 }
}

Один маршрут, два варианта: sunburst (по умолчанию) и flare. Без входных изображений выполняется генерация, с изображениями — редактирование. Добавьте до 4 HTTPS URL или media_asset в input.images. Промпт: 1–4000 символов. num_outputs: целое число от 1 до 10, по умолчанию 1. Все результаты доступны в artifacts.

Размер по умолчанию 1024x1024; custom WIDTHxHEIGHT: стороны кратны 16, максимум 3840, 655360–8294400 пикселей, аспект до 3:1. Качество: low, medium (по умолчанию), high, xhigh, max. Формат png (по умолчанию) или jpeg. Фон auto (по умолчанию), opaque или transparent; прозрачность требует PNG. Параметры size/quality=auto, WebP и mask пока не поддерживаются Gensta.

Итоговая цена — фактические токены текста, изображений, кешированного входа и результата. Актуальные цены доступны в GET /v1/models. До отправки резервируется расчётная сумма с запасом; неиспользованный остаток возвращается. Неопределённый результат отправки не запускает повторную платную генерацию.