Instruktioner för integrering av Producer Audios Generation API

Den här artikeln kommer att introducera en instruktion för integrering av Producer Audios Generation API, som kan generera officiell musik från Producer genom att mata in anpassade parametrar.

Ansökningsprocess

För att använda Producer Audios Generation API, gå först till Ace Data Cloud-konsolen för att hämta din API Token och spara den för senare användning.

Om du ännu inte har loggat in eller registrerat dig, omdirigeras du automatiskt till inloggningssidan där du uppmanas 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 tjänster på plattformen, utan att du behöver ansöka separat för varje tjänst. Vid första ansökan får du gratis krediter för att testa kostnadsfritt; när krediterna inte räcker till kan du fylla på det allmänna saldot i konsolen.

📘 Fullständig dokumentation: Producer Audios Generation API →

Grundläggande användning

Vilken typ av låt du vill ha kan du fritt ange med en text. Om jag till exempel vill generera en låt om jul kan jag ange a song for Christmas, som visas i bilden:

Här kan vi se att vi har ställt in Request Headers, inklusive:

accept: vilket format du vill ta emot svaret i, här anges application/json, det vill säga JSON-format.
authorization: nyckeln för att anropa API:t, som kan väljas direkt i rullgardinsmenyn efter ansökan.

Dessutom innehåller parametrarna i Request Body:

action: beteendet för denna musikgenereringsuppgift, för att generera en låt är det generate.
model: modellen som används för att skapa låten, för närvarande främst: 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 låttextinnehåll.
custom: om låten ska genereras med anpassat sätt.
prompt: prompten i inspirationsläget.
title: låttitelinformation.
audio_id: referenslåtens ID, används för åtgärder som fortsättning/remake.
continue_at: fortsätt låten från angivet antal sekunder.
replace_section_start/replace_section_end: start- och sluttid för det ersatta segmentet, i sekunder.
lyrics_strength: låttextstyrka, anger graden av låttextens påverkan vid ljudgenerering, valbart mellan 0 och 1, standardvärdet är 0,7.
sound_strength: styrka för ljudprompten, valbart mellan 0,2 och 1, standardvärdet är 0,7.
cover_strength: coverstyrka mellan 0,2 och 1, standardvärdet är 1.
weirdness: stilens egenart, valbart mellan 0 och 1, standardvärdet är 0,5
callback_url: URL:en som behöver få återkopplingsresultatet.
async: valfritt, när det sätts till true returnerar gränssnittet omedelbart task_id, utan att callback_url behöver anges. Därefter hämtas resultatet genom polling via motsvarande gränssnitt för uppgiftsfrågor.
instrumental: om det är läge utan låttext.

Efter valet kan du se att motsvarande kod också genereras på höger sida, som visas i bilden:

Klicka på knappen 「Try」 för att testa. Som visas ovan får vi följande resultat:

{
  "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://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.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 vid denna tidpunkt.
- data, resultatet av denna musikuppgift
  - id, ID:t för musikgenereringsuppgiften vid denna tidpunkt.
  - sound, prompten för musikgenereringsuppgiften vid denna tidpunkt.
  - seed, seed-värdet för musikgenereringsuppgiften vid denna tidpunkt.
  - audio_url, ljudlänken för musikgenereringsuppgiften vid denna tidpunkt.
  - image_url, omslagslänken för musikgenereringsuppgiften vid denna tidpunkt.
  - image_id, omslags-ID:t för musikgenereringsuppgiften vid denna tidpunkt.
  - state, statusen för musikgenereringsuppgiften vid denna tidpunkt.
  - duration, varaktighetsinformationen för musiken vid denna tidpunkt.
  - progress, förloppsvärdet för musikuppgiften vid denna tidpunkt.
  - model, modellinformationen som används av musikgenereringsuppgiften vid denna tidpunkt.
  - lyric, låttextinformationen för musikgenereringsuppgiften vid denna tidpunkt.

Vi kan se att vi har fått den musik vi vill generera. Vi behöver bara hämta den genererade Producer-musiken enligt musiklänkadressen i resultatets data. Om du dessutom vill generera motsvarande integrationskod kan du kopiera den direkt. Till exempel är CURL-koden följande:

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 generera anpassade låttexter kan du ange låttext: Vid denna tidpunkt kan fältet lyric skicka 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, om vi vill generera en låt anpassat utifrån låttext, titel och stil, kan vi ange följande innehåll:

lyric：sångtext
custom：fyll i true, vilket representerar anpassad generering. Denna parameter är som standard false, vilket representerar generering med prompt.
title：sångens titel.

Exempel på ifyllnad är följande:

Efter att ifyllnaden är klar genereras följande kod automatiskt:

Motsvarande kod:

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
}'

