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

Текст в изображение

POST/v1/generationsmodel: seedream-5.0-pro · mode: image_generation
json
{
  "model": "seedream-5.0-pro",
  "mode": "image_generation",
  "variant": "normal",
  "parameters": {
    "size": "1.5K",
    "num_outputs": 1,
    "prompt_optimization": "standard",
    "output_format": "jpeg",
    "watermark": false
  },
  "input": {
    "prompt": "A glass perfume bottle on dark stone, studio light",
    "images": []
  }
}

num_outputs — число альтернативных результатов. Seedream 5 Pro сейчас принимает и возвращает ровно 1. Повторный запрос будет отдельной платной генерацией.

Референсы и редактирование

Можно передать от нуля до десяти изображений. Если изображения есть, опишите нужное изменение в prompt. Каждый элемент — стабильный HTTPS URL или готовый media_asset_id.

json
{
  "model": "seedream-5.0-pro",
  "mode": "image_generation",
  "variant": "normal",
  "parameters": {
    "size": "2K",
    "num_outputs": 1,
    "prompt_optimization": "fast",
    "output_format": "png",
    "watermark": false
  },
  "input": {
    "prompt": "Keep the product shape, place it in a snowy forest",
    "images": [
      { "type": "https_url", "url": "https://cdn.example.com/product.png" },
      { "type": "media_asset", "media_asset_id": "7c74c900-8b68-4b0f-a337-32ed3a9a2020" }
    ]
  }
}

Изображение по внешнему HTTPS URL может быть JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC или HEIF. Для повторно используемой загрузки доступны JPEG, PNG и WebP. Ограничения каждого изображения: до 30 000 000 байт, до 36 000 000 пикселей и не менее 15 пикселей по каждой стороне.

Для редактирования области отметьте точку или рамку на входном изображении и сошлитесь на неё в промпте. Используется тот же режим image_generation.

Параметры

ПолеЗначенияСмысл
size1K, 1.5K, 2K или WIDTHxHEIGHTРазмер результата; ограничения своих размеров возвращает GET /v1/models
num_outputs1Число альтернатив, а не число слоёв
prompt_optimizationstandard или fastРежим оптимизации промпта
output_formatpng или jpegФормат результата
watermarkbooleanДобавить отметку о сгенерированном контенте

Стоимость в USD

GET /v1/models возвращает текущую цену Gensta для изображения до 2,61 Мп, свыше 2,61 Мп и доплату за каждое входное изображение начиная со второго. В ответе на создание billing.reserved_amount содержит сумму резерва, а после успеха billing.charged_amount — итоговое списание в USD.