> ## 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. # Producer Audios Generation API Integration Instructions > Producer Music Generation API guide - Ace Data Cloud Denna artikel kommer att introducera en Producer Audios Generation API integrationsbeskrivning, som kan generera officiell musik från Producer genom att ange anpassade parametrar. ## Ansökningsprocess För att använda Producer Audios Generation API, börja med att gå till [Ace Data Cloud-konsolen](https://platform.acedata.cloud/console/applications) för att hämta din API-token, som du ska spara. ![](https://cdn.acedata.cloud/dvc3cg.jpg) Om du inte har loggat in eller registrerat dig, kommer du automatiskt att omdirigeras till inloggningssidan där du blir inbjuden att registrera dig och logga in, och efter att ha slutfört detta kommer du automatiskt att återvända till den aktuella sidan. **En API-token räcker för att anropa alla tjänster på plattformen, du behöver inte ansöka separat för varje tjänst.** Första gången du ansöker får du en gratis kvot för att prova; när kvoten är slut kan du ladda på allmän balans i [konsolen](https://platform.acedata.cloud/console/coin). > 📘 Fullständig dokumentation: [Producer Audios Generation API →](https://platform.acedata.cloud/documents/producer-audios) ## Grundläggande användning Tänk på vilken låt du vill ha, du kan ange en text, till exempel om jag vill generera en låt om julen, kan jag skriva `a song for Christmas`, som visas i bilden:

Här kan vi se att vi har ställt in Request Headers, inklusive: * `accept`: vilken format av svar du vill ta emot, här anges `application/json`, det vill säga JSON-format. * `authorization`: nyckeln för att anropa API:et, efter ansökan kan du välja direkt från en rullgardinsmeny. Dessutom inkluderar Request Body parametrarna: * `action`: beteendet för denna musikgenereringsuppgift, att generera en låt är `generate`. * `model`: modellen som används för att skapa låten, för närvarande finns det huvudsakligen: **FUZZ-2.0 Pro**, **FUZZ-2.0**, **FUZZ-2.0 Raw**, **FUZZ-1.1 Pro**, **FUZZ-1.0 Pro**, **FUZZ-1.0**, **FUZZ-1.1**, **FUZZ-0.8**. * `lyric`: låtens textinnehåll. * `custom`: om låten ska genereras på ett anpassat sätt. * `prompt`: nyckelord under inspirationsläget. * `title`: information om låtens titel. * `audio_id`: referenslåtens ID, används för att fortsätta skriva/återge etc. * `continue_at`: börja fortsätta låten från angiven sekund. * `replace_section_start`/`replace_section_end`: start- och sluttid för att ersätta segment, enhet sekunder. * `lyrics_strength`: styrkan på texten, som anger hur mycket texten påverkar ljudgenereringen, valbar mellan 0-1, standard 0.7. * `sound_strength`: styrkan på ljudnyckelord, valbar mellan 0.2-1, standard 0.7. * `cover_strength`: styrka för cover, mellan 0.2-1, standard 1. * `weirdness`: stilens udda grad, valbar mellan 0-1, standard 0.5. * `callback_url`: URL för att få tillbaka resultatet. * `async`: valfritt, om det sätts till `true` returnerar gränssnittet omedelbart `task_id`, utan att behöva ange `callback_url`, och sedan kan du använda motsvarande uppgiftsfrågegränssnitt för att hämta resultatet. * `instrumental`: om det är en instrumental utan text. När du har valt kan du se att motsvarande kod också har genererats till höger, som visas i bilden:

