> ## 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. # Integrering och användning av Suno Tasks API > Suno Music Generation API guide - Ace Data Cloud Huvudfunktionen för Suno Tasks API är att fråga efter körningsstatusen för uppgiften genom att ange uppgifts-ID:t som genererats av Suno Audios Generation API eller Suno Lyrics Generation API. Detta dokument kommer att introducera integreringsanvisningarna för Suno Tasks API i detalj, för att hjälpa dig att enkelt integrera och fullt ut utnyttja de kraftfulla funktionerna i detta API. Genom Suno Tasks API kan du enkelt fråga efter uppgiftskörningsstatusen för Suno Lyrics Generation API eller Suno Audios Generation API. ## Ansökningsprocess För att använda Suno Audios Generation API, gå först till [Ace Data Cloud-konsolen](https://platform.acedata.cloud/console/applications) för att hämta din API-token och spara den för senare användning. ![](https://cdn.acedata.cloud/dvc3cg.jpg) Om du ännu inte har loggat in eller registrerat dig kommer du automatiskt att omdirigeras till inloggningssidan för att bli inbjuden att registrera dig och logga in. När detta är klart återvänder du automatiskt till den aktuella sidan. **En API-token kan anropa alla plattformens tjänster, utan att behöva ansöka separat för varje tjänst.** Vid den första ansökan ges en kostnadsfri kvot, som kan användas för att prova tjänsten gratis; när kvoten inte räcker till kan du fylla på det allmänna saldot i [konsolen](https://platform.acedata.cloud/console/coin). > 📘 Fullständig dokumentation: [Suno Audios Generation API →](https://platform.acedata.cloud/documents/suno-audios) ## Begäransexempel Suno Tasks API kan användas för att fråga efter resultaten från både Suno Audios Generation API och Suno Lyrics Generation API. För information om hur du använder Suno Audios Generation API, se dokumentationen [Suno Audios Generation API ](https://platform.acedata.cloud/documents/suno-audios-integration). För information om hur du använder Suno Lyrics Generation API, se [Suno Lyrics Generation API ](https://platform.acedata.cloud/documents/suno-lyrics-generation-integration). Vi använder ett uppgifts-ID som returneras av tjänsten Suno Audios Generation API som exempel för att visa hur detta API används. Anta att vi har ett uppgifts-ID: eae26f89-b64b-404d-a80c-761996660b1c, därefter visar vi hur man genom att skicka in ett uppgifts-ID kan. ### Bildexempel för uppgift ![](https://cdn.acedata.cloud/bc6754.png) ### Ställ in begärandehuvuden och begärandetext **Request Headers** inkluderar: * `accept`: Anger att svarsresultat i JSON-format ska tas emot, här anges `application/json`. * `authorization`: Nyckeln för att anropa API:t, efter ansökan kan den väljas direkt från rullgardinsmenyn. **Request Body** inkluderar: * `id`: Det uppladdade uppgifts-ID:t. * `action`: Åtgärdssättet för uppgiften. Inställningarna visas i bilden nedan: ![](https://cdn.acedata.cloud/uo7t6n.png) ### Kodexempel Det går att se att kod för olika språk redan har genererats automatiskt på höger sida av sidan, som visas i bilden: ![](https://cdn.acedata.cloud/p6vi9o.png) Några kodexempel är följande: #### 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) ``` ### Svarsexempel Efter att begäran har lyckats kommer API:t att returnera detaljinformation om låtuppgiften här. Till exempel: ```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 } ] } } ``` Resultatet innehåller flera fält. Fältet `request` är request body när uppgiften initieras, medan fältet `response` är response body som returneras efter att uppgiften har slutförts. Fältbeskrivningarna är följande. * `id`, ID:t för uppgiften som genererar denna låt, som används för att unikt identifiera denna låtgenereringsuppgift. * `request`, begärandeinformation i frågan av låtuppgiften. * `response`, returinformation i frågan av låtuppgiften. * `created_at`, tidpunkt då uppgiften skapades, Unix-tidsstämpel (sekunder, flyttal). * `started_at`, tidpunkt då uppgiften började köras, Unix-tidsstämpel (sekunder, flyttal). * `finished_at`, tidpunkt då uppgiften slutfördes, Unix-tidsstämpel (sekunder, flyttal). Detta fält returneras inte när uppgiften inte är slutförd. * `elapsed`, tidsåtgång för uppgiftens körning, i sekunder (flyttal, behåll 3 decimaler). Detta fält returneras inte när uppgiften inte är slutförd. ## Batchfrågeåtgärd Detta är för att fråga detaljinformation om låtuppgifter för flera uppgifts-ID:n. Skillnaden från ovan är att action måste väljas som retrieve\_batch. **Request Body** omfattar: * `ids`: Den uppladdade arrayen med uppgifts-ID:n. * `action`: Åtgärdssättet för uppgiften. Inställningen visas i figuren nedan: ![](https://cdn.acedata.cloud/dqeknz.png) ### Kodexempel Det går att se att kod på olika språk redan har genererats automatiskt på höger sida av sidan, som visas i figuren: ![](https://cdn.acedata.cloud/1yk792.png) Några kodexempel är följande: ### Exempel på svar Efter att begäran har lyckats kommer API:t att returnera specifik detaljinformation för alla batch-låtuppgifter denna gång. Till exempel: ```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": "Högtidsönskningar", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Vers]\nSnön faller mjuk och vit\nLjuset glittrar åh så klart\nBarnen skrattar fulla av glädje\nJultiden är äntligen här\n[Vers 2]\nKlockor ringer i natten\nÖppna spisen är varm av ljus\nJulsånger sjungs vid granen\nAlla är tillsammans, vi är överens\n[Refräng]\nHögtidsönskningar går i uppfyllelse\nDags att dela glädjen med dig\nLeenden och kramar till alla\nGod jul, låt oss ha roligt\n[Vers 3]\nGåvor är inslagna med kärleksfull omsorg\nMagi svävar i luften\nKakor bakas i ugnen\nJulens kärlek att ges\n[Refräng]\nHögtidsönskningar går i uppfyllelse\nDags att dela glädjen med dig\nLeenden och kramar till alla\nGod jul, låt oss ha roligt\n[Stick]\nStjärnor lyser på himlen\nHåll dina nära och kära, fråga inte varför\nHjärta till hjärta är vi alla förenade\nDenna natt är vi förtjusta", "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": "En sång för julen", "style": "pop", "duration": 154.44 }, { "id": "1a3343b2-2c24-4584-a2a7-687e2f97f09e", "title": "Högtidsönskningar", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Vers]\nSnön faller mjuk och vit\nLjuset glittrar åh så klart\nBarnen skrattar fulla av glädje\nJultiden är äntligen här\n[Vers 2]\nKlockor ringer i natten\nÖppna spisen är varm av ljus\nJulsånger sjungs vid granen\nAlla är tillsammans, vi är överens\n[Refräng]\nHögtidsönskningar går i uppfyllelse\nDags att dela glädjen med dig\nLeenden och kramar till alla\nGod jul, låt oss ha roligt\n[Vers 3]\nGåvor är inslagna med kärleksfull omsorg\nMagi svävar i luften\nKakor bakas i ugnen\nJulens kärlek att ges\n[Refräng]\nHögtidsönskningar går i uppfyllelse\nDags att dela glädjen med dig\nLeenden och kramar till alla\nGod jul, låt oss ha roligt\n[Stick]\nStjärnor lyser på himlen\nHåll dina nära och kära, fråga inte varför\nHjärta till hjärta är vi alla förenade\nDenna natt är vi förtjusta", "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": "En sång för julen", "style": "pop", "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": "generate", "prompt": "la la la" }, "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": "La La La", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Vers]\nJag vaknar varje morgon\nTittar genom fönstret\nSolljuset lyser klart\nBörjan på en ny dag\n[Vers 2]\nFåglarna sjunger glatt\nJag dansar i trädgården\nVackra blommor omger mig\nVarje ögonblick här är mitt\n[Refräng]\nLa la la la la la\nSjung med mig\nSluta inte\nLa la la la la la\nGläd dig åt livet\n[Vers 3]\nHavet är blått och vidsträckt\nVågorna slår mjukt\nVi promenerar på stränder\nOavsett tiden\n[Stick]\nFånga varje timme\nHör mina sånger\nKänn dig fri\nLycklig\nDansa till rytmen nu\n[Refräng]\nLa la la la la la\nSjung med mig\nSluta inte\nLa la la la la la\nGläd dig åt livet", "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": "la la la", "style": "pop", "duration": 154.32 }, { "id": "8b44fdf1-3b88-47ac-a351-7c4b4de60549", "title": "La La La", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Vers]\nJag vaknar varje morgon\nTittar genom fönstret\nSolskenet strålar klart\nBörjan på en ny dag\n[Vers 2]\nFåglarna sjunger glatt\nJag dansar i trädgården\nVackra blommor omger mig\nVarje ögonblick här är mitt\n[Refräng]\nLa la la la la la\nSjung med mig\nSluta inte\nLa la la la la la\nGläds åt att njuta av livet\n[Vers 3]\nHavet är blått och vidsträckt\nVågorna böljar mjukt\nVi promenerar på stränder\nOavsett vädret\n[Brygga]\nFånga varje timme\nHör mina sånger\nKänn dig fri\nLycklig\nDansa till rytmen nu\n[Refräng]\nLa la la la la la\nSjung med mig\nSluta inte\nLa la la la la la\nGläds åt att njuta av livet", "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": "la la la", "style": "pop", "duration": 177.36 } ] } } ], "count": 2 } ``` Det finns flera fält i returresultatet, där `items` innehåller den specifika detaljinformationen för batchuppgifter för låtar. Den specifika informationen för varje låtuppgift är densamma som fälten ovan, och fältinformationen är följande. * `items`, all specifik detaljinformation för batchuppgifter för låtar. Det är en array, och formatet för varje element i arrayen är detsamma som returresultatet för att fråga efter en enskild uppgift ovan. * `count`, antalet låtuppgifter som frågas efter i batch här. #### 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) ``` ## Felhantering Vid anrop av API:t returnerar API:t motsvarande felkod och information om ett fel uppstår. Till exempel: * `400 token_mismatched`: Felaktig begäran, möjligen på grund av saknade eller ogiltiga parametrar. * `400 api_not_implemented`: Felaktig begäran, möjligen på grund av saknade eller ogiltiga parametrar. * `401 invalid_token`: Obehörig, ogiltig eller saknad auktoriseringstoken. * `429 too_many_requests`: För många begäranden, du har överskridit hastighetsgränsen. * `500 api_error`: Internt serverfel, något gick fel på servern. ### Exempel på felsvar ```json theme={null} { "success": false, "error": { "code": "api_error", "message": "fetch failed" }, "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89" } ``` ## Slutsats Genom detta dokument har du lärt dig hur du använder Suno Tasks API för att fråga efter all specifik detaljinformation för enskilda eller batchvisa låtuppgifter. Vi hoppas att detta dokument kan hjälpa dig att bättre integrera och använda detta API. Om du har några frågor, kontakta gärna vårt tekniska supportteam när som helst. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.