Skip to Content
ДокументацияМоделиМузыкаSunovox

Suno: vox

Извлеките вокальные сегменты из предыдущего трека.

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

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

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

curl -X POST https://api.api-stock.com/api/v1/generation/create \
  -H "Authorization: Bearer $API_STOCK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "suno",
  "input": {
    "action": "vox",
    "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”Да"music"Операция Suno
sourceTaskIdstringДаСсылка на одну из ваших предыдущих генераций Suno (ее taskId), используется для действий с отслеживанием состояния, таких как extend, music-cover, replace-section, timestamped-lyrics, music-video, voice и wav.

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

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

Результат

curl https://api.api-stock.com/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"
  }
}

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

Suno: vox — API Stock