Klicka på "Try" knappen för att testa, som visas i bilden ovan, här fick vi följande resultat: ```json theme={null} { "success": true, "task_id": "82fd443a-903a-4f18-8028-12d2f8a0a4be", "trace_id": "d85839fa-0bb1-42da-a9fc-cd582c29027d", "data": [ { "id": "6c947f13-a3c5-4b9c-8609-5639c37cdc2d", "title": "Untitled", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Instrumental]", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": null, "image_id": "6c947f13-a3c5-4b9c-8609-5639c37cdc2d", "topic": null, "seed": "2450882164", "sound": "A song for Christmas", "created_at": "2025-12-30T17:18:23.232911Z", "model": "FUZZ-2.0 Pro", "progress": "100%", "state": "succeeded", "duration": "181.3014058956916" } ] } ``` Det returnerade resultatet har flera fält, som beskrivs nedan: * `success`, statusen för musikgenereringsuppgiften. * `data`, resultatet av denna musikuppgift * `id`, ID för musikgenereringsuppgiften. * `sound`, nyckelordet för musikgenereringsuppgiften. * `seed`, frövärdet för musikgenereringsuppgiften. * `audio_url`, ljudlänken för musikgenereringsuppgiften. * `image_url`, omslagslänken för musikgenereringsuppgiften. * `image_id`, omslags-ID för musikgenereringsuppgiften. * `state`, statusen för musikgenereringsuppgiften. * `duration`, information om låtens längd. * `progress`, värdet för musikuppgiftens framsteg. * `model`, information om modellen som används för musikgenereringsuppgiften. * `lyric`, information om texten för musikgenereringsuppgiften. Vi kan se att vi har fått information om den musik vi ville generera, vi behöver bara hämta den genererade Producer-musiken via musiklänken i `data`. Om du vill generera motsvarande integrationskod kan du direkt kopiera den som genererats, till exempel CURL-koden nedan: ```shell theme={null} curl -X POST 'https://api.acedata.cloud/producer/audios' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "action": "generate", "model": "FUZZ-2.0 Pro", "prompt": "A song for Christmas" }' ``` ## Anpassad generering Om du vill anpassa texten kan du ange texten: I det här fallet kan `lyric`-fältet ta emot innehåll som liknar följande: ``` [Verse]Woke up with the sun in my eyesNo clouds above just blue in the skiesShoes on my feet I’m ready to runEvery step feels like a loaded gun[Chorus]Happy days are rolling inLet the joy beneath my skinNo more shadows no more liesJust the truth that lifts me high[Verse 2]Dancing through the city streetsA rhythm pounding in my heartbeatStrangers smile it’s catching onThis world’s a stage we’re all a song[Chorus]Happy days are rolling inLet the joy beneath my skinNo more shadows no more liesJust the truth that lifts me high[Bridge]Throw your worries out the doorLet them sink to the ocean floorWe’re alive and it’s enoughLife is messy but it’s love[Chorus]Happy days are rolling inLet the joy beneath my skinNo more shadows no more liesJust the truth that lifts me high ``` Därefter kan vi anpassa låten baserat på texten, titeln och stilen genom att ange följande innehåll: * lyric：text för låttext * custom：fyll i som `true`, vilket representerar anpassad generering, denna parameter är som standard false, vilket representerar användning av `prompt` för att generera. * title：låtens titel. Fyll i exempel enligt nedan:

När du har fyllt i det genereras automatiskt koden enligt följande:

Motsvarande kod: ```shell theme={null} curl -X POST 'https://api.acedata.cloud/producer/audios' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "action": "generate", "model": "FUZZ-2.0 Pro", "instrumental": false, "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high", "custom": true }' ``` Testning tillåten, den genererade effekten är liknande. ```json theme={null} { "success": true, "task_id": "9f58bbd4-855a-4233-ac45-b63bf9168e02", "trace_id": "145ad117-6ce7-42dd-af12-70751c5284fc", "data": [ { "id": "38d3b9e2-0dfb-4338-b2a7-15e45656ed32", "title": "Woke up with the sun in my eyes", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": null, "image_id": "38d3b9e2-0dfb-4338-b2a7-15e45656ed32", "topic": null, "seed": "3789209121", "sound": "", "created_at": "2025-12-30T17:26:46.357055Z", "model": "FUZZ-2.0 Pro", "progress": "100%", "state": "succeeded", "duration": "153.80897959183673" } ] } ``` ## Coverlåt Om du vill göra en cover av en redan genererad låt kan du ange den låt som genererades ovan för att göra en cover, nästa steg är att vi ska anpassa genereringen av låten baserat på låttext och titel. Om du vill fortsätta med en cover av en låt som du har laddat upp kan du ställa in parametern `action` till `upload_cover` och ange ID för den låt som du vill fortsätta med, låt-ID:t kan hämtas med [Producer Upload API](https://platform.acedata.cloud/documents/producer-upload) som visas i bilden nedan:

Du kan ange följande innehåll: * action：åtgärden för denna låtuppgift, för närvarande stöds: generate, cover, extend, upload\_cover, upload\_extend, replace\_section, swap\_vocals, swap\_instrumentals, variation, denna cover använder `cover`-parametern. * lyric：text för låttext * title：låtens titel. * custom：om anpassad läge ska användas för att generera, standard är false. * audio\_id：ID för låten som ska göras en cover av. Fyll i exempel enligt nedan:

