---
title: "Создать запрос на генерацию на основе модели. Возвращает сразу с taskId"
method: POST
path: "/api/v1/generation/create"
tags: ["Генерации"]
---

# Создать запрос на генерацию на основе модели. Возвращает сразу с taskId

`POST /api/v1/generation/create`

## Request

- Base URL: `https://api.apihubs.ru`
- URL: `https://api.apihubs.ru/api/v1/generation/create`
- Auth: HTTP bearer

## Headers

- `idempotency-key` string, required
- `x-max-cost-micro-usd` string, required

## Request body

- CreateGenerationRequestDto
  - `model` 'veo3.1-fast' | 'veo3.1-quality' | 'veo3.1-lite' | 'nano-banana' | 'nano-banana-pro' | 'nano-banana-2' | 'nano-banana-2.1' | 'nano-banana-2-lite' | 'grok-imagine-1.5-video' | 'grok-imagine-1.5-image' | 'grok-imagine-2.0-image' | 'seedance-2.0' | 'seedance-2.0-fast' | 'seedance-2.0-mini' | 'seedance-2.5' | 'seedance-2.5-spicy' | 'seedance-1-5-pro' | 'gpt-image-2' | 'gpt-image-2.5-sunburst' | 'gpt-image-2.5-flare' | 'kling-3.0-motion-control' | 'kling-3.0' | 'kling-4.0' | 'pixverse-v6' | 'seedream-5-0-lite' | 'seedream-5-0-flash' | 'seedream-5-0-pro' | 'seedream-4-5' | 'wan2.7-video' | 'wan3.0-video' | 'wan3.0-video-prime' | 'wan3.0-video-pro' | 'flux-3-video' | 'flux-3-image' | 'gemini-omni-1.1-flash' | 'minimax-h3' | 'agnes-video-2.5' | 'z-image' | 'wan2.7-image' | 'wan2.7-image-pro' | 'midjourney' | 'midjourney-video' | 'suno', required: Модель генерации. Устаревшие идентификаторы по-прежнему принимаются и сопоставляются с текущей моделью: `doubao-seedance-2.0` → `seedance-2.0`, `doubao-seedance-2.0-fast` → `seedance-2.0-fast`, `doubao-seedance-2.0-mini` → `seedance-2.0-mini`, `doubao-seedance-2.5` → `seedance-2.5`, `doubao-seedance-1-5-pro` → `seedance-1-5-pro`, `doubao-seedream-4-5` → `seedream-4-5`, `doubao-seedream-5-0-lite` → `seedream-5-0-lite`, `doubao-seedream-5-0-pro` → `seedream-5-0-pro`.
  - `input` union, required: Параметры генерации (структура зависит от модели)
    - Veo3InputDto
      - `prompt` string, required: Подсказка пользователя
      - `aspectRatio` '16:9' | '9:16': Соотношение сторон
      - `urls` string[]: URL изображений для генерации видео
      - `resolution` '720p' | '1080p' | '4k': Качество разрешения видео
      - `generationType` 'frame' | 'reference': Тип генерации для модели VEO3
    - Veo3LiteInputDto
      - `prompt` string, required: Подсказка пользователя
      - `aspectRatio` '16:9' | '9:16': Соотношение сторон
      - `resolution` '720p' | '1080p' | '4k': Качество разрешения видео
    - NanoBananaInputDto
      - `prompt` string, required: Подсказка пользователя
      - `urls` string[]: Ссылки на изображения для генерации или редактирования изображений
      - `size` '1:1' | '2:3' | '3:2' | '3:4' | '4:3' | '4:5' | '5:4' | '9:16' | '16:9' | '21:9' | '1:4' | '1:8' | '4:1' | '8:1': Соотношение размеров выходного изображения
      - `resolution` '512px' | '1K' | '2K' | '4K': Разрешение выходного изображения
    - NanoBanana21InputDto
      - `prompt` string, required: Подсказка пользователя
      - `urls` string[]: Ссылки на изображения для генерации или редактирования изображений
      - `size` '1:1' | '2:3' | '3:2' | '3:4' | '4:3' | '4:5' | '5:4' | '9:16' | '16:9' | '21:9' | '1:4' | '1:8' | '4:1' | '8:1': Соотношение размеров выходного изображения
      - `resolution` '1K' | '2K' | '4K': Разрешение выходного изображения
    - GrokImagineInputDto
      - `prompt` string, required: Описание видеоконтента
      - `size` '16:9' | '9:16' | '1:1' | '3:2' | '2:3': Соотношение сторон / размер видео
      - `duration` 6 | 10 | 15 | 20 | 25 | 30: Длительность видео в секундах
      - `resolution` '480p' | '720p': Разрешение видео
      - `urls` string[]: Ссылки на изображения для режима «изображение-видео»
    - GrokImagineImageInputDto
      - `prompt` string, required: Текстовое описание для генерации изображения
      - `size` '1:1' | '16:9' | '9:16' | '3:2' | '2:3': Соотношение сторон изображения
      - `urls` string[]: Ссылки на изображения для режима «изображение-изображение»
    - GrokImagine2ImageInputDto
      - `prompt` string, required: Текстовое описание для генерации изображения
      - `size` '1:1' | '2:3' | '3:2' | '3:4' | '4:3' | '9:16' | '16:9': Соотношение сторон изображения
    - Flux3ImageInputDto
      - `prompt` string, required: Описание изображения или инструкции по редактированию. Указания по расположению и ограничивающим рамкам можно включить в промпт.
      - `urls` string[]: URL референсов для редактирования или генерации по нескольким изображениям (до 10). Для генерации по тексту не передавайте.
      - `size` 'auto' | '21:9' | '2:1' | '16:9' | '3:2' | '7:5' | '4:3' | '5:4' | '1:1' | '4:5' | '3:4' | '5:7' | '2:3' | '9:16' | '1:2' | '9:21': Соотношение сторон. Auto следует первому референсу либо выбирает пропорции по промпту при генерации по тексту.
      - `resolution` '768SQ' | '1K' | '1.5K' | '2K' | '4K': Разрешение результата; определяет цену одного изображения.
      - `grounding` boolean: Разрешить поиск в интернете и поиск изображений перед генерацией. Референсы и поиск не оплачиваются отдельно.
    - SeedanceInputDto
      - `prompt` string: Описание видеоконтента. Обязательно, если не предоставлены изображения или видеоматериалы для справки (максимум 4000 символов).
      - `duration` number: Продолжительность видео в секундах (4-15)
      - `size` 'adaptive' | '16:9' | '9:16' | '1:1' | '4:3' | '3:4' | '21:9': Соотношение сторон видео. adaptive следует входному изображению или видео.
      - `resolution` '480p' | '720p' | '1080p' | '4k': Выходное разрешение и тариф за секунду
      - `seed` number: Случайное значение для контроля случайности
      - `generateAudio` boolean: Генерировать ли аудио
      - `imageUrls` string[]: Public image URLs for image-to-video (maximum 9). Very narrow or wide images may be padded to a width-to-height ratio of 0.4–2.5 without cropping. In first-frame mode, padding becomes part of the frame.
      - `imageWithRoles` SeedanceImageWithRole[]: Изображения с явными ролями first_frame / last_frame. Не может комбинироваться с другими полями reference-media.
        - `url` string, required: URL изображения
        - `role` 'first_frame' | 'last_frame', required: Роль изображения: first_frame или last_frame
      - `videoUrls` string[]: Публичные URL для видео-референсов (максимум 3; общая длительность должна быть больше 1.8 с и меньше 15.2 с). Их длительность проверяется перед оплатой.
      - `audioUrls` string[]: Публичные URL для аудио-референсов (максимум 3; общая длительность 15 секунд). Требует imageUrls или videoUrls.
      - `tools` SeedanceToolDto[]: Необязательные улучшения, такие как привязка к веб-поиску
        - `type` 'web_search', required: Инструмент улучшения генерации
    - Seedance25InputDto
      - `prompt` string, required: Видеоподсказка. Позиционированные в подсказке изображения, видео и аудио-референсы.
      - `duration` number: Продолжительность вывода в секундах (4-30). Для задач с видео-референсом входные и выходные секунды используют тариф референс-ввода.
      - `size` 'adaptive' | '16:9' | '4:3' | '1:1' | '3:4' | '9:16' | '21:9': Соотношение сторон вывода. Задания по первому/последнему кадру и расширению требуют адаптивного режима.
      - `resolution` '480p' | '720p' | '1080p': Выходное разрешение и тариф за секунду
      - `generateAudio` boolean: Будет ли сгенерированное видео с аудио
      - `seed` number: Случайное значение; идентичный вывод не гарантирован
      - `outputFormat` 'mp4' | 'mov': Контейнер выходного видео
      - `omniReferenceTaskType` 'auto' | 'reference' | 'extend': Необязательная подсказка типа задачи. Редактирование недоступно до поддержки расчетов по переменной продолжительности.
      - `imageUrls` string[]: Reference image URLs (maximum 30 across both image fields). Very narrow or wide images may be padded to a width-to-height ratio of 0.4–2.5 without cropping. In first-frame mode, padding becomes part of the frame.
      - `imageWithRoles` Seedance25ImageWithRoleDto[]: Изображения с явными ролями first_frame, last_frame или reference_image
        - `url` string, required: Публичный URL изображения
        - `role` 'first_frame' | 'last_frame' | 'reference_image', required: Роль кадра или референса, присвоенная этому изображению
      - `videoUrls` string[]: Публичные URL-адреса видео для справки (максимум 10; по 2–30 секунд каждый и 30 секунд всего). Их продолжительность проверяется перед оплатой.
      - `audioUrls` string[]: URL-адреса аудио для справки (максимум 10; всего 30 секунд)
      - `tools` Seedance25ToolDto[]: Необязательные улучшения, такие как привязка к веб-поиску
        - `type` 'web_search', required: Инструмент улучшения генерации
    - Seedance25SpicyInputDto
      - `prompt` string, required: Видеоподсказка. Позиционированные в подсказке изображения, видео и аудио-референсы.
      - `duration` number: Продолжительность вывода в секундах (4-30). Для задач с видео-референсом входные и выходные секунды используют тариф референс-ввода.
      - `size` 'adaptive' | '16:9' | '4:3' | '1:1' | '3:4' | '9:16' | '21:9': Соотношение сторон результата. Анимация первого кадра и продолжение видео требуют adaptive.
      - `resolution` '480p' | '720p' | '1080p': Выходное разрешение и тариф за секунду
      - `generateAudio` boolean: Будет ли сгенерированное видео с аудио
      - `omniReferenceTaskType` 'auto' | 'reference' | 'extend': auto выбирает режим по переданным медиа; reference использует все референсы; extend продолжает исходное видео и требует videoUrls. Редактирование видео недоступно.
      - `imageUrls` string[]: Reference image URLs (maximum 30). One image without other media animates the first frame; use reference mode to treat it as a style reference. Images outside a width-to-height ratio of 0.4–2.5 are padded without cropping when preparation succeeds. In first-frame mode, padding becomes part of the frame.
      - `videoUrls` string[]: Публичные URL-адреса видео для справки (максимум 10; по 2–30 секунд каждый и 30 секунд всего). Их продолжительность проверяется перед оплатой.
      - `audioUrls` string[]: URL аудиореференсов (до 10; до 30 секунд суммарно). Требуется хотя бы одно изображение или видео.
      - `tools` Seedance25ToolDto[]: Необязательные улучшения, такие как привязка к веб-поиску
        - `type` 'web_search', required: Инструмент улучшения генерации
    - Seedance15ProInputDto
      - `prompt` string: Описание видеоконтента. Обязательно для преобразования текста в видео; необязательно при предоставлении изображения (максимум 4000 символов).
      - `duration` 4 | 8 | 12: Длительность видео в секундах
      - `size` '16:9' | '9:16' | '1:1' | '4:3' | '3:4' | '21:9': Соотношение сторон видео
      - `resolution` '480p' | '720p' | '1080p': Разрешение видео
      - `seed` number: Случайное значение для контроля случайности
      - `generateAudio` boolean: Генерировать ли аудио
      - `imageUrls` string[]: Публичные URL изображений для создания видео из изображений (максимум 9)
      - `imageWithRoles` SeedanceImageWithRole[]: Изображения с явными ролями first_frame / last_frame. Не может комбинироваться с другими полями reference-media.
        - `url` string, required: URL изображения
        - `role` 'first_frame' | 'last_frame', required: Роль изображения: first_frame или last_frame
      - `cameraFixed` boolean: Фиксировать ли положение камеры
    - GptImageInputDto
      - `prompt` string, required: Подсказка пользователя
      - `urls` string[]: URL-адреса изображений для справки (URL-адреса или данные base64) для режима изображения в изображение
      - `size` 'auto' | '1:1' | '16:9' | '9:16' | '4:3' | '3:4' | '3:2' | '2:3' | '5:4' | '4:5' | '2:1' | '1:2' | '3:1' | '1:3' | '21:9' | '9:21': Соотношение сторон выходного изображения. Для моделей GPT Image 2.5 соотношения 1:3 и 3:1 требуют разрешения 2k или 4k.
      - `resolution` '1k' | '2k' | '4k': Разрешение выходного изображения
    - KlingMotionControlInputDto
      - `prompt` string: Необязательный текст сцены
      - `imageUrls` string[], required: Reference image URL (exactly one). JPG/JPEG/PNG, max 10MB. An image whose longer side exceeds 3850px is downscaled automatically
      - `videoUrls` string[], required: URL видео-эталона (только одно). MP4/MOV, максимум 100 МБ
      - `characterOrientation` 'image' | 'video', required: Режим ориентации персонажа. Определяет, чья ориентация задаёт трансфер движения
      - `resolution` '720p' | '1080p': Выходное разрешение
    - Kling3InputDto
      - `prompt` string, required: Описание видеоконтента
      - `resolution` '720p' | '1080p' | '4k': Уровень разрешения видео (влияет на цену)
      - `duration` number: Video duration in seconds (3-15). Billed per second
      - `aspectRatio` '16:9' | '9:16' | '1:1': Video aspect ratio. Ignored in image-to-video mode — the ratio is taken from the input frame
      - `generateAudio` boolean: Whether to generate a native audio track (increases pricing on 720p and 1080p)
      - `imageUrls` string[]: Input frames for image-to-video. One URL is used as the first frame, two as first + last frame
    - Kling4InputDto
      - `prompt` string: Describe the scene. Use @Image1 / @Element1 for references. Required unless multiShots is supplied; mutually exclusive with multiShots.
      - `videoMode` 'elements' | 'start_end_frame' | 'transform' | 'video_reference': Omit for pure text-to-video. Use elements for references, start_end_frame for keyframes, transform or video_reference for a source video.
      - `resolution` '720p' | '1080p': Output resolution (4K is not available)
      - `duration` number: Output seconds, 3–30. Ignored with source video (its probed duration is billed) or multiShots (shot durations are summed).
      - `aspectRatio` 'auto' | '16:9' | '9:16' | '1:1' | '21:9': Aspect ratio; must be auto with a source video. Keyframes determine their own ratio.
      - `generateAudio` boolean: Generate native stereo audio (included in the price)
      - `keepAudio` boolean: Preserve source video audio
      - `imageUrls` string[]: Raw references (up to 10); address as @Image1, @Image2. Requires elements, transform or video_reference mode.
      - `startImageIndex` number: 1-based imageUrls index anchoring the first frame (elements mode)
      - `elements` Kling4ElementDto[]: Subject elements: { description?: string, type?: image | video, imageUrls?: string[1..4], videoUrl?: string }. Up to 7, at most 3 video elements. Images and elements together: at most 15, or 14 with source video.
        - `description` string: Subject description (up to 100 characters)
        - `type` 'image' | 'video': Element media type
        - `imageUrls` string[]: Image element references (1–4 URLs)
        - `videoUrl` string: Video element source URL
      - `startFrameUrl` string: Required first frame in start_end_frame mode
      - `keyframeUrls` string[]: Ordered middle frames (up to 8) in start_end_frame mode; at most 10 total frames
      - `endFrameUrl` string: Optional last frame in start_end_frame mode
      - `videoUrl` string: Source video for transform / video_reference. Duration is probed before charging; 3–10 seconds for transform, 3–30 for video_reference. Transform needs a short side of at least 700px.
      - `multiShots` Kling4ShotDto[]: 2–6 scenes totalling 3–30 seconds; replaces prompt and duration. Only text-to-video and elements modes.
        - `prompt` string, required: Scene description
        - `duration` number, required: Scene duration in seconds; all shots must total 3–30 seconds
    - PixverseInputDto
      - `prompt` string, required: Описание видеоконтента
      - `resolution` '360p' | '540p' | '720p' | '1080p': Уровень разрешения видео (влияет на цену)
      - `duration` number: Продолжительность видео в секундах (1-15). Режим перехода поддерживает только 5 или 8 секунд
      - `size` '16:9' | '4:3' | '1:1' | '3:4' | '9:16' | '2:3' | '3:2' | '21:9': Соотношение сторон видео. Эффективно только в режимах текст-видео и мультиэталонного слияния
      - `seed` number: Случайное зерно
      - `negativePrompt` string: Негативный запрос для исключения нежелательного контента
      - `audio` boolean: Генерировать аудиодорожку (увеличивает стоимость)
      - `motionMode` 'normal': Режим движения. pixverse-v6 поддерживает только "normal"
      - `generateMultiClipSwitch` boolean: Генерировать мультиклиповое непрерывное видео. Поддерживается только в режимах текст-видео и изображение-видео
      - `imageUrls` string[]: Массив URL изображений для режима изображение-видео (используется только первое изображение)
      - `firstFrameImage` string: URL изображения первого кадра для режима перехода. Должен предоставляться вместе с lastFrameImage
      - `lastFrameImage` string: URL изображения последнего кадра для режима перехода. Должен предоставляться вместе с firstFrameImage
      - `imgReferences` string[]: URL-адреса эталонных изображений для режима многоссылочной фузии (1–7 изображений)
      - `extendFromTaskId` string: ID исходной задачи для режима расширения видео
    - SeedreamInputDto
      - `prompt` string, required: Текстовое описание для генерации изображения
      - `urls` string[]: URL-адреса изображений для справки (URL-адреса или данные base64) для режима изображения в изображение
      - `size` '1:1' | '4:3' | '3:4' | '16:9' | '9:16' | '3:2' | '2:3' | '21:9' | '9:21' | 'auto': Соотношение сторон изображения
      - `resolution` '1K' | '1.5K' | '2K' | '3K' | '4K': Разрешение изображения
      - `outputFormat` 'jpeg' | 'png': Output image format (Seedream 5.0 Lite / Pro / Flash only; ignored by other models)
      - `promptOptimizeMode` 'standard' | 'fast': Режим оптимизации подсказки (только seedream-4-5; для других моделей игнорируется)
    - Seedream50FlashInputDto
      - `prompt` string, required: Текстовое описание для создания или редактирования изображения (до 5000 символов)
      - `urls` string[]: До 10 URL изображений для редактирования
      - `size` '1:1' | '4:3' | '3:4' | '16:9' | '9:16' | '3:2' | '2:3' | '21:9': Соотношение сторон изображения
      - `resolution` '1K' | '1.5K' | '2K': Разрешение изображения
      - `outputFormat` 'jpeg' | 'png': Формат выходного изображения
    - Wan27VideoInputDto
      - `prompt` string: Текстовая подсказка. Обязательна для text-to-video, reference-to-video и edit-video; необязательна для image-to-video.
      - `imageUrls` string[]: Кадры из изображения в видео. Первый URL — это начальный кадр, второй необязательный URL — конечный кадр. Указание этого выбирает рабочий процесс «изображение в видео».
      - `referenceImageUrls` string[]: Справочные изображения для рабочего процесса «ссылка на видео». Требуется запрос.
      - `referenceVideoUrls` string[]: Справочные видео для рабочего процесса «ссылка на видео». Требуется запрос.
      - `editVideoUrl` string: Исходное видео для редактирования. Указание этого выбирает рабочий процесс редактирования видео (требуется запрос).
      - `referenceImageUrl` string: Необязательное справочное изображение для управления рабочим процессом редактирования видео.
      - `continueVideoUrl` string: Исходное видео для продолжения или расширения. Выбирает рабочий процесс продолжения видео. Не может сочетаться с imageUrls или audioUrl. Поддерживаемая длительность — 2-10 секунд.
      - `audioUrl` string: Необязательный URL аудио (процессы text-to-video и image-to-video).
      - `size` '16:9' | '9:16' | '1:1' | '4:3' | '3:4': Соотношение сторон (text-to-video, reference-to-video и edit-video). Игнорируется для image-to-video, где оно определяется исходными кадрами.
      - `resolution` '720p' | '1080p': Выходное разрешение
      - `duration` number: Продолжительность видео в секундах (2-15). Допустимые значения зависят от выбранного процесса: text-to-video принимает 5/10/15, image-to-video 2-15, reference-to-video 2-10, edit-video 0 или 2-10 (0 позволяет PoYo определить продолжительность исходного видео).
      - `multiShots` boolean: Включить генерацию нескольких кадров (процессы image, reference и edit).
      - `audioSetting` string: Настройка аудио для процесса edit-video.
      - `seed` number: Случайное значение для контроля случайности
      - `enableSafetyChecker` boolean: Включить проверку безопасности модели
    - Wan30VideoInputDto
      - `prompt` string: Текстовое описание. Обязательно, если не предоставлен хотя бы один медиа-ввод. В режиме ссылок вы можете адресовать ресурсы позиционно с метками "图N / 视频N / 音频N"; индексы идут по типу медиа.
      - `imageUrls` string[]: URL-адреса изображений без явных ролей. В семействе кадров первый элемент — начальный кадр, а второй (опционально) — конечный кадр; в семействе ссылок каждый элемент является ссылочным изображением (до 10).
      - `imageWithRoles` Wan30ImageWithRoleDto[]: Изображения с явными ролями. Используйте это, когда вам нужны первый/последний кадр или эталонные изображения, указанные явно, а не выводимые из порядка.
        - `url` string, required: Адрес изображения (публичный URL или data:image/...;base64,...)
        - `role` 'first_frame' | 'last_frame' | 'reference_image': Роль изображения. first_frame/last_frame относятся к семейству кадров, reference_image — к семейству ссылок; их нельзя смешивать.
      - `videoUrls` string[]: Справочные видео, до 5 клипов по 1-15 секунд каждый (всего <= 15 секунд). Продолжительность исходного видео плюс запрашиваемая продолжительность результата должны оставаться в пределах 30 секунд.
      - `audioUrls` string[]: Справочная аудиозапись, до 5 клипов по 1-15 секунд каждый (всего <= 15 секунд).
      - `fileUrl` string: Справочный документ, задающий генерацию (docx/xlsx/pptx/pdf/txt/md и подобные, <=100 МБ, <=50 страниц). Не может использоваться вместе с linkUrl. При его наличии использование подсказки необязательно.
      - `linkUrl` string: Публичная веб-страница без входа в систему для превращения в видео. Не может использоваться вместе с fileUrl.
      - `generationType` 'frame' | 'reference': Как классифицируются чистые imageUrls: кадр (первый/последний кадр) или ссылка. Можно пропустить, чтобы это было определено автоматически — ссылка, если запрос уже содержит входные данные семейства ссылок, кадр в противном случае.
      - `size` 'adaptive' | '16:9' | '4:3' | '1:1' | '3:4' | '9:16': Соотношение сторон. `adaptive` позволяет модели выбрать одно из входных значений.
      - `resolution` '480p' | '720p' | '1080p': Разрешение вывода. Каждый уровень тарифицируется по собственной ставки за секунду, поэтому 1080p стоит в четыре раза дороже 480p за ту же продолжительность.
      - `duration` number: Продолжительность в секундах (2-30). Оплата производится за секунду по тарифу выбранного разрешения. С опорными видео общая продолжительность входного видео плюс это значение не должна превышать 30 секунд.
      - `audio` boolean: Включить аудиодорожку в вывод.
      - `seed` number: Случайное значение для контроля случайности
    - Wan30VideoProInputDto
      - `prompt` string: Текстовое описание. Обязательно, если не предоставлен хотя бы один медиа-ввод. В режиме ссылок вы можете адресовать ресурсы позиционно с метками "图N / 视频N / 音频N"; индексы идут по типу медиа.
      - `imageUrls` string[]: URL-адреса изображений без явных ролей. В семействе кадров первый элемент — начальный кадр, а второй (опционально) — конечный кадр; в семействе ссылок каждый элемент является ссылочным изображением (до 10).
      - `imageWithRoles` Wan30ImageWithRoleDto[]: Изображения с явными ролями. Используйте это, когда вам нужны первый/последний кадр или эталонные изображения, указанные явно, а не выводимые из порядка.
        - `url` string, required: Адрес изображения (публичный URL или data:image/...;base64,...)
        - `role` 'first_frame' | 'last_frame' | 'reference_image': Роль изображения. first_frame/last_frame относятся к семейству кадров, reference_image — к семейству ссылок; их нельзя смешивать.
      - `videoUrls` string[]: Справочные видео, до 5 клипов по 1-15 секунд каждый (всего <= 15 секунд). Продолжительность исходного видео плюс запрашиваемая продолжительность результата должны оставаться в пределах 30 секунд.
      - `audioUrls` string[]: Справочная аудиозапись, до 5 клипов по 1-15 секунд каждый (всего <= 15 секунд).
      - `fileUrl` string: Справочный документ, задающий генерацию (docx/xlsx/pptx/pdf/txt/md и подобные, <=100 МБ, <=50 страниц). Не может использоваться вместе с linkUrl. При его наличии использование подсказки необязательно.
      - `linkUrl` string: Публичная веб-страница без входа в систему для превращения в видео. Не может использоваться вместе с fileUrl.
      - `generationType` 'frame' | 'reference': Как классифицируются чистые imageUrls: кадр (первый/последний кадр) или ссылка. Можно пропустить, чтобы это было определено автоматически — ссылка, если запрос уже содержит входные данные семейства ссылок, кадр в противном случае.
      - `size` 'adaptive' | '16:9' | '4:3' | '1:1' | '3:4' | '9:16': Соотношение сторон. `adaptive` позволяет модели выбрать одно из входных значений.
      - `duration` number: Продолжительность в секундах (2-30). Оплата производится за секунду по тарифу выбранного разрешения. С опорными видео общая продолжительность входного видео плюс это значение не должна превышать 30 секунд.
      - `audio` boolean: Включить аудиодорожку в вывод.
      - `resolution` '480p' | '720p' | '1080p' | '2K' | '4K': Output resolution. Billing is per second, including reference video seconds.
      - `promptExtend` boolean: Let the model expand the prompt. Set false to keep the literal prompt.
    - Flux3VideoInputDto
      - `prompt` string, required: Scene description: subject, action, camera movement, dialogue and sound
      - `resolution` '720p' | '1080p': Video resolution (affects pricing). Draft mode supports 720p only
      - `duration` number: Video duration in seconds (5-20). Billed per second
      - `aspectRatio` 'auto' | '21:9' | '2:1' | '16:9' | '4:3' | '1:1' | '3:4' | '9:16': Video aspect ratio. `auto` lets the model choose from the prompt and input frames
      - `imageUrls` string[]: Keyframes for image-to-video, in playback order. One image is the start frame, two are start + end, three or more are spread evenly across the clip
      - `videoUrl` string: Source video (mp4) to continue. Continuation is billed at a higher per-second rate and cannot be combined with imageUrls
      - `draft` boolean: Draft mode: a fast, low-quality 720p preview at about a third of the price
      - `safetyTolerance` number: Moderation tolerance from 0 (strictest) to 4 (most permissive)
    - GeminiOmni11InputDto
      - `prompt` string, required: Describe the scene, motion and sound.
      - `imageUrls` string[]: First frame and optional last frame. Cannot be combined with reference inputs.
      - `referenceImageUrls` string[]: Reference images (up to 7; up to 5 with a reference video). Cannot be combined with imageUrls.
      - `referenceVideoUrls` string[]: One source video, 3–10 seconds. Output follows source duration and is billed per generation. Cannot be combined with imageUrls.
      - `aspectRatio` '16:9' | '9:16': Output aspect ratio
      - `duration` 4 | 6 | 8 | 10: Output duration. Ignored with a source video, which uses a flat per-generation price.
      - `resolution` '360p' | '720p' | '1080p' | '4k': Output resolution; 1080p and 4K are upscaled outputs.
    - MinimaxH3InputDto
      - `prompt` string, required: Describe the scene, motion and audio. Refer to supplied images and audio in the prompt.
      - `aspectRatio` '16:9' | '9:16': Соотношение сторон видео
      - `imageUrls` string[]: Reference image URLs (up to 9). The first 5 are free; each additional image is billed separately per request.
      - `audioUrls` string[]: Reference audio URLs (up to 3), free of additional charge.
      - `resolution` '480p' | '768p' | '1080p': Output resolution; 1080p supports at most 10 seconds.
      - `duration` number: Output duration in seconds (1–15; at most 10 at 1080p).
      - `seed` number: Случайное зерно
    - AgnesVideoInputDto
      - `prompt` string, required: Describe the scene, motion and audio. Refer to supplied images and audio in the prompt.
      - `aspectRatio` '16:9' | '9:16' | '21:9' | '4:3' | '1:1' | '3:4': Соотношение сторон видео
      - `imageUrls` string[]: Reference image URLs (up to 9). Included in the per-second price.
      - `audioUrls` string[]: Reference audio URLs (up to 3), free of additional charge.
      - `resolution` '720p' | '1080p' | '2k': Output video resolution.
      - `duration` number: Output duration in seconds (1–12).
      - `seed` number: Случайное зерно
    - ZImageInputDto
      - `prompt` string, required: Текстовое описание для генерации изображения
      - `urls` string[]: Дополнительное справочное изображение для редактирования (ровно один URL). Предоставление его переключает запрос на редактирование изображения.
      - `size` '1:1' | '4:3' | '3:4' | '16:9' | '9:16': Соотношение сторон изображения. Обязательно для текста в изображение; необязательно для редактирования изображения (по умолчанию следует за справочным изображением).
      - `enableSafetyChecker` boolean: Включить средство проверки безопасности модели (по умолчанию включено)
    - Wan27ImageInputDto
      - `prompt` string, required: Текстовое описание для генерации изображения
      - `urls` string[]: Справочные изображения для редактирования (1-4 URL). Их предоставление переключает запрос в режим редактирования. Порядок важен: ссылайтесь на них как на изображение 1, изображение 2 и т.д. в запросе.
      - `size` '1:1' | '16:9' | '9:16' | '4:3' | '3:4' | '3:2' | '2:3': Соотношение сторон выходного изображения (игнорируется, если указаны ширина и высота)
      - `width` number: Пользовательская ширина выхода в пикселях (требуется высота). Перекрывает размер.
      - `height` number: Пользовательская высота вывода в пикселях (требует ширину). Перекрывает размер.
      - `seed` number: Случайное семя для воспроизводимого результата
    - MidjourneyInputDto
      - `action` 'imagine' | 'edits' | 'blend' | 'describe' | 'upscale' | 'variation' | 'high-variation' | 'low-variation' | 'reroll' | 'zoom' | 'pan' | 'inpaint' | 'modal' | 'remix-strong' | 'remix-subtle': Действие / эндпоинт Midjourney. По умолчанию 'imagine' (текст в изображение). Последующие действия ссылаются на предыдущую генерацию через 'parentTaskId'.
      - `prompt` string: Подсказка; обязательна для imagine/edits. Разрешены встроенные флаги MJ (например, '--ar 16:9 --v 6.1'). Структурные поля тела переопределяют флаги подсказки.
      - `imageUrls` string[]: URL изображений или данные URIs в base64. Используется как: направляющее изображение (imagine), источник (редактирование), набор для смешивания (2–4), описание (1).
      - `parentTaskId` string: ID генерации родителя (предыдущее генерация 'midjourney' в нашей системе) для последующих действий (масштабирование/вариация/перезапуск/увеличение/панорамирование/инпэйнт/модальный режим/ремикс). На его основе определяется ID исходной задачи.
      - `index` number: Индекс плитки (1–4) для масштабирования/вариации/увеличения/панорамирования/инпэйнт/ремикс, когда 'customId' не предоставлен.
      - `customId` string: Исходный ID кнопки MJ для действия; если установлен, соответствие по 'index'/'direction' пропускается.
      - `speed` 'relax' | 'fast' | 'turbo': Режим скорости. 'relax' (по умолчанию) не добавляет суффикс к оплате.
      - `direction` 'left' | 'right' | 'up' | 'down': Направление панорамирования (action=pan).
      - `zoomRatio` number: Коэффициент увеличения (action=zoom). < 2 → уменьшение масштаба 1.5x; пропущено или >= 2 → 2x.
      - `maskUrl` string: URL изображения маски или base64 (action=modal). Белый = перерисовать, прозрачный = оставить.
      - `dimensions` 'SQUARE' | 'PORTRAIT' | 'LANDSCAPE': Предустановка соотношения для смешивания (action=blend); переопределяется параметром 'size'.
      - `size` string: Соотношение сторон 'w:h' (--ar), например, '16:9', '1:1', '21:9'.
      - `quality` '0.25' | '0.5' | '1' | '2': Качество (--q).
      - `style` string: Стиль (--style), например, 'raw'.
      - `version` '8.1' | '7' | '6.1' | '5.2' | '5.1': Основная версия MJ (--v). С 'niji: true' и '7'/'6' нормализуется до Niji.
      - `seed` number: Семя (--seed).
      - `negativePrompt` string: Негативный промпт (--no), например, 'уродливый, размытый'.
      - `stylize` number: Стилизация (--s), 0–1000.
      - `chaos` number: Хаос (--c), 0–100.
      - `weird` number: Странность (--w), 0–3000.
      - `tile` boolean: Режим плитки (--tile).
      - `niji` boolean: Переключатель Niji (--niji). Использовать с версией 7/6.
      - `iw` number: Вес изображения (--iw), 0–3.
      - `cw` number: Вес персонажа (--cw), 0–100.
      - `sw` number: Вес стиля (--sw), 0–1000.
      - `cref` string: URL ссылки на персонажа (--cref).
      - `sref` string: URL ссылки на стиль (--sref).
      - `dref` string: URL ссылки на глубину (--dref).
      - `dw` number: Вес глубины (--dw), 0–100.
      - `repeat` number: Повтор (--repeat), 2–40.
      - `raw` boolean: Сырой стиль (--raw), v5.1+.
      - `draft` boolean: Режим черновика (--draft), v7+.
      - `hd` boolean: HD режим (--hd), только v8/v8.1.
      - `stop` number: Раннее завершение (--stop), 10–100; только v5–6.1 / niji 5–6.
      - `extra` string: Эвакуационный шлюз добавляется к подсказке дословно (любое '--xxx').
    - MidjourneyVideoInputDto
      - `prompt` string: Видео подсказка; необязательно при повторном использовании основной задачи.
      - `imageUrls` string[]: Изображение первого кадра (1 изображение, URL или base64). Один из imageUrls / parentTaskId.
      - `parentTaskId` string: Идентификатор родительской генерации (успешная генерация изображения 'midjourney'), который будет использован как источник. Один из imageUrls / parentTaskId.
      - `index` number: Какой тайл на сетке родительского изображения является первым кадром (0–3).
      - `videoType` 'vid_1.1_i2v_480' | 'vid_1.1_i2v_720' | 'vid_1.1_i2v_start_end_480' | 'vid_1.1_i2v_start_end_720': Разрешение / уровень режима. Уровни 720 оплачиваются по тарифу 720p.
      - `animateMode` 'manual' | 'auto': Режим анимации. 'auto' требует parentTaskId + индекс.
      - `motion` 'low' | 'high': Сила движения. Не влияет на оплату.
      - `batchSize` 1 | 2 | 4: Размер партии (1 / 2 / 4). Оплата × N.
      - `endUrl` string: Конечный кадр; при установке videoType автоматически повышается до стартового/конечного уровня.
    - SunoInputDto
      - `action` 'music' | 'extend' | 'cover' | 'add-instrumental' | 'add-vocals' | 'sound' | 'stems' | 'stems-all' | 'wav' | 'lyrics' | 'voice' | 'timestamped-lyrics' | 'boost-style' | 'music-cover' | 'replace-section' | 'music-video' | 'inspo' | 'upload' | 'remaster' | 'add-stem' | 'vox' | 'remove-section' | 'crop' | 'fade-in' | 'fade-out' | 'adjust-speed' | 'concat' | 'mashup' | 'sample' | 'midi' | 'bpm' | 'custom-model': Операция Suno
      - `mv` string: Engine version. Audio actions: v6 (default) | v6-wild | v6-mini | custom. The retired versions v3.5 … v5.5 are still accepted and run on v6. lyrics: remi-v1 | default. Not used by stems/stems-all/wav/voice. variety, maxMode, audioFormat, duration and customModelId need a V6 engine (any value except custom).
      - `custom` boolean: false для простого режима, true для пользовательского режима
      - `gptDescriptionPrompt` string: Простой режим: описание песни / эффекта (с необязательными текстами)
      - `prompt` string: Пользовательский режим: подробные тексты / запрос (также тексты или описание звука)
      - `tags` string: Пользовательский режим: жанровые / стилевые теги
      - `title` string: Название для результата
      - `makeInstrumental` boolean: Создать трек только с инструменталом
      - `negativeTags` string: Стили, которых следует избегать (пользовательский режим / звук)
      - `personaId` string: ID пользовательского голоса (персоны) для исполнения сгенерированной музыки
      - `customModel` SunoCustomModelDto
        - `name` string, required: Название пользовательской модели
        - `audioUrls` string[], required: Аудио URL для обучения (6–24)
      - `customModelId` string: Id of a reusable custom model created by the `custom-model` action (its `output.customModelId`). Generates in that model's style; cannot be combined with mv or personaId.
      - `variety` 'off' | 'normal' | 'high' | 'extra' | 'max': Style variation: off | normal | high | extra | max. V6 generative actions.
      - `maxMode` boolean: Max mode: higher-quality V6 generation, billed at twice the regular price. Requires custom mode, except on inspo and replace-section.
      - `audioFormat` 'mp3' | 'm4a' | 'wav': Output audio format: mp3 | m4a | wav. V6 generative actions plus sound, remaster, stems and stems-all.
      - `duration` number: music / extend / cover: target length in seconds (10–360), custom mode only. The actual length is decided by the model.
      - `audioUrl` string: URL аудиофайла для обработки
      - `continueAt` number: extend: time in seconds where the extension should begin (at least 1 for a sourceTaskId or audioUrl source)
      - `sourceTaskId` string: Ссылка на одну из ваших предыдущих генераций Suno (ее taskId), используемая для действий с сохранением состояния, таких как extend, music-cover, replace-section, timestamped-lyrics, music-video, voice и wav.
      - `audioId` string: Трек для обработки, идентифицируемый по его id (как возвращается в `output.tracks[].audioId` предыдущей генерации). Обычно генерация производит 2 трека; пропустите, чтобы использовать первый.
      - `fullLyrics` string: replace-section: полные тексты песен для всего трека после редактирования
      - `author` string: музыкальное видео: имя артиста / создателя на обложке (макс. 50)
      - `domainName` string: музыкальное видео: водяной знак бренда / сайта внизу (макс. 50)
      - `aspectRatio` '9:16' | '16:9' | '1:1' | '3:4' | '4:3': музыкальное видео: соотношение сторон на выходе
      - `backgroundColors` string[]: музыкальное видео: 1–4 шестнадцатеричных цвета для размытого градиентного фона (например, ["#1B2635", "#8A6A4F"])
      - `imageUrl` string: музыкальное видео: URL обложки для отображения внутри кольца (по умолчанию: обложка исходного трека, если доступна)
      - `quality` 'compact' | 'high' | 'max': музыкальное видео: качество выходного файла. `compact` — небольшой файл, удобный для обмена (~5 МБ / 3 мин); `high` — более четкий выход 720p-класса примерно вдвое больше по размеру; `max` — 1080p-класс, примерно в 4 раза компактнее
      - `startS` number: Начальное время (секунды) затронутого диапазона. Используется функциями remove-section / crop / sample (диапазон), replace-section (диапазон для заполнения) и vox / voice-from-track (вокальное окно).
      - `endS` number: Конечное время (секунды) затронутого диапазона (> startS). См. startS для действий, которые его используют.
      - `bpm` number: звук: темп в BPM
      - `key` string: звук: музыкальный ключ (Мажор C–B; Минор Cm–Bm)
      - `type` 'one-shot' | 'loop': sound: 'one-shot' или 'loop' (по умолчанию 'one-shot')
      - `voiceAudioUrl` string: голос: URL записи голоса
      - `verificationAudioUrl` string: голос: URL записи проверочной фразы
      - `phraseId` string: голос: ID фразы из эндпоинта проверочной фразы
      - `name` string: voice / custom-model: name
      - `description` string: голос: описание
      - `styles` string: голос: жанровые теги (например, 'funk edm')
      - `singerSkillLevel` 'Beginner' | 'Intermediate' | 'Advanced' | 'Professional': голос: уровень мастерства певца
      - `audioUrls` string[]: Public audio URLs. inspo: 1–4 inspiration references; custom-model: 6–24 training tracks (MP3, WAV or M4A).
      - `styleWeight` number: Вес стиля (0,00–1,00)
      - `weirdnessConstraint` number: Вес креативности / необычности (0,00–1,00)
      - `audioWeight` number: Вес аудио (0,00–1,00)
      - `vocalGender` 'Male' | 'Female': Пол вокала: мужской или женский
      - `autoLyrics` boolean: вдохновение: творчески переписать предоставленные тексты
      - `variationCategory` 'subtle' | 'normal' | 'high': ремастеринг: интенсивность (тонкий / нормальный / высокий)
      - `stemType` string: дорожки: какую дорожку извлечь (например, ведущий_вокал, бэк-вокалы, ударная_установка, бас, пианино, электрогитара). По умолчанию — ведущий_вокал.
      - `voxAudioId` string: Deprecated and ignored: a persona is now created straight from the track (voice with sourceTaskId), no vox extraction needed.
      - `durationS` number: fade-in / fade-out: длительность появления/затухания в секундах
      - `speed` number: adjust-speed: множитель скорости (0.25–4)
      - `keepPitch` boolean: adjust-speed: сохранять оригинальную высоту тона (по умолчанию true)
      - `sourceTaskIds` string[]: mashup: ровно 2 предыдущих идентификатора генерации suno (taskIds) для совместного ремикса
      - `audioIds` string[]: mashup: параллельный массив к sourceTaskIds, выбирающий трек в каждом источнике по его audioId (как возвращается в output.tracks[].audioId); пропустите запись, чтобы использовать первый трек этого источника
  - `webhook` string: Вебхук для результата

## Response `200`

Успех - запрос успешно выполнен

- CreateGenerationResponseDto
  - `code` number, required: Код состояния HTTP
  - `data` GenerationResponseData, required
    - `taskId` string, required: ID задачи генерации
    - `status` 'not_started' | 'processing' | 'finished' | 'failed' | 'expired', required: Текущий статус генерации
    - `createdAt` string, required: Время создания генерации

## Other responses

- `400`: Неверный запрос - неверные параметры
- `401`: Ошибка авторизации — API-ключ отсутствует или недействителен
- `402`: Требуется оплата - недостаточно средств на счету
- `500`: Внутренняя ошибка сервера - произошла ошибка на сервере

---

[API](https://skmtc.dev/apihubs/apis/api-hubs-api.md) · [All operations](https://skmtc.dev/apihubs/apis/api-hubs-api/llms.txt) · [OpenAPI document](https://skmtc.dev/apihubs/apis/api-hubs-api/revisions/491c66fb97dd?raw)