Suno: music-video

Создайте визуализированный MP4 из предыдущего трека.

Факты о действии

Свойство	Значение
Модель	`suno`
Действие	`music-video`
Эндпоинт	`POST /api/v1/generation/create`
Результат	MP4 в `files`
Цены	Посмотреть актуальные цены

Минимальный запрос


curl -X POST https://api.apihubs.ru/api/v1/generation/create \
  -H "Authorization: Bearer $API_STOCK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "suno",
  "input": {
    "action": "music-video",
    "sourceTaskId": "019ca881-9503-7270-a560-f00fc2b15785"
  }
}'


{
  "code": 200,
  "data": {
    "taskId": "019ca881-9503-7270-a560-f00fc2b15785",
    "status": "not_started",
    "createdAt": "2026-08-22T12:00:00.000Z"
  }
}

Параметры

Параметр	Тип	Обязательно	По умолчанию	Описание
`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”	Да	`"music"`	Операция Suno
`sourceTaskId`	string	Да	—	Ссылка на одно из ваших предыдущих генераций Suno (его taskId), используемое для состоятельных действий, таких как extend, music cover, replace-section, timestamped lyrics, музыкальное видео, голос и wav.
`author`	string	Нет	—	Музыкальное видео: Имя исполнителя / создателя на обложке (Max 50)
`domainName`	string	Нет	—	музыкальное видео: водяной знак бренда / сайта внизу (макс. 50)
`aspectRatio`	“9:16” \| “16:9” \| “1:1” \| “3:4” \| “4:3”	Нет	`"9:16"`	музыкальное видео: выходное соотношение сторон
`backgroundColors`	string[]	Нет	—	музыкальное видео: 1–4 цвета в шестнадцатеричном формате для размытого градиентного фона (например, [“#1B2635”, “#8A6A4F”])
`imageUrl`	string	Нет	—	музыкальное видео: URL обложки для отображения внутри кольца (по умолчанию: обложка исходного трека, если доступна)
`quality`	“compact” \| “high” \| “max”	Нет	`"compact"`	музыкальное видео: качество выхода. `compact` — маленький файл, удобный для поделиться (~5 МБ / 3 мин); `high` — более четкое видео класса 720p примерно в два раза больше по размеру; `max` — видео класса 1080p, примерно в 4 раза больше, чем compact

Условные правила: Требуется sourceTaskId.

Отправляйте только поля, относящиеся к этому действию. Когда запрос ссылается на sourceTaskId, источником должна быть успешная задача Suno, принадлежащая той же учетной записи.

Результат


curl https://api.apihubs.ru/api/v1/task/status/$TASK_ID \
  -H "Authorization: Bearer $API_STOCK_KEY"

Вы можете вместо этого предоставить верхнеуровневый webhook. Задача достигает finished, failed или expired; неудачные генерации возвращаются автоматически. Действия с данными возвращают output, а действия с медиа возвращают files.


{
  "code": 200,
  "data": {
    "taskId": "019ca881-9503-7270-a560-f00fc2b15785",
    "status": "finished",
    "files": [
      {
        "fileUrl": "https://s3.apihubs.ru/result.mp4",
        "fileType": "video"
      }
    ],
    "createdTime": "2026-08-22T12:00:00.000Z"
  }
}

Назад ко всем действиям Suno