När du har fyllt i det genereras automatiskt koden enligt följande:

Motsvarande kod: ```shell theme={null} curl -X POST 'https://api.acedata.cloud/producer/audios' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "action": "cover", "model": "FUZZ-2.0 Pro", "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high", "audio_id": "38d3b9e2-0dfb-4338-b2a7-15e45656ed32", "instrumental": false, "custom": true, "title": "Cover" }' ``` Testning tillåten, den genererade effekten är liknande. ```json theme={null} { "success": true, "task_id": "dbca350e-6fb9-46ca-9c7e-4c1a9080806f", "trace_id": "a39e0fff-ced8-4b31-ae23-aef3badd90fa", "data": [ { "id": "e52dd729-38b4-4c2f-9031-59eb7953c593", "title": "Omslag", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Vers]\nVaknade med solen i mina ögon\nInga moln ovanför, bara blått på himlen\nSkor på mina fötter, jag är redo att springa\nVarje steg känns som en laddad pistol\n[Refräng]\nLyckliga dagar rullar in\nLåt glädjen under min hud\nInga fler skuggor, inga fler lögner\nBara sanningen som lyfter mig högt\n[Vers 2]\nDansar genom stadens gator\nEn rytm som slår i mitt hjärta\nFrämlingar ler, det sprider sig\nDenna värld är en scen, vi är alla en sång\n[Refräng]\nLyckliga dagar rullar in\nLåt glädjen under min hud\nInga fler skuggor, inga fler lögner\nBara sanningen som lyfter mig högt\n[Bro]\nKasta dina bekymmer ut genom dörren\nLåt dem sjunka till havets botten\nVi är levande och det är nog\nLivet är rörigt men det är kärlek\n[Refräng]\nLyckliga dagar rullar in\nLåt glädjen under min hud\nInga fler skuggor, inga fler lögner\nBara sanningen som lyfter mig högt", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": null, "image_id": "e52dd729-38b4-4c2f-9031-59eb7953c593", "topic": null, "seed": "358803418", "sound": "", "created_at": "2025-12-30T17:32:32.951948Z", "model": "FUZZ-2.0 Pro", "progress": "100%", "state": "succeeded", "duration": "153.0659410430839" } ] } ``` ## Fortsätta skriva låt Om du vill fortsätta skriva låten, behöver vi skicka in `action` parameter med värdet: `extend`, och sedan ska vi anpassa och generera låten baserat på texten, titeln och stilen. Om du vill fortsätta skriva på en låt som du har laddat upp, kan du ställa in parametern `action` till `upload_extend` och ange ID för den låt du vill fortsätta skriva på. För att få låt-ID:t använder du [Producer Upload API](https://platform.acedata.cloud/documents/producer-upload) som visas nedan:

Exempel på ifyllning:

När du har fyllt i det, genereras koden automatiskt som visas nedan:

