Suno/Детали задачи

Детали задачи

Опрашивайте задачу по id, чтобы получить статус и треки. Интервал: 5–10с.

GEThttps://api.sozdai.ai/v1/media/generations/{id}

#Запрос

bash

curl https://api.sozdai.ai/v1/media/generations/task_abc123 \
  -H "Authorization: Bearer $CORRY_KEY"

#Статусы

Статус	Значение
`queued`	Принято, отправляется.
`running`	Генерация. Уже могут быть streamUrl/текст/обложка.
`succeeded`	Готово. У каждого трека есть audioUrl на CDN.
`failed`	Ошибка (см. error). Холд возвращён.

#Ответ

Во время генерации

json

{
  "id": "task_abc123",
  "status": "running",
  "type": "music",
  "model": "suno-music",
  "tracks": [
    {
      "id": "trk_a1",
      "title": "Summer Road",
      "tags": "indie rock, upbeat",
      "lyrics": "[Verse 1]\nMorning came in on the screen door ...",
      "duration": null,
      "streamUrl": "https://api.sozdai.ai/v1/media/stream/trk_a1/<token>",
      "imageUrl": "https://cdn.sozdai.ai/music/cover/a1.jpeg"
    }
  ],
  "cost": "0"
}

Готово

json

{
  "id": "task_abc123",
  "status": "succeeded",
  "type": "music",
  "model": "suno-music",
  "tracks": [
    {
      "id": "trk_a1",
      "title": "Summer Road",
      "tags": "indie rock, upbeat",
      "lyrics": "[Verse 1]\nMorning came in on the screen door ...",
      "duration": 168.4,
      "streamUrl": "https://api.sozdai.ai/v1/media/stream/trk_a1/<token>",
      "audioUrl": "https://cdn.sozdai.ai/music/a1.mp3",
      "imageUrl": "https://cdn.sozdai.ai/music/cover/a1.jpeg"
    },
    { "id": "trk_a2", "title": "Summer Road", "duration": 142.1, "audioUrl": "https://cdn.sozdai.ai/music/a2.mp3", "streamUrl": "https://api.sozdai.ai/v1/media/stream/trk_a2/<token>", "imageUrl": "https://cdn.sozdai.ai/music/cover/a2.jpeg" }
  ],
  "cost": "80000"
}

Поля появляются постепенно

Сначала streamUrl/текст/обложка, затем duration/audioUrl. succeeded — когда у всех треков есть audioUrl.

#Объект трека

Поле	Тип	Описание
`id`	string	ID трека.
`title`	string	Название.
`tags`	string	Теги стиля.
`lyrics`	string	Текст. "[Instrumental]" для инструментала.
`duration`	number	Длительность (сек).
`streamUrl`	string	Стрим во время генерации.
`audioUrl`	string	Итоговый mp3 на нашем CDN.
`imageUrl`	string	Обложка на нашем CDN.

#Стрим URL

streamUrl — один стабильный адрес на трек: во время генерации проксирует поток, после — 302 на CDN.

Совет

Вставляйте streamUrl прямо в <audio>.

← Генерация музыки