Testet är tillåtet, och den genererade effekten är liknande.

{
  "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://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.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"
    }
  ]
}

Coverversion av sång

Om du vill utföra en coverversion av en redan genererad sång kan du ange den ovan genererade sången för att skapa en coverversion. Därefter kommer vi att skapa sången anpassat utifrån sångtext och titel. Om du vill fortsätta skapa en coverversion av en sång som du själv har laddat upp kan du ange parametern action som upload_cover och ange ID:t för den anpassat uppladdade sång som ska fortsätta få en coverversion. Sång-ID:t hämtas med Producer Upload API, som visas i bilden nedan:

Då kan följande innehåll anges:

action：åtgärden för denna sånguppgift, stöder för närvarande: generate、cover、extend、upload_cover、upload_extend、replace_section、swap_vocals、swap_instrumentals、variation. Denna coverversion använder parametern cover.
lyric：sångtext
title：sångens titel.
custom：om generering ska ske i anpassat läge, standardvärdet är false.
audio_id：sång-ID:t för sången som ska få en coverversion.

Exempel på ifyllnad är följande:

Efter att ifyllnaden är klar genereras följande kod automatiskt:

Motsvarande kod:

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"
}'

Testet är tillåtet, och den genererade effekten är liknande.

{
  "success": true,
  "task_id": "dbca350e-6fb9-46ca-9c7e-4c1a9080806f",
  "trace_id": "a39e0fff-ced8-4b31-ae23-aef3badd90fa",
  "data": [
    {
      "id": "e52dd729-38b4-4c2f-9031-59eb7953c593",
      "title": "Cover",
      "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://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.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ätt skriva låten

Om du vill fortsätta skriva låten behöver vi ange parametervärdet för action som: extend. Därefter kan vi anpassa genereringen av låten baserat på låttext, titel och stil. Om du vill fortsätta skriva vidare på en låt som du själv har laddat upp kan du ställa in parametern action på upload_extend och ange ID:t för den anpassat uppladdade låten som ska fortsätta skrivas. Låt-ID:t hämtas med Producer Upload API, som visas i bilden nedan:

Exempel på ifyllning:

Efter ifyllning genereras följande kod automatiskt:

Motsvarande kod:

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": "[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",
  "continue_at": 3,
  "audio_id": "38d3b9e2-0dfb-4338-b2a7-15e45656ed32",
  "custom": true,
  "title": "Extend",
  "weirdness": 0.3,
  "sound_strength": 0.3,
  "lyrics_strength": 0.6
}'

Testning är tillåten, och den genererade effekten är liknande.

{
  "success": true,
  "task_id": "834983cb-d62d-4750-b1aa-461da137e51f",
  "trace_id": "6923eee2-7403-432c-8bd1-e471086385b0",
  "data": [
    {
      "id": "d9ebc609-fb65-4a23-b914-c074747af6a4",
      "title": "Extend",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "lyric": "[Verse]\n[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://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.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 en liknande effekt baserat på seed-värdet för föregående musik behöver vi ange parametervärdet för action som: variation. Därefter kan du anpassa genereringen av en ny musik med en liknande effekt. Exempel på ifyllning:

Efter ifyllning genereras följande kod automatiskt:

Motsvarande kod:

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": "[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
}'

Testet är tillåtet, och den genererade effekten är liknande.

{
    "success": true,
    "task_id": "3a74da6d-a37d-4b5d-b116-821f455bce39",
    "trace_id": "8e28cce0-0400-4bfd-83db-6d27f97422c7",
    "data": [
        {
            "id": "c14ca458-cd5a-4700-83d4-5249e15f2707",
            "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://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.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ätt avsnitt

Om du vill ersätta avsnitt i låten behöver vi ange parametern action med värdet: replace_section, därefter ska vi anpassa genereringen av låten baserat på låttexten och titeln. Om du vill fortsätta ersätta avsnitt i en låt som du själv har laddat upp kan du ställa in parametern action på upload_replace_section och ange ID:t för den anpassat uppladdade låt som du vill fortsätta skriva på. Låt-ID:t hämtas med Producer Upload API, som visas i bilden nedan:

Exempel på ifyllnad är följande:

När ifyllnaden är klar genereras följande kod automatiskt:

Motsvarande kod:

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": "[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": "d9ebc609-fb65-4a23-b914-c074747af6a4",
  "replace_section_start": 3,
  "replace_section_end": 70,
  "custom": true
}'

Testet är tillåtet, och den genererade effekten är liknande.

{
    "success": true,
    "task_id": "3cb5ae96-01b0-4a37-afb0-e582608af56f",
    "trace_id": "3ebc6f63-5093-4499-bf9b-95c239e0da4f",
    "data": [
        {
            "id": "a54609c6-13e2-4176-be0f-4d7eebc68e1f",
            "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://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.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"
        }
    ]
}

Instrumentalversion

Om du vill använda den officiella åtgärden för instrumentalversionen kan du ange parametervärdet för action till: swap_instrumentals, därefter ska vi anpassa och generera låten baserat på sångtexten och titeln. Exempel på ifyllnad:

Efter ifyllnad genereras följande kod automatiskt:

Motsvarande kod:

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"
}'

Testet är tillåtet, den genererade effekten är liknande.

{
  "success": true,
  "task_id": "d17d8376-3a58-451d-a976-404719bac11d",
  "trace_id": "ab596807-910a-4e30-bae2-4647895f7d0b",
  "data": [
    {
      "id": "22d7d75c-9e0a-47a8-b22b-eea55eaa0c4b",
      "title": "Extend (Sound swap)",
      "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://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.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 åtgärden för sångversionen kan du ange parametervärdet för action till: swap_vocals, därefter ska vi anpassa och generera låten baserat på sångtexten, titeln och stilen. Exempel på ifyllnad:

Efter ifyllnad genereras följande kod automatiskt:

Motsvarande kod:

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": "[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",
  "weirdness": 0.6,
  "lyrics_strength": 0.8,
  "audio_id": "d9ebc609-fb65-4a23-b914-c074747af6a4",
  "custom": true
}'

Testet är tillåtet, den genererade effekten är liknande.

{
  "success": true,
  "task_id": "a903ac38-f129-4f85-9181-b1dc5579bd32",
  "trace_id": "9953af52-45e0-4808-bf13-88f0b21262c1",
  "data": [
    {
      "id": "7b2d653b-aaaa-41b0-b737-aee4c4c5693b",
      "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://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.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"
    }
  ]
}

Separation av text och musik

Om du vill använda den officiella separationen av text och musik kan du ange värdet för parametern action till: stems, därefter ska vi separera text och musik baserat på låt-ID:t. Exemplet på ifyllning är följande:

Efter att ifyllningen är klar genereras följande kod automatiskt:

Motsvarande kod:

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"
}'

Testet är tillåtet, och den genererade effekten är liknande.

{
    "success": true,
    "task_id": "561ac695-b4aa-47cf-978d-fb7be2b9ebfc",
    "trace_id": "66d0d397-2987-4bde-84fb-a60d0023b217",
    "data": [
        {
            "title": "Woke up with the sun in my eyes",
            "lyric": "",
            "stems_url": "https://platform.cdn.acedata.cloud/producer/561ac695-b4aa-47cf-978d-fb7be2b9ebfc.zip",
            "model": "",
            "progress": "100%",
            "state": "succeeded"
        }
    ]
}

Asynkron återuppringning

Eftersom genereringstiden för Producer Audios Generation API ibland kan vara relativt lång, kommer HTTP-begäran att hålla anslutningen öppen om API:t inte svarar under en längre tid, vilket leder till extra förbrukning av systemresurser, därför erbjuder detta API också stöd för asynkron återuppringning. Det övergripande flödet är: när klienten initierar en begäran anges dessutom ett callback_url-fält. Efter att klienten har initierat API-begäran returnerar API:t omedelbart ett resultat som innehåller ett task_id-fält, vilket representerar ID:t för den aktuella uppgiften. När uppgiften är klar skickas resultatet av genereringsuppgiften till den callback_url som klienten angett i form av POST JSON, där även fältet task_id ingår, så att uppgiftsresultatet kan kopplas samman via ID:t. Nedan ska vi förstå den specifika användningen genom ett exempel. Först och främst är Webhook-återuppringning en tjänst som kan ta emot HTTP-begäranden, och utvecklare bör ersätta den med URL:en till sin egen HTTP-server. För att underlätta demonstrationen används här en offentlig exempelwebbplats för Webhook, https://webhook.site/. Öppna denna webbplats för att få en Webhook-URL, som visas på bilden:

Kopiera denna URL så kan den användas som Webhook. Exemplet här är 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 och samtidigt fylla i motsvarande parametrar. Det specifika innehållet visas på bilden:

Klicka på kör, så kan du se att ett resultat erhålls omedelbart, enligt följande:

{
  "task_id": "1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad"
}

Vänta en stund, så kan vi på https://webhook.site/#!/view/0d73431d-f833-4be4-9276-b6e1690d55c1 observera resultatet av genereringsuppgiften, som visas på bilden:

Innehållet är följande:

{
  "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 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]\nGlada 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 dunkar i mitt hjärtslag\nFrämlingar ler, det smittar av sig\nDen här världen är en scen, vi är alla en sång\n[Refräng]\nGlada 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[Brygga]\nKasta dina bekymmer ut genom dörren\nLåt dem sjunka till havsbottnen\nVi lever och det räcker\nLivet är rörigt men det är kärlek\n[Refräng]\nGlada 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://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.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": "lyckades",
      "duration": "135.2330158730159"
    }
  ]
}

Det kan ses att det finns ett fält task_id i resultatet, och de andra fälten liknar de ovan, uppgiftsassociation kan implementeras genom detta fält.

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ö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

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Slutsats

Genom detta dokument har du redan lärt dig hur du använder Producer Audios Generation API för att generera musik genom att ange promptord. 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, vänligen kontakta vårt tekniska supportteam när som helst.

Getting Started

AI Samtal

AI Bild

AI Video

AI Ljud

Web & Data

CAPTCHA

Identitet

Coding

Fler guider

Instruktioner för integrering av Producer Audios Generation API

Ansökningsprocess

Grundläggande användning

Anpassad generering

Coverversion av sång

Fortsätt skriva låten

Musikvariation

Ersätt avsnitt

Instrumentalversion

Sångversion

Separation av text och musik

Asynkron återuppringning

Felhantering

Exempel på felsvar

Slutsats

​Ansökningsprocess

​Grundläggande användning

​Anpassad generering

​Coverversion av sång

​Fortsätt skriva låten

​Musikvariation

​Ersätt avsnitt

​Instrumentalversion

​Sångversion

​Separation av text och musik

​Asynkron återuppringning

​Felhantering

​Exempel på felsvar

​Slutsats

Ansökningsprocess

Grundläggande användning

Anpassad generering

Coverversion av sång

Fortsätt skriva låten

Musikvariation

Ersätt avsnitt

Instrumentalversion

Sångversion

Separation av text och musik

Asynkron återuppringning

Felhantering

Exempel på felsvar

Slutsats