Motsvarande kod: ```shell theme={null} curl -X POST 'https://api.acedata.cloud/producer/audios' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "action": "extend", "model": "FUZZ-2.0 Pro", "instrumental": false, "lyric": "[Vers]\nVaknade med solen i mina ögon\nInga moln ovanför, bara blått på himlen\nSkor på mina fötter, jag är redo att springa\nVarje steg känns som en laddad pistol\n[Refräng]\nLyckliga dagar rullar in\nLåt glädjen under min hud\nInga fler skuggor, inga fler lögner\nBara sanningen som lyfter mig högt\n[Vers 2]\nDansar genom stadens gator\nEn rytm som slår i mitt hjärta\nFrämlingar ler, det sprider sig\nDenna värld är en scen, vi är alla en sång\n[Refräng]\nLyckliga dagar rullar in\nLåt glädjen under min hud\nInga fler skuggor, inga fler lögner\nBara sanningen som lyfter mig högt\n[Bro]\nKasta dina bekymmer ut genom dörren\nLåt dem sjunka till havets botten\nVi är levande och det är nog\nLivet är rörigt men det är kärlek\n[Refräng]\nLyckliga dagar rullar in\nLåt glädjen under min hud\nInga fler skuggor, inga fler lögner\nBara sanningen som lyfter mig högt", "continue_at": 3, "audio_id": "38d3b9e2-0dfb-4338-b2a7-15e45656ed32", "custom": true, "title": "Fortsätt", "weirdness": 0.3, "sound_strength": 0.3, "lyrics_strength": 0.6 }' ``` Testa gärna, den genererade effekten är liknande. ```json theme={null} { "success": true, "task_id": "834983cb-d62d-4750-b1aa-461da137e51f", "trace_id": "6923eee2-7403-432c-8bd1-e471086385b0", "data": [ { "id": "d9ebc609-fb65-4a23-b914-c074747af6a4", "title": "Fortsätt", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Vers]\n[Vers]\nVaknade med solen i mina ögon\nInga moln ovanför, bara blått på himlen\nSkor på mina fötter, jag är redo att springa\nVarje steg känns som en laddad pistol\n[Refräng]\nLyckliga dagar rullar in\nLåt glädjen under min hud\nInga fler skuggor, inga fler lögner\nBara sanningen som lyfter mig högt\n[Vers 2]\nDansar genom stadens gator\nEn rytm som slår i mitt hjärta\nFrämlingar ler, det sprider sig\nDenna värld är en scen, vi är alla en sång\n[Refräng]\nLyckliga dagar rullar in\nLåt glädjen under min hud\nInga fler skuggor, inga fler lögner\nBara sanningen som lyfter mig högt\n[Bro]\nKasta dina bekymmer ut genom dörren\nLåt dem sjunka till havets botten\nVi är levande och det är nog\nLivet är rörigt men det är kärlek\n[Refräng]\nLyckliga dagar rullar in\nLåt glädjen under min hud\nInga fler skuggor, inga fler lögner\nBara sanningen som lyfter mig högt", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": null, "image_id": "d9ebc609-fb65-4a23-b914-c074747af6a4", "topic": null, "seed": "4294469624", "sound": "", "created_at": "2025-12-30T17:36:14.520928Z", "model": "FUZZ-2.0 Pro", "progress": "100%", "state": "succeeded", "duration": "173.87102040816328" } ] } ``` ## Musikvariation Om du vill generera en ny musik med liknande effekt baserat på seed-värdet från den föregående låten, behöver vi skicka in `action` parameter med värdet: `variation`, och sedan kan vi anpassa och generera en ny musik med liknande effekt. Exempel på ifyllning:

När du har fyllt i det, genereras koden automatiskt som visas nedan:

Motsvarande kod: ```shell theme={null} ``` ```shell theme={null} curl -X POST 'https://api.acedata.cloud/producer/audios' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "action": "variation", "audio_id": "d9ebc609-fb65-4a23-b914-c074747af6a4", "model": "FUZZ-2.0 Pro", "instrumental": false, "lyric": "[Vers]\nVaknade med solen i mina ögon\nInga moln ovanför, bara blått på himlen\nSkor på mina fötter, jag är redo att springa\nVarje steg känns som en laddad pistol\n[Refräng]\nLyckliga dagar rullar in\nLåt glädjen under min hud\nInga fler skuggor, inga fler lögner\nBara sanningen som lyfter mig högt\n[Vers 2]\nDansar genom stadens gator\nEn rytm som slår i mitt hjärta\nFrämlingar ler, det smittar av sig\nDenna värld är en scen, vi är alla en sång\n[Refräng]\nLyckliga dagar rullar in\nLåt glädjen under min hud\nInga fler skuggor, inga fler lögner\nBara sanningen som lyfter mig högt\n[Bro]\nKasta dina bekymmer ut genom dörren\nLåt dem sjunka till havets botten\nVi är levande och det är nog\nLivet är rörigt men det är kärlek\n[Refräng]\nLyckliga dagar rullar in\nLåt glädjen under min hud\nInga fler skuggor, inga fler lögner\nBara sanningen som lyfter mig högt", "custom": true }' ``` ```json theme={null} { "success": true, "task_id": "3a74da6d-a37d-4b5d-b116-821f455bce39", "trace_id": "8e28cce0-0400-4bfd-83db-6d27f97422c7", "data": [ { "id": "c14ca458-cd5a-4700-83d4-5249e15f2707", "title": "Vaknade med solen i mina ögon", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Vers]\nVaknade med solen i mina ögon\nInga moln ovanför, bara blått på himlen\nSkor på mina fötter, jag är redo att springa\nVarje steg känns som en laddad pistol\n[Refräng]\nLyckliga dagar rullar in\nLåt glädjen under min hud\nInga fler skuggor, inga fler lögner\nBara sanningen som lyfter mig högt\n[Vers 2]\nDansar genom stadens gator\nEn rytm som slår i mitt hjärta\nFrämlingar ler, det smittar av sig\nDenna värld är en scen, vi är alla en sång\n[Refräng]\nLyckliga dagar rullar in\nLåt glädjen under min hud\nInga fler skuggor, inga fler lögner\nBara sanningen som lyfter mig högt\n[Bro]\nKasta dina bekymmer ut genom dörren\nLåt dem sjunka till havets botten\nVi är levande och det är nog\nLivet är rörigt men det är kärlek\n[Refräng]\nLyckliga dagar rullar in\nLåt glädjen under min hud\nInga fler skuggor, inga fler lögner\nBara sanningen som lyfter mig högt", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": null, "image_id": "c14ca458-cd5a-4700-83d4-5249e15f2707", "topic": null, "seed": "2082104582", "sound": "", "created_at": "2025-12-30T17:48:40.135187Z", "model": "FUZZ-2.0", "progress": "100%", "state": "succeeded", "duration": "173.12798185941043" } ] } ``` ## Ersätta avsnitt Om du vill ersätta avsnittet av låten, behöver vi skicka in `action` parameter värde som: `replace_section`, och därefter måste vi anpassa låten baserat på texten och titeln. Om du vill fortsätta ersätta avsnittet av en låt som du har laddat upp, kan du ställa in parametern `action` till `upload_replace_section`, och ange ID för den låt du vill fortsätta skriva. Låt-ID:n kan fås genom att använda [Producer Upload API](https://platform.acedata.cloud/documents/producer-upload) som visas nedan:

