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

Запрос

POST/v1/generationsmodel: seedream-5.0-pro · mode: layer_decomposition
json
{
  "model": "seedream-5.0-pro",
  "mode": "layer_decomposition",
  "variant": "normal",
  "parameters": {
    "size": "auto",
    "num_outputs": 1,
    "output_format": "png",
    "watermark": false
  },
  "input": {
    "image": { "type": "https_url", "url": "https://cdn.example.com/poster.png" },
    "prompt": "Separate the title, subject, shadows, and background"
  }
}

По умолчанию база и слои возвращаются в PNG. Можно явно запросить JPEG для базы; остальные слои остаются PNG. Промпт необязателен. num_outputs: 1 обозначает один результат разложения — это не число слоёв.

Вход и результат

  • Вход: ровно одно JPEG- или PNG-изображение через HTTPS URL или готовый media_asset_id; от 262 144 до 36 000 000 пикселей и не более 30 000 000 байт.
  • Размер: auto, 1K, 1.5K или 2K.
  • Результат: одно базовое изображение в выбранном JPEG- или PNG-формате и до 16 PNG-слоёв.

Артефакты слоёв

json
{
  "artifacts": [
    { "kind": "image", "artifact_index": 0, "role": "base", "content_type": "image/png", "download_url": "https://..." },
    {
      "kind": "image",
      "artifact_index": 1,
      "role": "layer",
      "content_type": "image/png",
      "metadata": {
        "schema_version": 1,
        "z_index": 1,
        "name": "subject",
        "description": "Main subject",
        "bounding_box": { "absolute": [120, 88, 940, 1210], "normalized": [117, 86, 918, 1000] }
      },
      "download_url": "https://..."
    }
  ]
}

Сортируйте слои по metadata.z_index и сохраняйте файлы слоёв в PNG при импорте в редактор.

Стоимость в USD

При создании billing.reserved_amount содержит максимальный резерв для базового изображения и возможных слоёв. После успеха Gensta списывает стоимость базы и каждого фактически возвращённого слоя, возвращает итоговую сумму в billing.charged_amount и освобождает остаток резерва. Текущие цены в USD публикует GET /v1/models.