Suno: inspo

Создайте песню из одной-четырех общедоступных URL аудио.

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

Свойство	Значение
Модель	`suno`
Действие	`inspo`
Эндпоинт	`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": "inspo",
    "audioUrls": [
      "https://example.com/reference.mp3"
    ]
  }
}'

{
  "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”
`prompt`	string	Нет	—	Пользовательский режим: детализированные тексты / подсказка (также тексты или описание звука)
`tags`	string	Нет	—	Пользовательский режим: теги жанра / стиля
`title`	string	Нет	—	Название для результата
`audioUrls`	string[]	Да	—	inspo: 1–4 публичных URL аудио, используемых в качестве вдохновляющих ссылок
`styleWeight`	number	Нет	—	Вес стиля (0,00–1,00)
`weirdnessConstraint`	number	Нет	—	Вес креативности / странности (0,00–1,00)
`audioWeight`	number	Нет	—	Вес аудио (0,00–1,00)
`vocalGender`	«Мужской» \| «Женский»	Нет	—	Вокальный пол: мужской или женский
`autoLyrics`	логический	Нет	—	вдохновение: креативно переписать предоставленные тексты песен

Условные правила: Требуется от одного до четырёх записей в audioUrls.

Отправляйте только поля, относящиеся к этому действию. Когда запрос ссылается на 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