Exempel på ifyllning:

När du har fyllt i, genereras koden automatiskt som visas nedan:

Motsvarande kod: ```shell theme={null} curl -X POST 'https://api.acedata.cloud/producer/audios' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "action": "replace_section", "model": "FUZZ-2.0 Pro", "instrumental": false, "lyric": "[Vers]\\nVaknade med solen i mina ögon\\nInga moln ovanför, bara blått på himlen\\nSkor på mina fötter, jag är redo att springa\\nVarje steg känns som en laddad pistol\\n[Refräng]\\nLyckliga dagar rullar in\\nLåt glädjen under min hud\\nInga fler skuggor, inga fler lögner\\nBara sanningen som lyfter mig högt\\n[Vers 2]\\nDansar genom stadens gator\\nEn rytm som slår i mitt hjärta\\nFrämlingar ler, det smittar av sig\\nDenna värld är en scen, vi är alla en sång\\n[Refräng]\\nLyckliga dagar rullar in\\nLåt glädjen under min hud\\nInga fler skuggor, inga fler lögner\\nBara sanningen som lyfter mig högt\\n[Bro]\\nKasta dina bekymmer ut genom dörren\\nLåt dem sjunka till havets botten\\nVi är levande och det är nog\\nLivet är rörigt men det är kärlek\\n[Refräng]\\nLyckliga dagar rullar in\\nLåt glädjen under min hud\\nInga fler skuggor, inga fler lögner\\nBara sanningen som lyfter mig högt", "audio_id": "d9ebc609-fb65-4a23-b914-c074747af6a4", "replace_section_start": 3, "replace_section_end": 70, "custom": true }' ``` Testet tillåts, den genererade effekten är liknande. ```json theme={null} { "success": true, "task_id": "3cb5ae96-01b0-4a37-afb0-e582608af56f", "trace_id": "3ebc6f63-5093-4499-bf9b-95c239e0da4f", "data": [ { "id": "a54609c6-13e2-4176-be0f-4d7eebc68e1f", "title": "Vaknade med solen i ögonen", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Vers]\\nVaknade med solen i ögonen\\nInga moln ovanför bara blått på himlen\\nSkor på fötterna jag är redo att springa\\nVarje steg känns som en laddad pistol\\n[Refräng]\\nLyckliga dagar rullar in\\nLåt glädjen under min hud\\nInga fler skuggor inga fler lögner\\nBara sanningen som lyfter mig högt\\n[Vers 2]\\nDansar genom stadens gator\\nEn rytm som slår i mitt hjärta\\nFrämlingar ler det sprider sig\\nDenna värld är en scen vi är alla en sång\\n[Refräng]\\nLyckliga dagar rullar in\\nLåt glädjen under min hud\\nInga fler skuggor inga fler lögner\\nBara sanningen som lyfter mig högt\\n[Bro]\\nKasta dina bekymmer ut genom dörren\\nLåt dem sjunka till havets botten\\nVi är levande och det är nog\\nLivet är rörigt men det är kärlek\\n[Refräng]\\nLyckliga dagar rullar in\\nLåt glädjen under min hud\\nInga fler skuggor inga fler lögner\\nBara sanningen som lyfter mig högt", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": null, "image_id": "a54609c6-13e2-4176-be0f-4d7eebc68e1f", "topic": null, "seed": "14887454", "sound": "", "created_at": "2025-12-30T18:01:19.907443Z", "model": "FUZZ-2.0 Pro", "progress": "100%", "state": "succeeded", "duration": "174.6140589569161" } ] } ``` ## Ackompanjemangsversion Om du vill använda den officiella ackompanjemangsversionen kan du ställa in `action`-parametervärdet till: `swap_instrumentals`, nästa steg är att vi ska anpassa och generera låten baserat på texten och titeln. Fyll i exempelvis så här:

