> ## Documentation Index > Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt > Use this file to discover all available pages before exploring further. # Інтеграція та використання Suno Tasks API > Suno Music Generation API guide - Ace Data Cloud Основна функція Suno Tasks API полягає в запиті статусу виконання завдання шляхом введення ID завдання, згенерованого Suno Audios Generation API або Suno Lyrics Generation API. У цьому документі буде детально представлено інструкції з інтеграції Suno Tasks API, щоб допомогти вам легко інтегрувати та повною мірою використовувати потужні можливості цього API. За допомогою Suno Tasks API ви можете легко реалізувати запит статусу виконання завдань Suno Lyrics Generation API або Suno Audios Generation API. ## Процес подання заявки Щоб використовувати Suno Audios Generation API, спочатку перейдіть до [консолі Ace Data Cloud](https://platform.acedata.cloud/console/applications), щоб отримати ваш API Token і зберегти його для подальшого використання. ![](https://cdn.acedata.cloud/dvc3cg.jpg) Якщо ви ще не увійшли або не зареєструвалися, вас буде автоматично перенаправлено на сторінку входу із запрошенням зареєструватися та увійти, після завершення ви автоматично повернетеся на поточну сторінку. **Один API Token може викликати всі сервіси платформи, немає потреби подавати окрему заявку для кожного сервісу.** Під час першого подання заявки надаються безкоштовні квоти для безкоштовного тестування; коли квоти недостатньо, ви можете поповнити загальний баланс у [консолі](https://platform.acedata.cloud/console/coin). > 📘 Повна документація: [Suno Audios Generation API →](https://platform.acedata.cloud/documents/suno-audios) ## Приклад запиту Suno Tasks API можна використовувати для запиту результатів двох API: Suno Audios Generation API і Suno Lyrics Generation API. Щодо того, як використовувати Suno Audios Generation API, зверніться до документації [Suno Audios Generation API ](https://platform.acedata.cloud/documents/suno-audios-integration). Щодо того, як використовувати Suno Lyrics Generation API, зверніться до [Suno Lyrics Generation API ](https://platform.acedata.cloud/documents/suno-lyrics-generation-integration). Ми візьмемо як приклад один ID завдання, повернений сервісом Suno Audios Generation API, щоб продемонструвати, як використовувати цей API. Припустімо, у нас є ID завдання: eae26f89-b64b-404d-a80c-761996660b1c, далі буде продемонстровано, як шляхом передавання ID завдання. ### Зображення прикладу завдання ![](https://cdn.acedata.cloud/bc6754.png) ### Налаштування заголовків запиту та тіла запиту **Request Headers** включають: * `accept`: вказує отримання результату відповіді у форматі JSON, тут заповнюється як `application/json`. * `authorization`: ключ для виклику API, після подання заявки його можна безпосередньо вибрати зі спадного списку. **Request Body** включає: * `id`: ID завантаженого завдання. * `action`: спосіб операції над завданням. Налаштування показано на зображенні нижче: ![](https://cdn.acedata.cloud/uo7t6n.png) ### Приклад коду Можна побачити, що в правій частині сторінки вже автоматично згенеровано код різними мовами, як показано на зображенні: ![](https://cdn.acedata.cloud/p6vi9o.png) Деякі приклади коду наведено нижче: #### CURL ```bash theme={null} curl -X POST 'https://api.acedata.cloud/suno/tasks' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "id": "eae26f89-b64b-404d-a80c-761996660b1c", "action": "retrieve" }' ``` #### Python ```python theme={null} import requests url = "https://api.acedata.cloud/suno/tasks" headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" } payload = { "id": "eae26f89-b64b-404d-a80c-761996660b1c", "action": "retrieve" } response = requests.post(url, json=payload, headers=headers) print(response.text) ``` ### Приклад відповіді Після успішного запиту API поверне детальну інформацію про завдання пісні. Наприклад: ```json theme={null} { "_id": "66d2add5550a4144a5a88dfe", "id": "eae26f89-b64b-404d-a80c-761996660b1c", "api_id": "09a26295-5972-4392-9318-dcd9b218f90d", "application_id": "ab46a066-ad82-4180-b66b-49dedf8e8a2f", "created_at": 1725083093.077, "started_at": 1725083093.137, "finished_at": 1725083131.537, "elapsed": 38.4, "credential_id": "66614a7e-e624-494e-87a3-387099b8cbb4", "request": { "action": "generate", "prompt": "A song for Christmas" }, "trace_id": "e13d385a-077e-4376-be01-3465b61ca0fd", "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf", "response": { "success": true, "task_id": "eae26f89-b64b-404d-a80c-761996660b1c", "data": [ { "id": "b8a4f691-4b14-4120-a7e1-a54a27a0e57e", "title": "Holiday Wishes", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Verse]\nSnow is falling soft and white\nLights are twinkling oh so bright\nKids are laughing full of cheer\nChristmas time is finally here\n[Verse 2]\nBells are ringing in the night\nFireplace is warm with light\nCarols sung by the tree\nEveryone's together we agree\n[Chorus]\nHoliday wishes come true\nTime to share the joy with you\nSmiles and hugs for everyone\nMerry Christmas let's have fun\n[Verse 3]\nGifts are wrapped with loving care\nMagic's floating in the air\nCookies baking in the oven\nChristmas love to be given\n[Chorus]\nHoliday wishes come true\nTime to share the joy with you\nSmiles and hugs for everyone\nMerry Christmas let's have fun\n[Bridge]\nStars are shining in the sky\nHold your loved ones don't ask why\nHeart to heart we're all united\nOn this night we are delighted", "audio_url": "https://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3", "video_url": "https://cdn.acedata.cloud/assets/examples/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee-3a89912507c7.mp4", "created_at": "2024-08-31T05:44:54.806Z", "model": "chirp-v3.5", "prompt": "A song for Christmas", "style": "pop", "duration": 154.44 }, { "id": "1a3343b2-2c24-4584-a2a7-687e2f97f09e", "title": "Holiday Wishes", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Verse]\nSnow is falling soft and white\nLights are twinkling oh so bright\nKids are laughing full of cheer\nChristmas time is finally here\n[Verse 2]\nBells are ringing in the night\nFireplace is warm with light\nCarols sung by the tree\nEveryone's together we agree\n[Chorus]\nHoliday wishes come true\nTime to share the joy with you\nSmiles and hugs for everyone\nMerry Christmas let's have fun\n[Verse 3]\nGifts are wrapped with loving care\nMagic's floating in the air\nCookies baking in the oven\nChristmas love to be given\n[Chorus]\nHoliday wishes come true\nTime to share the joy with you\nSmiles and hugs for everyone\nMerry Christmas let's have fun\n[Bridge]\nStars are shining in the sky\nHold your loved ones don't ask why\nHeart to heart we're all united\nOn this night we are delighted", "audio_url": "https://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3", "video_url": "https://cdn.acedata.cloud/assets/examples/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee-3a89912507c7.mp4", "created_at": "2024-08-31T05:44:54.806Z", "model": "chirp-v3.5", "prompt": "A song for Christmas", "style": "pop", "duration": 147.16 } ] } } ``` Результат, що повертається, містить кілька полів. Поле `request` — це request body під час запуску завдання, а поле `response` — це response body, що повертається після завершення завдання. Опис полів наведено нижче. * `id` — ID завдання генерації цієї пісні, що використовується для унікальної ідентифікації цього завдання генерації пісні. * `request` — інформація про запит у завданні запиту пісні. * `response` — інформація про відповідь у завданні запиту пісні. * `created_at` — час створення завдання, Unix timestamp (секунди, з плаваючою комою). * `started_at` — час початку виконання завдання, Unix timestamp (секунди, з плаваючою комою). * `finished_at` — час завершення завдання, Unix timestamp (секунди, з плаваючою комою). Це поле не повертається, якщо завдання не завершено. * `elapsed` — час виконання завдання, у секундах (з плаваючою комою, із збереженням 3 знаків після коми). Це поле не повертається, якщо завдання не завершено. ## Операція пакетного запиту Це запит деталей завдань пісень для кількох ID завдань. На відміну від наведеного вище, потрібно вибрати action як retrieve\_batch. **Request Body** включає: * `ids`: масив завантажених ID завдань. * `action`: спосіб операції із завданням. Налаштуйте, як показано на зображенні нижче: ![](https://cdn.acedata.cloud/dqeknz.png) ### Приклад коду Можна побачити, що різноманітний код різними мовами вже автоматично згенеровано в правій частині сторінки, як показано на зображенні: ![](https://cdn.acedata.cloud/1yk792.png) Деякі приклади коду наведено нижче: ### Приклад відповіді Після успішного запиту API поверне детальну інформацію про всі пакетні завдання пісень цього разу. Наприклад: ```json { theme={null} "items": [ { "_id": "66d2add5550a4144a5a88dfe", "id": "eae26f89-b64b-404d-a80c-761996660b1c", "api_id": "09a26295-5972-4392-9318-dcd9b218f90d", "application_id": "ab46a066-ad82-4180-b66b-49dedf8e8a2f", "created_at": 1725083093.077, "started_at": 1725083093.137, "finished_at": 1725083131.537, "elapsed": 38.4, "credential_id": "66614a7e-e624-494e-87a3-387099b8cbb4", "request": { "action": "generate", "prompt": "A song for Christmas" }, "trace_id": "e13d385a-077e-4376-be01-3465b61ca0fd", "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf", "response": { "success": true, "task_id": "eae26f89-b64b-404d-a80c-761996660b1c", "data": [ { "id": "b8a4f691-4b14-4120-a7e1-a54a27a0e57e", "title": "Святкові побажання", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Куплет]\nСніг падає м'який і білий\nВогники мерехтять такі яскраві\nДіти сміються, сповнені радості\nРіздвяна пора нарешті настала\n[Куплет 2]\nДзвони дзвенять уночі\nКамін теплий від світла\nКолядки співають біля ялинки\nУсі разом, ми згодні\n[Приспів]\nСвяткові побажання здійснюються\nЧас розділити радість із тобою\nПосмішки й обійми для кожного\nВеселого Різдва, нумо веселитися\n[Куплет 3]\nПодарунки загорнуті з любов'ю й турботою\nМагія витає в повітрі\nПечиво печеться в духовці\nРіздвяна любов, яку слід дарувати\n[Приспів]\nСвяткові побажання здійснюються\nЧас розділити радість із тобою\nПосмішки й обійми для кожного\nВеселого Різдва, нумо веселитися\n[Брідж]\nЗірки сяють у небі\nТримайте своїх близьких, не питайте чому\nВід серця до серця ми всі єдині\nУ цю ніч ми радіємо", "audio_url": "https://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3", "video_url": "https://cdn.acedata.cloud/assets/examples/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee-3a89912507c7.mp4", "created_at": "2024-08-31T05:44:54.806Z", "model": "chirp-v3.5", "prompt": "Пісня для Різдва", "style": "поп", "duration": 154.44 }, { "id": "1a3343b2-2c24-4584-a2a7-687e2f97f09e", "title": "Святкові побажання", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Куплет]\nСніг падає м'який і білий\nВогники мерехтять такі яскраві\nДіти сміються, сповнені радості\nРіздвяна пора нарешті настала\n[Куплет 2]\nДзвони дзвенять уночі\nКамін теплий від світла\nКолядки співають біля ялинки\nУсі разом, ми згодні\n[Приспів]\nСвяткові побажання здійснюються\nЧас розділити радість із тобою\nПосмішки й обійми для кожного\nВеселого Різдва, нумо веселитися\n[Куплет 3]\nПодарунки загорнуті з любов'ю й турботою\nМагія витає в повітрі\nПечиво печеться в духовці\nРіздвяна любов, яку слід дарувати\n[Приспів]\nСвяткові побажання здійснюються\nЧас розділити радість із тобою\nПосмішки й обійми для кожного\nВеселого Різдва, нумо веселитися\n[Брідж]\nЗірки сяють у небі\nТримайте своїх близьких, не питайте чому\nВід серця до серця ми всі єдині\nУ цю ніч ми радіємо", "audio_url": "https://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3", "video_url": "https://cdn.acedata.cloud/assets/examples/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee-3a89912507c7.mp4", "created_at": "2024-08-31T05:44:54.806Z", "model": "chirp-v3.5", "prompt": "Пісня для Різдва", "style": "поп", "duration": 147.16 } ] } }, { "_id": "66d2b03c550a4144a5a8d93d", "id": "0d3ed03b-912b-4f7d-941b-8441323cb77b", "api_id": "09a26295-5972-4392-9318-dcd9b218f90d", "application_id": "ab46a066-ad82-4180-b66b-49dedf8e8a2f", "created_at": 1725083708.53, "started_at": 1725083708.59, "finished_at": 1725083746.99, "elapsed": 38.4, "credential_id": "66614a7e-e624-494e-87a3-387099b8cbb4", "request": { "action": "згенерувати", "prompt": "ля ля ля" }, "trace_id": "29ebb919-1126-4156-86cc-4ad899432a8c", "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf", "response": { "success": true, "task_id": "0d3ed03b-912b-4f7d-941b-8441323cb77b", "data": [ { "id": "b4f498b2-e86f-4172-926a-39da9df84dd3", "title": "Ля Ля Ля", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Куплет]\nЯ прокидаюся щоранку\nДивлюся крізь вікно\nСонячне світло сяє яскраво\nПочаток нового дня\n[Куплет 2]\nПтахи співають радісно\nЯ танцюю в саду\nНавколо мене прекрасні квіти\nКожна ця мить є моєю\n[Приспів]\nЛя ля ля ля ля ля\nСпівай зі мною\nНе зупиняйся\nЛя ля ля ля ля ля\nРадій, насолоджуючись життям\n[Куплет 3]\nМоре синє й просторе\nХвилі ніжно припливають\nМи гуляємо по пляжах\nНезалежно від погоди\n[Брідж]\nЛови кожну годину\nСлухай мої пісні\nВідчувай себе вільним\nЩасливим\nТанцюй у ритмі зараз\n[Приспів]\nЛя ля ля ля ля ля\nСпівай зі мною\nНе зупиняйся\nЛя ля ля ля ля ля\nРадій, насолоджуючись життям", "audio_url": "https://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3", "video_url": "https://cdn.acedata.cloud/assets/examples/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee-3a89912507c7.mp4", "created_at": "2024-08-31T05:55:09.345Z", "model": "chirp-v3.5", "prompt": "ля ля ля", "style": "поп", "duration": 154.32 }, { "id": "8b44fdf1-3b88-47ac-a351-7c4b4de60549", "title": "Ла Ла Ла", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Куплет]\nЯ прокидаюся щоранку\nДивлюся крізь вікно\nЯскраво сяє сонячне світло\nПочаток нового дня\n[Куплет 2]\nПтахи радісно співають\nЯ танцюю в саду\nМене оточують прекрасні квіти\nКожна ця мить — моя\n[Приспів]\nЛа ла ла ла ла ла\nСпівай зі мною\nНе зупиняйся\nЛа ла ла ла ла ла\nРадій, насолоджуючись життям\n[Куплет 3]\nМоре синє й безкрає\nХвилі ніжно припливають\nМи гуляємо пляжами\nНезалежно від часу\n[Брідж]\nЛови кожну годину\nСлухай мої пісні\nВідчувай себе вільним\nЩасливим\nТанцюй у ритмі зараз\n[Приспів]\nЛа ла ла ла ла ла\nСпівай зі мною\nНе зупиняйся\nЛа ла ла ла ла ла\nРадій, насолоджуючись життям", "audio_url": "https://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3", "video_url": "https://cdn.acedata.cloud/assets/examples/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee-3a89912507c7.mp4", "created_at": "2024-08-31T05:55:09.345Z", "model": "chirp-v3.5", "prompt": "ла ла ла", "style": "поп", "duration": 177.36 } ] } } ], "count": 2 } ``` Результат, що повертається, містить кілька полів, серед яких `items` містить детальну інформацію про пакетні завдання пісень, конкретна інформація про кожне завдання пісні така сама, як поля вище, а інформація про поля наведена нижче. * `items` — вся детальна інформація про пакетні завдання пісень. Це масив, формат кожного елемента масиву такий самий, як формат результату, що повертається під час запиту одного завдання вище. * `count` — кількість завдань пісень у цьому пакетному запиті. #### CURL ```bash theme={null} curl -X POST 'https://api.acedata.cloud/suno/tasks' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "ids": ["eae26f89-b64b-404d-a80c-761996660b1c","0d3ed03b-912b-4f7d-941b-8441323cb77b"], "action": "retrieve_batch" }' ``` #### Python ```python theme={null} import requests url = "https://api.acedata.cloud/suno/tasks" headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" } payload = { "ids": ["eae26f89-b64b-404d-a80c-761996660b1c","0d3ed03b-912b-4f7d-941b-8441323cb77b"], "action": "retrieve_batch" } response = requests.post(url, json=payload, headers=headers) print(response.text) ``` ## Обробка помилок Під час виклику API, якщо виникає помилка, API повертає відповідний код помилки та повідомлення. Наприклад: * `400 token_mismatched`：Некоректний запит, можливо, через відсутні або недійсні параметри. * `400 api_not_implemented`：Некоректний запит, можливо, через відсутні або недійсні параметри. * `401 invalid_token`：Неавторизовано, недійсний або відсутній токен авторизації. * `429 too_many_requests`：Занадто багато запитів, ви перевищили ліміт частоти запитів. * `500 api_error`：Внутрішня помилка сервера, на сервері щось пішло не так. ### Приклад відповіді з помилкою ```json theme={null} { "success": false, "error": { "code": "api_error", "message": "fetch failed" }, "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89" } ``` ## Висновок Завдяки цьому документу ви вже дізналися, як використовувати Suno Tasks API для запиту всієї детальної інформації про одне або пакетні завдання пісень. Сподіваємося, цей документ допоможе вам краще інтегрувати та використовувати цей API. Якщо у вас виникнуть будь-які запитання, будь ласка, звертайтеся до нашої команди технічної підтримки. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.