Suno: voice

Создайте многоразовый голос или персонаж.

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

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

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

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": "voice",
    "voiceAudioUrl": "https://example.com/voice.mp3"
  }
}'

{
  "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
`sourceTaskId`	string	Нет	—	Ссылка на одно из ваших предыдущих генераций Suno (его taskId), используемое для состоятельных действий, таких как extend, music cover, replace-section, timestamped-lyrics, музыкальное видео, голос и wav.
`startS`	number	Нет	—	Время запуска (секунды) затронутого диапазона. Используется для remove-section / crop / sample (диапазон), replace-section (infill-range) и vox / voice-from-track (вокальное окно).
`endS`	number	Нет	—	Время окончания (секунды) затронутого диапазона (> startS). См. startS для действий, которые его используют.
`voiceAudioUrl`	струна	Да	—	голос: URL голосовой записи
`verificationAudioUrl`	string	Нет	—	Голос: URL к записи фразы подтверждения
`phraseId`	string	Нет	—	голос: идентификатор фразы из конечной точки верификационной фразы
`name`	string	Нет	—	Голос: Имя голоса
`description`	string	Нет	—	Голос: описание
`styles`	string	Нет	—	Голос: жанровые теги (например, ‘funk edm’)
`singerSkillLevel`	«Новичок» \| «Средний» \| «Продвинутый» \| «Профессионал»	Нет	—	Голос: уровень певческого мастерства
`voxAudioId`	string	Нет	—	голос (персонаж из трека): идентификатор, полученный при предыдущем извлечении вокса; значения startS/endS должны соответствовать диапазону клипа этого вокса.

Условные правила: Требует voiceAudioUrl или sourceTaskId. Источник трека также требует name; проверка требует verificationAudioUrl, phraseId и name вместе.

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

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