När du har fyllt i klart genereras automatiskt koden nedan:

Motsvarande kod: ```shell theme={null} curl -X POST 'https://api.acedata.cloud/producer/audios' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "action": "swap_instrumentals", "model": "FUZZ-2.0 Pro", "weirdness": 0.6, "prompt": "Happy", "audio_id": "d9ebc609-fb65-4a23-b914-c074747af6a4" }' ``` Testa gärna, den genererade effekten är liknande. ```json theme={null} { "success": true, "task_id": "d17d8376-3a58-451d-a976-404719bac11d", "trace_id": "ab596807-910a-4e30-bae2-4647895f7d0b", "data": [ { "id": "22d7d75c-9e0a-47a8-b22b-eea55eaa0c4b", "title": "Utvidga (Ljudbyte)", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Vers]\nVaknade med solen i ögonen\nInga moln ovanför bara blått på himlen\nSkor på fötterna jag är redo att springa\nVarje steg känns som en laddad pistol\n[Refräng]\nLyckliga dagar rullar in\nLåt glädjen under min hud\nInga fler skuggor inga fler lögner\nBara sanningen som lyfter mig högt\n[Vers 2]\nDansar genom stadens gator\nEn rytm som slår i mitt hjärta\nFrämlingar ler det sprider sig\nDenna värld är en scen vi är alla en sång\n[Refräng]\nLyckliga dagar rullar in\nLåt glädjen under min hud\nInga fler skuggor inga fler lögner\nBara sanningen som lyfter mig högt\n[Bro]\nKasta dina bekymmer ut genom dörren\nLåt dem sjunka till havets botten\nVi är levande och det är nog\nLivet är rörigt men det är kärlek\n[Refräng]\nLyckliga dagar rullar in\nLåt glädjen under min hud\nInga fler skuggor inga fler lögner\nBara sanningen som lyfter mig högt", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": null, "image_id": "22d7d75c-9e0a-47a8-b22b-eea55eaa0c4b", "topic": null, "seed": "2157878068", "sound": "Happy", "created_at": "2025-12-30T18:09:49.594800Z", "model": "FUZZ-2.0 Pro", "progress": "100%", "state": "succeeded", "duration": "172.3849433106576" } ] } ``` ## Sångversion Om du vill använda den officiella sångversionen kan du ställa in `action`-parametervärdet till: `swap_vocals`, nästa steg är att vi ska anpassa och generera låten baserat på texten, titeln och stilen. Fyll i exempelvis så här:

När du har fyllt i klart genereras automatiskt koden nedan:

