Suno: replace-section
Замените диапазон времени в предыдущем треке.
Факты о действии
| Свойство | Значение |
|---|---|
| Модель | suno |
| Действие | replace-section |
| Эндпоинт | 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": "replace-section",
"sourceTaskId": "019ca881-9503-7270-a560-f00fc2b15785",
"startS": 20,
"endS": 35
}
}'
{
"code": 200,
"data": {
"taskId": "019ca881-9503-7270-a560-f00fc2b15785",
"status": "not_started",
"createdAt": "2026-08-22T12:00:00.000Z"
}
}
Параметры
| Параметр | Тип | Обязательно | По умолчанию | Описание |
|---|---|---|---|---|
action | “музыка” | “extend” | “кавер” | “дополнительный инструментал” | “дополнительный вокал” | “звук” | “stems” | “стемс-все” | “wav” | “тексты” | “голос” | “тексты с временной меткой” | “boost-style” | “музыкальная кавер-версия” | “replace-section” | “музыкальное видео” | “insp” | “upload” | “remaster” | “add-stem” | “vox” | “remove-section” | “crop” | “fade-in” | “fade-out” | “adjust-speed” | “concat” | “concat” | “mashup” | “sample” | “midi” | “bpm” | Да | "music" | Операция Suno |
prompt | string | Нет | — | Пользовательский режим: подробные тексты / запрос (а также текст песни или звуковое описание) |
tags | string | Нет | — | Пользовательский режим: теги жанра / стиля |
title | string | Нет | — | Название результата |
sourceTaskId | string | Да | — | Ссылка на одну из ваших предыдущих генераций Suno (ее taskId), используемая действиями с состоянием, такими как extend, music-cover, replace-section, timestamped-lyrics, music-video, voice и wav. |
fullLyrics | string | Нет | — | replace-section: полный текст песен для всего трека после редактирования |
startS | number | Да | — | Время начала (в секундах) затронутого диапазона. Используется для remove-section / crop / sample (диапазон), replace-section (диапазон заполнения) и vox / voice-from-track (окно вокала). |
endS | number | Да | — | Время окончания (в секундах) затронутого диапазона (> startS). См. startS для действий, которые его используют. |
Условные правила: Требуются sourceTaskId, startS и endS; endS должен
быть больше, чем startS.
Отправляйте только поля, относящиеся к этому действию. Когда запрос ссылается на
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://storage.api-stock.com/result.mp3",
"fileType": "music"
}
],
"createdTime": "2026-08-22T12:00:00.000Z"
}
}