Suno: extend

Продолжить существующую дорожку.

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

Свойство	Значение
Модель	`suno`
Действие	`extend`
Эндпоинт	`POST /api/v1/generation/create`
Результат	аудио в `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": "extend",
    "sourceTaskId": "019ca881-9503-7270-a560-f00fc2b15785",
    "continueAt": 30
  }
}'


{
  "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
`mv`	string	Нет	—	Версия движка. Действия с аудио: v6 (по умолчанию) \| v6-wild \| v6-mini \| custom. Снятые с поддержки v3.5 … v5.5 по-прежнему принимаются и выполняются на v6. lyrics: remi-v1 \| default. Не используется для stems/stems-all/wav/voice. variety, maxMode, audioFormat, duration и customModelId требуют движка V6 (любое значение, кроме custom).
`custom`	boolean	Нет	—	false для простого режима, true для пользовательского режима
`gptDescriptionPrompt`	string	Нет	—	Простой режим: описание песни/эффекта (с необязательными текстами)
`prompt`	string	Нет	—	Пользовательский режим: подробные тексты / подсказка (также тексты или описание звука)
`tags`	string	Нет	—	Пользовательский режим: теги жанра/стиля
`title`	string	Нет	—	Название для результата
`negativeTags`	string	Нет	—	Стили, которых следует избегать (пользовательский режим/звук)
`personaId`	string	Нет	—	ID пользовательского голоса (персоны) для исполнения созданной музыки
`customModel`	object	Нет	—	Встроенное определение пользовательской модели (требуется при mv=custom). Структура: { name: string, audioUrls: string[6..24] }
`customModelId`	string	Нет	—	Id собственной модели, созданной действием `custom-model` (её `output.customModelId`). Генерирует в стиле этой модели; нельзя сочетать с mv или personaId.
`variety`	“off” \| “normal” \| “high” \| “extra” \| “max”	Нет	—	Вариативность стиля: off \| normal \| high \| extra \| max. Генеративные действия V6.
`maxMode`	boolean	Нет	`false`	Режим max: более качественная генерация V6 по двойной цене. Требует пользовательский режим, кроме inspo и replace-section.
`audioFormat`	“mp3” \| “m4a” \| “wav”	Нет	—	Формат выходного аудио: mp3 \| m4a \| wav. Генеративные действия V6, а также sound, remaster, stems и stems-all.
`duration`	number	Нет	—	music / extend / cover: целевая длительность в секундах (10–360), только в пользовательском режиме. Фактическую длину выбирает модель. min 10, max 360
`audioUrl`	string	Нет	—	URL аудиофайла для обработки
`continueAt`	number	Да	—	extend: время в секундах, с которого должно начаться расширение
`sourceTaskId`	string	Да	—	Ссылка на одно из ваших предыдущих генераций Suno (его taskId), используемая в действиях с сохранением состояния, таких как extend, music-cover, replace-section, timestamped-lyrics, music-video, voice и wav.
`audioId`	string	Нет	—	Трек, с которым нужно работать, идентифицируемый по его id (как возвращается в `output.tracks[].audioId` предыдущей генерации). Обычно одна генерация создает 2 трека; опустите для использования первого.

Условные правила: Требуется источник (audioId, audioUrl или sourceTaskId) и continueAt (не меньше 1 для sourceTaskId или audioUrl). Без custom продолжение идёт в пользовательском режиме, если не передан только gptDescriptionPrompt. Публичный audioUrl вместе с опциями V6 (variety, maxMode, audioFormat, duration, customModelId) всегда продолжается в пользовательском режиме.

Отправляйте только поля, относящиеся к этому действию. Когда запрос ссылается на 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.mp3",
        "fileType": "music"
      }
    ],
    "createdTime": "2026-08-22T12:00:00.000Z"
  }
}

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