Motsvarande kod: ```shell theme={null} curl -X POST 'https://api.acedata.cloud/producer/audios' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "action": "swap_vocals", "model": "FUZZ-2.0 Pro", "instrumental": false, "lyric": "[Vers]\nVaknade med solen i ögonen\nInga moln ovanför bara blått på himlen\nSkor på fötterna jag är redo att springa\nVarje steg känns som en laddad pistol\n[Refräng]\nLyckliga dagar rullar in\nLåt glädjen under min hud\nInga fler skuggor inga fler lögner\nBara sanningen som lyfter mig högt\n[Vers 2]\nDansar genom stadens gator\nEn rytm som slår i mitt hjärta\nFrämlingar ler det sprider sig\nDenna värld är en scen vi är alla en sång\n[Refräng]\nLyckliga dagar rullar in\nLåt glädjen under min hud\nInga fler skuggor inga fler lögner\nBara sanningen som lyfter mig högt\n[Bro]\nKasta dina bekymmer ut genom dörren\nLåt dem sjunka till havets botten\nVi är levande och det är nog\nLivet är rörigt men det är kärlek\n[Refräng]\nLyckliga dagar rullar in\nLåt glädjen under min hud\nInga fler skuggor inga fler lögner\nBara sanningen som lyfter mig högt", "weirdness": 0.6, "lyrics_strength": 0.8, "audio_id": "d9ebc609-fb65-4a23-b914-c074747af6a4", "custom": true }' ``` Testa gärna, den genererade effekten är liknande. ```json theme={null} { "success": true, "task_id": "a903ac38-f129-4f85-9181-b1dc5579bd32", "trace_id": "9953af52-45e0-4808-bf13-88f0b21262c1", "data": [ { "id": "7b2d653b-aaaa-41b0-b737-aee4c4c5693b", "title": "Vaknade med solen i ögonen", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Vers]\nVaknade med solen i ögonen\nInga moln ovanför, bara blått på himlen\nSkor på fötterna, jag är redo att springa\nVarje steg känns som en laddad pistol\n[Refräng]\nLyckliga dagar rullar in\nLåt glädjen under min hud\nInga fler skuggor, inga fler lögner\nBara sanningen som lyfter mig högt\n[Vers 2]\nDansar genom stadens gator\nEn rytm som slår i mitt hjärta\nFrämlingar ler, det smittar av sig\nDenna värld är en scen, vi är alla en sång\n[Refräng]\nLyckliga dagar rullar in\nLåt glädjen under min hud\nInga fler skuggor, inga fler lögner\nBara sanningen som lyfter mig högt\n[Bro]\nKasta dina bekymmer ut genom dörren\nLåt dem sjunka till havets botten\nVi är levande och det är nog\nLivet är rörigt men det är kärlek\n[Refräng]\nLyckliga dagar rullar in\nLåt glädjen under min hud\nInga fler skuggor, inga fler lögner\nBara sanningen som lyfter mig högt", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": null, "image_id": "7b2d653b-aaaa-41b0-b737-aee4c4c5693b", "topic": null, "seed": "2484735707", "sound": "", "created_at": "2025-12-30T18:13:01.349875Z", "model": "FUZZ-2.0 Pro", "progress": "100%", "state": "succeeded", "duration": "173.12798185941043" } ] } ``` ## Text och musik separation Om du vill använda den officiella text och musik separationsoperationen kan du ställa in `action` parameter värdet till: `stems`, nästa steg är att vi ska separera text och musik baserat på låtens ID. Fyll i exempelvis nedan:

När du har fyllt i det kommer koden att genereras automatiskt som följer:

Motsvarande kod: ```shell theme={null} curl -X POST 'https://api.acedata.cloud/producer/audios' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "action": "stems", "audio_id": "a54609c6-13e2-4176-be0f-4d7eebc68e1f" }' ``` Testa tillåtet, den genererade effekten är liknande. ```json theme={null} { "success": true, "task_id": "561ac695-b4aa-47cf-978d-fb7be2b9ebfc", "trace_id": "66d0d397-2987-4bde-84fb-a60d0023b217", "data": [ { "title": "Vaknade med solen i ögonen", "lyric": "", "stems_url": "https://platform.cdn.acedata.cloud/producer/561ac695-b4aa-47cf-978d-fb7be2b9ebfc.zip", "model": "", "progress": "100%", "state": "succeeded" } ] } ``` ## Asynkron callback Eftersom Producer Audios Generation API:s genereringstid ibland kan vara relativt lång, om API:n inte svarar under en längre tid, kommer HTTP-förfrågan att hålla anslutningen öppen, vilket leder till extra systemresursförbrukning, så denna API tillhandahåller också stöd för asynkron callback. Den övergripande processen är: när klienten initierar en begäran, specificera ett extra `callback_url` fält, efter att klienten har initierat API-begäran kommer API:n omedelbart att returnera ett resultat som innehåller ett `task_id` fält, vilket representerar det aktuella uppdragets ID. När uppdraget är slutfört kommer resultatet av det genererade uppdraget att skickas till klientens angivna `callback_url` i POST JSON-format, vilket också inkluderar `task_id` fältet, så att uppdragets resultat kan kopplas ihop med ID. Låt oss förstå hur man gör detta genom ett exempel. Först är Webhook callback en tjänst som kan ta emot HTTP-förfrågningar, utvecklaren bör ersätta med URL:en till sin egen byggda HTTP-server. Här för att underlätta demonstration använder vi en offentlig Webhook-exempelsida [https://webhook.site/](https://webhook.site/), öppna denna webbplats för att få en Webhook URL, som visas i bilden: ![](https://cdn.acedata.cloud/tbcnai.png) Kopiera denna URL så kan den användas som Webhook, detta exempel är [https://webhook.site/#!/view/0d73431d-f833-4be4-9276-b6e1690d55c1](https://webhook.site/#!/view/0d73431d-f833-4be4-9276-b6e1690d55c1). Därefter kan vi ställa in fältet `callback_url` till ovanstående Webhook URL, samtidigt som vi fyller i motsvarande parametrar, det specifika innehållet visas i bilden:

