> ## 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. # Integration und Nutzung der Suno Tasks API > Suno Music Generation API guide - Ace Data Cloud Die Hauptfunktion der Suno Tasks API besteht darin, den Ausführungsstatus einer Aufgabe abzufragen, indem die Aufgaben-ID eingegeben wird, die von der Suno Audios Generation API oder der Suno Lyrics Generation API generiert wurde. Dieses Dokument wird die Integrationsanleitung der Suno Tasks API detailliert vorstellen und Ihnen helfen, diese API einfach zu integrieren und ihre leistungsstarken Funktionen vollständig zu nutzen. Über die Suno Tasks API können Sie einfach den Ausführungsstatus der Aufgaben der Suno Lyrics Generation API oder der Suno Audios Generation API abfragen. ## Antragsprozess Um die Suno Audios Generation API zu verwenden, rufen Sie zunächst die [Ace Data Cloud Konsole](https://platform.acedata.cloud/console/applications) auf, um Ihr API-Token zu erhalten und es als Reserve aufzubewahren. ![](https://cdn.acedata.cloud/dvc3cg.jpg) Wenn Sie noch nicht angemeldet oder registriert sind, werden Sie automatisch zur Anmeldeseite weitergeleitet, um sich zu registrieren und anzumelden. Nach Abschluss kehren Sie automatisch zu dieser Seite zurück. **Ein API-Token kann alle Dienste der Plattform aufrufen, es ist nicht erforderlich, für jeden Dienst separat einen Antrag zu stellen.** Beim ersten Antrag wird ein kostenloses Guthaben verschenkt, das kostenlos ausprobiert werden kann; bei unzureichendem Guthaben können Sie in der [Konsole](https://platform.acedata.cloud/console/coin) ein allgemeines Guthaben aufladen. > 📘 Vollständige Dokumentation: [Suno Audios Generation API →](https://platform.acedata.cloud/documents/suno-audios) ## Anfragebeispiel Die Suno Tasks API kann verwendet werden, um die Ergebnisse der beiden APIs Suno Audios Generation API und Suno Lyrics Generation API abzufragen. Informationen dazu, wie die Suno Audios Generation API verwendet wird, finden Sie in der Dokumentation [Suno Audios Generation API ](https://platform.acedata.cloud/documents/suno-audios-integration). Informationen dazu, wie die Suno Lyrics Generation API verwendet wird, finden Sie unter [Suno Lyrics Generation API ](https://platform.acedata.cloud/documents/suno-lyrics-generation-integration). Wir nehmen eine von dem Dienst Suno Audios Generation API zurückgegebene Aufgaben-ID als Beispiel, um zu demonstrieren, wie diese API verwendet wird. Angenommen, wir haben eine Aufgaben-ID: eae26f89-b64b-404d-a80c-761996660b1c, im Folgenden wird demonstriert, wie durch die Übergabe einer Aufgaben-ID. ### Abbildung eines Aufgabenbeispiels ![](https://cdn.acedata.cloud/bc6754.png) ### Anfrage-Header und Anfrage-Body festlegen **Request Headers** umfassen: * `accept`: Gibt an, dass Antwortergebnisse im JSON-Format empfangen werden sollen, hier wird `application/json` eingetragen. * `authorization`: Der Schlüssel zum Aufrufen der API, nach der Beantragung kann er direkt über die Auswahlliste ausgewählt werden. **Request Body** umfasst: * `id`: Die hochgeladene Aufgaben-ID. * `action`: Die Art der Operation für die Aufgabe. Die Einstellungen sind in der folgenden Abbildung dargestellt: ![](https://cdn.acedata.cloud/uo7t6n.png) ### Codebeispiel Es ist zu erkennen, dass auf der rechten Seite der Seite bereits automatisch Code in verschiedenen Sprachen generiert wurde, wie in der Abbildung gezeigt: ![](https://cdn.acedata.cloud/p6vi9o.png) Einige Codebeispiele sind wie folgt: #### 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) ``` ### Antwortbeispiel Nach erfolgreicher Anfrage wird die API detaillierte Informationen zur Song-Aufgabe an dieser Stelle zurückgeben. Zum Beispiel: ```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 } ] } } ``` Das Rückgabeergebnis enthält insgesamt mehrere Felder. Das Feld `request` ist der Request Body beim Starten der Aufgabe, während das Feld `response` der nach Abschluss der Aufgabe zurückgegebene Response Body ist. Die Feldbeschreibungen lauten wie folgt. * `id`, die ID der Aufgabe zur Generierung dieses Songs, die zur eindeutigen Kennzeichnung dieser Songgenerierungsaufgabe verwendet wird. * `request`, die Anfrageinformationen in der Abfrage der Songaufgabe. * `response`, die Rückgabeinformationen in der Abfrage der Songaufgabe. * `created_at`, die Erstellungszeit der Aufgabe, Unix-Zeitstempel (Sekunden, Fließkommazahl). * `started_at`, die Startzeit der Aufgabenausführung, Unix-Zeitstempel (Sekunden, Fließkommazahl). * `finished_at`, die Abschlusszeit der Aufgabe, Unix-Zeitstempel (Sekunden, Fließkommazahl). Dieses Feld wird nicht zurückgegeben, wenn die Aufgabe nicht abgeschlossen ist. * `elapsed`, die Ausführungsdauer der Aufgabe, in Sekunden (Fließkommazahl, auf 3 Dezimalstellen gerundet). Dieses Feld wird nicht zurückgegeben, wenn die Aufgabe nicht abgeschlossen ist. ## Stapelabfrageoperation Dies dient zur Abfrage der Details von Songaufgaben anhand mehrerer Aufgaben-IDs. Der Unterschied zu oben besteht darin, dass `action` als `retrieve_batch` ausgewählt werden muss. **Request Body** umfasst: * `ids`: Das Array der hochgeladenen Aufgaben-IDs. * `action`: Die Operationsmethode für die Aufgaben. Die Einstellung ist in der folgenden Abbildung dargestellt: ![](https://cdn.acedata.cloud/dqeknz.png) ### Codebeispiel Es ist ersichtlich, dass auf der rechten Seite der Seite bereits automatisch Code in verschiedenen Sprachen generiert wurde, wie in der Abbildung gezeigt: ![](https://cdn.acedata.cloud/1yk792.png) Einige Codebeispiele sind wie folgt: ### Antwortbeispiel Nach erfolgreicher Anfrage gibt die API die spezifischen Detailinformationen aller Songaufgaben dieses Stapels zurück. Zum Beispiel: ```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": "Weihnachtswünsche", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Strophe]\nSchnee fällt sanft und weiß\nLichter funkeln ach so hell\nKinder lachen voller Freude\nWeihnachtszeit ist endlich hier\n[Strophe 2]\nGlocken läuten in der Nacht\nDer Kamin ist warm erleuchtet\nWeihnachtslieder werden am Baum gesungen\nAlle sind zusammen, da sind wir uns einig\n[Refrain]\nWeihnachtswünsche werden wahr\nZeit, die Freude mit dir zu teilen\nLächeln und Umarmungen für alle\nFrohe Weihnachten, lasst uns Spaß haben\n[Strophe 3]\nGeschenke sind liebevoll verpackt\nMagie schwebt in der Luft\nKekse backen im Ofen\nWeihnachtsliebe, die gegeben werden soll\n[Refrain]\nWeihnachtswünsche werden wahr\nZeit, die Freude mit dir zu teilen\nLächeln und Umarmungen für alle\nFrohe Weihnachten, lasst uns Spaß haben\n[Bridge]\nSterne leuchten am Himmel\nHalte deine Liebsten fest, frag nicht warum\nVon Herz zu Herz sind wir alle vereint\nIn dieser Nacht sind wir erfreut", "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": "Ein Lied für Weihnachten", "style": "Pop", "duration": 154.44 }, { "id": "1a3343b2-2c24-4584-a2a7-687e2f97f09e", "title": "Weihnachtswünsche", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Strophe]\nSchnee fällt sanft und weiß\nLichter funkeln ach so hell\nKinder lachen voller Freude\nWeihnachtszeit ist endlich hier\n[Strophe 2]\nGlocken läuten in der Nacht\nDer Kamin ist warm erleuchtet\nWeihnachtslieder werden am Baum gesungen\nAlle sind zusammen, da sind wir uns einig\n[Refrain]\nWeihnachtswünsche werden wahr\nZeit, die Freude mit dir zu teilen\nLächeln und Umarmungen für alle\nFrohe Weihnachten, lasst uns Spaß haben\n[Strophe 3]\nGeschenke sind liebevoll verpackt\nMagie schwebt in der Luft\nKekse backen im Ofen\nWeihnachtsliebe, die gegeben werden soll\n[Refrain]\nWeihnachtswünsche werden wahr\nZeit, die Freude mit dir zu teilen\nLächeln und Umarmungen für alle\nFrohe Weihnachten, lasst uns Spaß haben\n[Bridge]\nSterne leuchten am Himmel\nHalte deine Liebsten fest, frag nicht warum\nVon Herz zu Herz sind wir alle vereint\nIn dieser Nacht sind wir erfreut", "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": "Ein Lied für Weihnachten", "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": "generieren", "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": "[Strophe]\nIch wache jeden Morgen auf\nSchaue durch das Fenster\nHeller strahlender Sonnenschein\nBeginn eines neuen Tages\n[Strophe 2]\nDie Vögel singen fröhlich\nIch tanze im Garten\nSchöne Blumen umgeben mich\nJeder Moment hier gehört mir\n[Refrain]\nLa la la la la la\nSinge mit mir\nHör nicht auf\nLa la la la la la\nFreue dich und genieße das Leben\n[Strophe 3]\nDas Meer ist blau und weit\nWellen rauschen sanft\nWir spazieren an Stränden\nUnabhängig von der Zeit\n[Bridge]\nErgreife jede Stunde\nHöre meine Lieder\nFühle dich frei\nGlücklich\nTanze jetzt im Rhythmus\n[Refrain]\nLa la la la la la\nSinge mit mir\nHör nicht auf\nLa la la la la la\nFreue dich und genieße das Leben", "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": "[Verse]\nMi vekiĝas ĉiumatene\nRigardas tra la fenestro\nSunbrilo brilanta hela\nKomenco de nova tago\n[Verse 2]\nLa birdoj kantas ĝoje\nMi dancas en la ĝardeno\nĈirkaŭas min floroj belaj\nĈiu momento ĉi estas mia\n[Chorus]\nLa la la la la la\nKantu kun mi\nNe haltu\nLa la la la la la\nĜoju ĝuante la vivon\n[Verse 3]\nLa maro blua kaj vasta\nOndoj tajdas dolĉe\nNi promenas sur plaĝoj\nSendepende de la tempo\n[Bridge]\nKaptu ĉiun horon\nAŭdu miajn kantadojn\nSentu vin libera\nFeliĉa\nDancu laŭ la ritmo nun\n[Chorus]\nLa la la la la la\nKantu kun mi\nNe haltu\nLa la la la la la\nĜoju ĝuante la vivon", "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 } ``` Das Rückgabeergebnis enthält mehrere Felder, wobei `items` die detaillierten Informationen zu den Stapel-Songaufgaben enthält. Die detaillierten Informationen zu jeder Songaufgabe entsprechen den oben genannten Feldern, die Feldinformationen lauten wie folgt. * `items`, alle detaillierten Informationen zu den Stapel-Songaufgaben. Es ist ein Array, und jedes Element des Arrays hat dasselbe Format wie das Rückgabeergebnis der oben genannten Abfrage einer einzelnen Aufgabe. * `count`, die Anzahl der Songaufgaben in dieser Stapelabfrage. #### 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) ``` ## Fehlerbehandlung Wenn beim Aufrufen der API ein Fehler auftritt, gibt die API den entsprechenden Fehlercode und die entsprechenden Informationen zurück. Zum Beispiel: * `400 token_mismatched`: Ungültige Anfrage, möglicherweise aufgrund fehlender oder ungültiger Parameter. * `400 api_not_implemented`: Ungültige Anfrage, möglicherweise aufgrund fehlender oder ungültiger Parameter. * `401 invalid_token`: Nicht autorisiert, ungültiges oder fehlendes Autorisierungstoken. * `429 too_many_requests`: Zu viele Anfragen, Sie haben das Ratenlimit überschritten. * `500 api_error`: Interner Serverfehler, auf dem Server ist etwas schiefgelaufen. ### Beispiel für eine Fehlerantwort ```json theme={null} { "success": false, "error": { "code": "api_error", "message": "fetch failed" }, "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89" } ``` ## Fazit Durch dieses Dokument haben Sie erfahren, wie Sie die Suno Tasks API verwenden können, um alle detaillierten Informationen einzelner oder stapelweise abgefragter Songaufgaben abzurufen. Wir hoffen, dass dieses Dokument Ihnen hilft, diese API besser anzubinden und zu verwenden. Bei Fragen kontaktieren Sie bitte jederzeit unser technisches Supportteam. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.