Перейти к основному содержанию

Documentation Index

Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

SUNO позволяет нам загружать аудио для справки для вторичного творчества, этот документ объясняет методы интеграции соответствующего API. Этот API имеет только один входной параметр, а именно audio_url, который является общедоступным адресом CDN и поддерживает суффикс mp3. Здесь мы вводим audio_url, который равен https://cdn.xhuoapi.ai/suno_demo.mp3, это общедоступный адрес CDN.
curl -X POST 'https://api.xhuoapi.ai/v1/suno/upload' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "audio_url": "https://cdn.xhuoapi.ai/suno_demo.mp3"
}'
Результат выглядит следующим образом:
{
    "success": true,
    "task_id": "058f8450-3df4-4f8b-8b64-ebc2e59ed3bc",
    "data": {
        "audio_id": "00135f7d-cda1-4d70-b007-779f07143586",
        "lyric": "[Intro]\nHa-ha-ha-ha-ha-ha\n[Verse 1]\nCandy skies are dripping blue\nStuck in world of chewed up glue\nThe sun's a lollipop melting slow\nDripped in sugar on the ground below\nOh-oh\n[Chorus]\nIt's a bubblegum catastrophe\nSticky mess can't set it free\nPop it once it multiplies\nCandy chaos in disguise\nIt's a bubblegum catastrophe\nSticky mess can't set it free\nPop it once it multiplies\nCandy chaos in disguise\nHa-ha-ha-ha-ha hey\nHa-ha-ha-ha-ha hey\nHa-ha-ha-ha-ha hey\nHa-ha-ha-ha-ha hey\nCandy chaos in disguise\n[Verse 2]\nJellybean mountains crumble fast\nRainbows made of soda blast\nEvery step's a gummy bear trap\nMy sugar rush is taking a nap\nOh-oh\n[Bridge]\nChew it up (ha-ha-ha-ha)\nSpit it out (ha-ha-ha-ha)\nRound and round (ha-ha-ha-ha)\nWithout a doubt (ha-ha-ha-ha)\n[Chorus]\nIt's a bubblegum catastrophe\nSticky mess can't set it free\nPop it once it multiplies\nCandy chaos in disguise\nIt's a bubblegum catastrophe\nSticky mess can't set it free\nPop it once it multiplies\nCandy chaos in disguise\nHa-ha-ha-ha-ha hey\nHa-ha-ha-ha-ha hey\nHa-ha-ha-ha-ha hey\nHa-ha-ha-ha-ha hey\n[Outro]\nCotton candy clouds collapse\nChocolate rivers running laps\nEverywhere's a sugar flood\nMy shoes are drowning caramel\nHa-ha-ha-ha-ha hey\nHa-ha-ha-ha-ha hey\nHa-ha-ha-ha-ha hey\nHa-ha-ha-ha-ha hey\nIt's a bubblegum catastrophe\nSticky mess can't set it free\nPop it once it multiplies\nCandy chaos in disguise\nIt's a bubblegum catastrophe\nSticky mess can't set it free\nPop it once it multiplies\nCandy chaos in disguise",
        "style": "Энергичный трек в стиле поп с жевательной резинкой с высокоэнергетическим электронным продакшеном. Песня включает яркий, обработанный женский вокал с молодым и энергичным тоном, часто наложенным с гармониями и случайными изменениями высоты. Инструментация доминируется прыгающими, стаккато синтезаторными аккордами, движущимся электронным ударным ритмом с четкими хлопками на заднем плане и заметной, мелодичной басовой линией. Темп составляет примерно 128 BPM в мажорной тональности, используя стандартный поп-аккордовый прогресс I-V-vi-IV. Элементы продакшена включают активное использование сайдчейн-компрессии, вокальных сэмплов и мерцающих звуковых эффектов, которые способствуют сладкому, гипер-поп эстетике. Структура следует формату куплет-припев-куплет-припев-мост-припев с высокоэнергетическим нарастанием, переходящим в взрывные, хоровые припевы.",
        "image_url": "https://cdn2.suno.ai/image_00135f7d-cda1-4d70-b007-779f07143586.jpeg",
        "image_large_url": "https://cdn2.suno.ai/image_large_00135f7d-cda1-4d70-b007-779f07143586.jpeg",
        "audio_url": "https://cdn1.suno.ai/00135f7d-cda1-4d70-b007-779f07143586.mp3",
        "title": "up-d6c3970d-6db1-41e3-b966-90539c93678a",
        "duration": 131.16
    }
}
Можно увидеть, что поле audio_id в data является ID загруженной песни. Получив ID песни, мы можем использовать Suno Audios Generation API для генерации пользовательских песен, например, передав action как upload_extend, а audio_id как возвращенный ID песни, мы можем создать новую песню на основе справочного аудио.