Klicka på kör, så kan du se att du omedelbart får ett resultat, som följer: ``` { "task_id": "1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad" } ``` Vänta en stund, så kan vi observera resultatet av det genererade uppdraget på [https://webhook.site/#!/view/0d73431d-f833-4be4-9276-b6e1690d55c1](https://webhook.site/#!/view/0d73431d-f833-4be4-9276-b6e1690d55c1), som visas i bilden: ![](https://cdn.acedata.cloud/k0kf0y.png) Innehållet är som följer: ```json theme={null} { "success": true, "task_id": "1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad", "trace_id": "1da03537-4eb8-410d-b849-43f03085a3bb", "data": [ { "id": "1dd08826-478e-43a6-868f-aff5ababac2c", "title": "Vaknade med solen i ögonen", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Vers]\nVaknade med solen i ögonen\nInga moln ovan, bara blått på himlen\nSkor på fötterna, jag är redo att springa\nVarje steg känns som en laddad pistol\n[Refräng]\nLyckliga dagar rullar in\nLåt glädjen under min hud\nInga fler skuggor, inga fler lögner\nBara sanningen som lyfter mig högt\n[Vers 2]\nDansar genom stadens gator\nEn rytm som slår i mitt hjärta\nFrämlingar ler, det smittar av sig\nDenna värld är en scen, vi är alla en sång\n[Refräng]\nLyckliga dagar rullar in\nLåt glädjen under min hud\nInga fler skuggor, inga fler lögner\nBara sanningen som lyfter mig högt\n[Bro]\nKasta dina bekymmer ut genom dörren\nLåt dem sjunka till havets botten\nVi är levande och det är nog\nLivet är rörigt men det är kärlek\n[Refräng]\nLyckliga dagar rullar in\nLåt glädjen under min hud\nInga fler skuggor, inga fler lögner\nBara sanningen som lyfter mig högt", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": null, "image_id": "1dd08826-478e-43a6-868f-aff5ababac2c", "topic": null, "seed": "1490770667", "sound": "", "created_at": "2025-12-30T18:36:00.994141Z", "model": "FUZZ-2.0 Pro", "progress": "100%", "state": "succeeded", "duration": "135.2330158730159" } ] } ``` Det kan ses att resultatet innehåller ett `task_id` fält, de andra fälten är liknande som ovan, genom detta fält kan uppgifterna kopplas samman. ## Felhantering Vid anrop av API:et, om ett fel uppstår, kommer API:et att returnera motsvarande felkod och information. Till exempel: * `400 token_mismatched`: Felaktig begäran, möjligtvis på grund av saknade eller ogiltiga parametrar. * `400 api_not_implemented`: Felaktig begäran, möjligtvis på grund av saknade eller ogiltiga parametrar. * `401 invalid_token`: Obemyndigad, ogiltig eller saknad auktoriseringstoken. * `429 too_many_requests`: För många begärningar, du har överskridit hastighetsgränsen. * `500 api_error`: Intern serverfel, något gick fel på servern. ### Felrespons exempel ```json theme={null} { "success": false, "error": { "code": "api_error", "message": "hämtning misslyckades" }, "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89" } ``` ## Slutsats Genom detta dokument har du fått en förståelse för hur du använder Producer Audios Generation API för att generera musik genom att ange ledord. 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, tveka inte att kontakta vårt tekniska supportteam.