Producer Audios Generation API Integrazione Istruzioni

Questo documento presenterà un’istruzione per l’integrazione dell’API di generazione degli audio del produttore, che consente di generare musica ufficiale del produttore inserendo parametri personalizzati.

Procedura di richiesta

Per utilizzare l’API di generazione degli audio del produttore, prima di tutto vai al Pannello di controllo di Ace Data Cloud per ottenere il tuo API Token, da conservare per uso futuro.

Se non hai ancora effettuato il login o la registrazione, verrai automaticamente reindirizzato alla pagina di login che ti invita a registrarti e accedere; una volta completato, verrai riportato automaticamente alla pagina corrente. Un API Token è sufficiente per accedere a tutti i servizi della piattaforma, senza necessità di richiederne uno per ogni servizio. La prima richiesta riceverà un credito gratuito, per un’esperienza senza costi; se il credito è insufficiente, puoi ricaricare il saldo generale nel pannello di controllo.

📘 Documentazione completa: Producer Audios Generation API →

Utilizzo di base

Se hai in mente delle canzoni, puoi inserire liberamente un testo, ad esempio se voglio generare una canzone sul Natale, posso inserire a song for Christmas, come mostrato nell’immagine:

Possiamo vedere che qui abbiamo impostato le intestazioni della richiesta, tra cui:

accept: il formato della risposta desiderata, qui è impostato su application/json, ovvero formato JSON.
authorization: la chiave per chiamare l’API, che può essere selezionata direttamente dopo la richiesta.

Inoltre, i parametri del corpo della richiesta includono:

action: l’azione per questo compito di generazione musicale, generare una canzone è generate.
model: il modello utilizzato per creare la canzone, attualmente ci sono principalmente: 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: il contenuto del testo della canzone.
custom: se generare la canzone in modo personalizzato.
prompt: parole chiave in modalità ispirazione.
title: informazioni sul titolo della canzone.
audio_id: ID della canzone di riferimento, utilizzato per continuare/scrivere una versione.
continue_at: inizia a continuare la canzone da un numero di secondi specificato.
replace_section_start/replace_section_end: tempo di inizio e fine del segmento da sostituire, in secondi.
lyrics_strength: intensità del testo, che indica il grado di influenza del testo nella generazione audio, selezionabile tra 0-1, predefinito 0.7.
sound_strength: intensità delle parole chiave audio, selezionabile tra 0.2-1, predefinito 0.7.
cover_strength: intensità della cover tra 0.2-1, predefinito 1.
weirdness: grado di eccentricità dello stile, selezionabile tra 0-1, predefinito 0.5.
callback_url: URL per il quale è necessario il risultato del callback.
async: opzionale, impostato su true l’interfaccia restituisce immediatamente task_id, senza necessità di fornire callback_url, successivamente puoi ottenere i risultati tramite l’interfaccia di query del compito corrispondente.
instrumental: se è in modalità senza testo.

Dopo aver selezionato, puoi notare che a destra è stato generato il codice corrispondente, come mostrato nell’immagine:

Cliccando sul pulsante “Try” puoi effettuare un test, come mostrato nell’immagine sopra, qui abbiamo ottenuto il seguente risultato:

{
  "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"
    }
  ]
}

Il risultato restituito ha diversi campi, descritti come segue:

success, lo stato attuale del compito di generazione musicale.
- data, il risultato di questo compito musicale
  - id, l’ID del compito di generazione musicale attuale.
  - sound, le parole chiave del compito di generazione musicale attuale.
  - seed, il valore seme del compito di generazione musicale attuale.
  - audio_url, il link audio del compito di generazione musicale attuale.
  - image_url, il link della copertina del compito di generazione musicale attuale.
  - image_id, l’ID della copertina del compito di generazione musicale attuale.
  - state, lo stato del compito di generazione musicale attuale.
  - duration, le informazioni sulla durata della musica attuale.
  - progress, il valore di progresso del compito musicale attuale.
  - model, le informazioni sul modello utilizzato per il compito di generazione musicale attuale.
  - lyric, le informazioni sul testo del compito di generazione musicale attuale.

Possiamo vedere che abbiamo ottenuto le informazioni sulla musica che volevamo generare, dobbiamo solo ottenere la musica del produttore dal link audio presente in data. Inoltre, se desideri generare il codice di integrazione corrispondente, puoi semplicemente copiarlo, ad esempio il codice CURL è il seguente:

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

Generazione personalizzata

Se desideri generare testi personalizzati, puoi inserire il testo: In questo caso, il campo lyric può contenere contenuti simili al seguente:

[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

Successivamente, dobbiamo personalizzare la generazione della canzone in base al testo, al titolo e allo stile, specificando i seguenti contenuti:

lyric：testo della canzone
custom：compilare con true, rappresenta la generazione personalizzata, questo parametro è impostato su false per impostazione predefinita, rappresenta l’uso della generazione prompt.
title：titolo della canzone.

Esempio di compilazione:

Dopo aver completato la compilazione, il codice generato è il seguente:

Codice corrispondente:

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

Test consentito, l’effetto generato è simile.

{
  "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"
    }
  ]
}

Cover della canzone

Se desideri eseguire un’operazione di cover su una canzone già generata, puoi inserire la canzone generata in precedenza per la cover, successivamente dobbiamo personalizzare la generazione della canzone in base al testo, al titolo. Se desideri continuare a fare una cover della canzone che hai caricato, puoi impostare il parametro action su upload_cover e inserire l’ID della canzone che desideri continuare a cantare, l’ID della canzone può essere ottenuto utilizzando Producer Upload API come mostrato nell’immagine seguente:

Puoi specificare il seguente contenuto:

action：l’azione di questo compito musicale, attualmente supporta: generate, cover, extend, upload_cover, upload_extend, replace_section, swap_vocals, swap_instrumentals, variation, questa cover utilizza il parametro cover.
lyric：testo della canzone
title：titolo della canzone.
custom：se utilizzare la modalità personalizzata per la generazione, predefinita è false.
audio_id：ID della canzone da coprire.

Esempio di compilazione:

Dopo aver completato la compilazione, il codice generato è il seguente:

Codice corrispondente:

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

Test consentito, l’effetto generato è simile.

{
  "success": true,
  "task_id": "dbca350e-6fb9-46ca-9c7e-4c1a9080806f",
  "trace_id": "a39e0fff-ced8-4b31-ae23-aef3badd90fa",
  "data": [
    {
      "id": "e52dd729-38b4-4c2f-9031-59eb7953c593",
      "title": "Copertura",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "lyric": "[Verso]\nMi sono svegliato con il sole negli occhi\nNessuna nuvola sopra, solo blu nel cielo\nScarpe ai piedi, sono pronto a correre\nOgni passo sembra una pistola carica\n[ ritornello]\nGiorni felici stanno arrivando\nLascia che la gioia sotto la mia pelle\nNiente più ombre, niente più bugie\nSolo la verità che mi solleva in alto\n[Verso 2]\nBallando per le strade della città\nUn ritmo che batte nel mio battito cardiaco\nGli sconosciuti sorridono, si sta diffondendo\nQuesto mondo è un palcoscenico, siamo tutti una canzone\n[ ritornello]\nGiorni felici stanno arrivando\nLascia che la gioia sotto la mia pelle\nNiente più ombre, niente più bugie\nSolo la verità che mi solleva in alto\n[Ponte]\nButta via le tue preoccupazioni\nLascia che affondino sul fondo dell'oceano\nSiamo vivi ed è abbastanza\nLa vita è disordinata ma è amore\n[ ritornello]\nGiorni felici stanno arrivando\nLascia che la gioia sotto la mia pelle\nNiente più ombre, niente più bugie\nSolo la verità che mi solleva in alto",
      "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"
    }
  ]
}

Continuare a scrivere la canzone

Se vuoi continuare a scrivere la canzone, dobbiamo passare il valore del parametro action come: extend, poi dobbiamo generare la canzone in base al testo, al titolo e allo stile. Se vuoi continuare a scrivere una canzone che hai caricato, puoi impostare il parametro action su upload_extend e inserire l’ID della canzone che desideri continuare a scrivere. L’ID della canzone può essere ottenuto utilizzando Producer Upload API come mostrato nell’immagine qui sotto:

Esempio di compilazione:

Dopo aver completato la compilazione, il codice generato automaticamente è il seguente:

Il codice corrispondente:

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": "[Verso]\nMi sono svegliato con il sole negli occhi\nNessuna nuvola sopra, solo blu nel cielo\nScarpe ai piedi, sono pronto a correre\nOgni passo sembra una pistola carica\n[ ritornello]\nGiorni felici stanno arrivando\nLascia che la gioia sotto la mia pelle\nNiente più ombre, niente più bugie\nSolo la verità che mi solleva in alto\n[Verso 2]\nBallando per le strade della città\nUn ritmo che batte nel mio battito cardiaco\nGli sconosciuti sorridono, si sta diffondendo\nQuesto mondo è un palcoscenico, siamo tutti una canzone\n[ ritornello]\nGiorni felici stanno arrivando\nLascia che la gioia sotto la mia pelle\nNiente più ombre, niente più bugie\nSolo la verità che mi solleva in alto\n[Ponte]\nButta via le tue preoccupazioni\nLascia che affondino sul fondo dell'oceano\nSiamo vivi ed è abbastanza\nLa vita è disordinata ma è amore\n[ ritornello]\nGiorni felici stanno arrivando\nLascia che la gioia sotto la mia pelle\nNiente più ombre, niente più bugie\nSolo la verità che mi solleva in alto",
  "continue_at": 3,
  "audio_id": "38d3b9e2-0dfb-4338-b2a7-15e45656ed32",
  "custom": true,
  "title": "Estendi",
  "weirdness": 0.3,
  "sound_strength": 0.3,
  "lyrics_strength": 0.6
}'

Test consentito, l’effetto generato è simile.

{
  "success": true,
  "task_id": "834983cb-d62d-4750-b1aa-461da137e51f",
  "trace_id": "6923eee2-7403-432c-8bd1-e471086385b0",
  "data": [
    {
      "id": "d9ebc609-fb65-4a23-b914-c074747af6a4",
      "title": "Estendi",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "lyric": "[Verso]\n[Verso]\nMi sono svegliato con il sole negli occhi\nNessuna nuvola sopra, solo blu nel cielo\nScarpe ai piedi, sono pronto a correre\nOgni passo sembra una pistola carica\n[ ritornello]\nGiorni felici stanno arrivando\nLascia che la gioia sotto la mia pelle\nNiente più ombre, niente più bugie\nSolo la verità che mi solleva in alto\n[Verso 2]\nBallando per le strade della città\nUn ritmo che batte nel mio battito cardiaco\nGli sconosciuti sorridono, si sta diffondendo\nQuesto mondo è un palcoscenico, siamo tutti una canzone\n[ ritornello]\nGiorni felici stanno arrivando\nLascia che la gioia sotto la mia pelle\nNiente più ombre, niente più bugie\nSolo la verità che mi solleva in alto\n[Ponte]\nButta via le tue preoccupazioni\nLascia che affondino sul fondo dell'oceano\nSiamo vivi ed è abbastanza\nLa vita è disordinata ma è amore\n[ ritornello]\nGiorni felici stanno arrivando\nLascia che la gioia sotto la mia pelle\nNiente più ombre, niente più bugie\nSolo la verità che mi solleva in alto",
      "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"
    }
  ]
}

Variazione musicale

Se vuoi generare una nuova musica con un effetto simile basata sul valore seed della musica precedente, dobbiamo passare il valore del parametro action come: variation, poi possiamo generare una nuova musica con un effetto simile. Esempio di compilazione:

Dopo aver completato la compilazione, il codice generato automaticamente è il seguente:

Il codice corrispondente:

curl -X POST 'https://api.acedata.cloud/producer/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "variazione",
  "audio_id": "d9ebc609-fb65-4a23-b914-c074747af6a4",
  "model": "FUZZ-2.0 Pro",
  "instrumental": false,
  "lyric": "[Verso]\nMi sono svegliato con il sole negli occhi\nNessuna nuvola sopra, solo blu nel cielo\nScarpe ai piedi, sono pronto a correre\nOgni passo sembra una pistola carica\n[ ritornello]\nGiorni felici stanno arrivando\nLascia che la gioia sotto la mia pelle\nNiente più ombre, niente più bugie\nSolo la verità che mi solleva in alto\n[Verso 2]\nBallando per le strade della città\nUn ritmo che batte nel mio cuore\nGli sconosciuti sorridono, si sta diffondendo\nQuesto mondo è un palcoscenico, siamo tutti una canzone\n[ ritornello]\nGiorni felici stanno arrivando\nLascia che la gioia sotto la mia pelle\nNiente più ombre, niente più bugie\nSolo la verità che mi solleva in alto\n[Ponte]\nButta via le tue preoccupazioni\nLascia che affondino sul fondo dell'oceano\nSiamo vivi ed è abbastanza\nLa vita è disordinata ma è amore\n[ ritornello]\nGiorni felici stanno arrivando\nLascia che la gioia sotto la mia pelle\nNiente più ombre, niente più bugie\nSolo la verità che mi solleva in alto",
  "custom": true
}'

{
    "success": true,
    "task_id": "3a74da6d-a37d-4b5d-b116-821f455bce39",
    "trace_id": "8e28cce0-0400-4bfd-83db-6d27f97422c7",
    "data": [
        {
            "id": "c14ca458-cd5a-4700-83d4-5249e15f2707",
            "title": "Mi sono svegliato con il sole negli occhi",
            "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
            "lyric": "[Verso]\nMi sono svegliato con il sole negli occhi\nNessuna nuvola sopra, solo blu nel cielo\nScarpe ai piedi, sono pronto a correre\nOgni passo sembra una pistola carica\n[ ritornello]\nGiorni felici stanno arrivando\nLascia che la gioia sotto la mia pelle\nNiente più ombre, niente più bugie\nSolo la verità che mi solleva in alto\n[Verso 2]\nBallando per le strade della città\nUn ritmo che batte nel mio cuore\nGli sconosciuti sorridono, si sta diffondendo\nQuesto mondo è un palcoscenico, siamo tutti una canzone\n[ ritornello]\nGiorni felici stanno arrivando\nLascia che la gioia sotto la mia pelle\nNiente più ombre, niente più bugie\nSolo la verità che mi solleva in alto\n[Ponte]\nButta via le tue preoccupazioni\nLascia che affondino sul fondo dell'oceano\nSiamo vivi ed è abbastanza\nLa vita è disordinata ma è amore\n[ ritornello]\nGiorni felici stanno arrivando\nLascia che la gioia sotto la mia pelle\nNiente più ombre, niente più bugie\nSolo la verità che mi solleva in alto",
            "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": "riuscito",
            "duration": "173.12798185941043"
        }
    ]
}

Sostituzione di sezioni

Se si desidera sostituire una sezione della canzone, è necessario passare il valore del parametro action come: replace_section, quindi dobbiamo personalizzare la canzone in base al testo, al titolo. Se si desidera continuare a sostituire una sezione della canzone caricata, è possibile impostare il parametro action su upload_replace_section e inserire l’ID della canzone caricata che si desidera continuare a scrivere. L’ID della canzone può essere ottenuto utilizzando Producer Upload API come mostrato nell’immagine sottostante:

Esempio di compilazione:

Dopo aver completato la compilazione, il codice generato sarà simile al seguente:

Codice corrispondente:

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": "[Verso]\\nMi sono svegliato con il sole negli occhi\\nNessuna nuvola sopra, solo blu nel cielo\\nScarpe ai piedi, sono pronto a correre\\nOgni passo sembra una pistola carica\\n[ ritornello]\\nGiorni felici stanno arrivando\\nLascia che la gioia sotto la mia pelle\\nNiente più ombre, niente più bugie\\nSolo la verità che mi solleva in alto\\n[Verso 2]\\nBallando per le strade della città\\nUn ritmo che batte nel mio cuore\\nGli sconosciuti sorridono, si sta diffondendo\\nQuesto mondo è un palcoscenico, siamo tutti una canzone\\n[ ritornello]\\nGiorni felici stanno arrivando\\nLascia che la gioia sotto la mia pelle\\nNiente più ombre, niente più bugie\\nSolo la verità che mi solleva in alto\\n[Ponte]\\nButta via le tue preoccupazioni\\nLascia che affondino sul fondo dell'oceano\\nSiamo vivi ed è abbastanza\\nLa vita è disordinata ma è amore\\n[ ritornello]\\nGiorni felici stanno arrivando\\nLascia che la gioia sotto la mia pelle\\nNiente più ombre, niente più bugie\\nSolo la verità che mi solleva in alto",
  "audio_id": "d9ebc609-fb65-4a23-b914-c074747af6a4",
  "replace_section_start": 3,
  "replace_section_end": 70,
  "custom": true
}'

Test consentito, l’effetto generato sarà simile.

{
    "success": true,
    "task_id": "3cb5ae96-01b0-4a37-afb0-e582608af56f",
    "trace_id": "3ebc6f63-5093-4499-bf9b-95c239e0da4f",
    "data": [
        {
            "id": "a54609c6-13e2-4176-be0f-4d7eebc68e1f",
            "title": "Mi sono svegliato con il sole negli occhi",
            "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
            "lyric": "[Verso]\\nMi sono svegliato con il sole negli occhi\\nNessuna nuvola sopra, solo blu nel cielo\\nScarpe ai piedi, sono pronto a correre\\nOgni passo sembra una pistola carica\\n[Coro]\\nGiorni felici stanno arrivando\\nLascia che la gioia sotto la mia pelle\\nNiente più ombre, niente più bugie\\nSolo la verità che mi solleva in alto\\n[Verso 2]\\nBallando per le strade della città\\nUn ritmo che batte nel mio cuore\\nGli sconosciuti sorridono, si sta diffondendo\\nQuesto mondo è un palcoscenico, siamo tutti una canzone\\n[Coro]\\nGiorni felici stanno arrivando\\nLascia che la gioia sotto la mia pelle\\nNiente più ombre, niente più bugie\\nSolo la verità che mi solleva in alto\\n[Ponte]\\nButta via le tue preoccupazioni\\nLascia che affondino sul fondo dell'oceano\\nSiamo vivi ed è abbastanza\\nLa vita è disordinata ma è amore\\n[Coro]\\nGiorni felici stanno arrivando\\nLascia che la gioia sotto la mia pelle\\nNiente più ombre, niente più bugie\\nSolo la verità che mi solleva in alto",
            "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"
        }
    ]
}

Versione strumentale

Se desideri utilizzare l’operazione di versione strumentale ufficiale, puoi impostare il valore del parametro action su: swap_instrumentals, successivamente dobbiamo generare una canzone personalizzata in base al testo, al titolo. Esempio di compilazione:

Dopo aver completato, il codice generato automaticamente è il seguente:

Codice corrispondente:

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": "Felice",
  "audio_id": "d9ebc609-fb65-4a23-b914-c074747af6a4"
}'

Test consentito, l’effetto generato è simile.

{
  "success": true,
  "task_id": "d17d8376-3a58-451d-a976-404719bac11d",
  "trace_id": "ab596807-910a-4e30-bae2-4647895f7d0b",
  "data": [
    {
      "id": "22d7d75c-9e0a-47a8-b22b-eea55eaa0c4b",
      "title": "Estendi (Scambio suono)",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "lyric": "[Verso]\nMi sono svegliato con il sole negli occhi\nNessuna nuvola sopra, solo blu nel cielo\nScarpe ai piedi, sono pronto a correre\nOgni passo sembra una pistola carica\n[Coro]\nGiorni felici stanno arrivando\nLascia che la gioia sotto la mia pelle\nNiente più ombre, niente più bugie\nSolo la verità che mi solleva in alto\n[Verso 2]\nBallando per le strade della città\nUn ritmo che batte nel mio cuore\nGli sconosciuti sorridono, si sta diffondendo\nQuesto mondo è un palcoscenico, siamo tutti una canzone\n[Coro]\nGiorni felici stanno arrivando\nLascia che la gioia sotto la mia pelle\nNiente più ombre, niente più bugie\nSolo la verità che mi solleva in alto\n[Ponte]\nButta via le tue preoccupazioni\nLascia che affondino sul fondo dell'oceano\nSiamo vivi ed è abbastanza\nLa vita è disordinata ma è amore\n[Coro]\nGiorni felici stanno arrivando\nLascia che la gioia sotto la mia pelle\nNiente più ombre, niente più bugie\nSolo la verità che mi solleva in alto",
      "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": "Felice",
      "created_at": "2025-12-30T18:09:49.594800Z",
      "model": "FUZZ-2.0 Pro",
      "progress": "100%",
      "state": "succeeded",
      "duration": "172.3849433106576"
    }
  ]
}

Versione vocale

Se desideri utilizzare l’operazione di versione vocale ufficiale, puoi impostare il valore del parametro action su: swap_vocals, successivamente dobbiamo generare una canzone personalizzata in base al testo, al titolo, allo stile. Esempio di compilazione:

Dopo aver completato, il codice generato automaticamente è il seguente:

Codice corrispondente:

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": "[Verso]\nMi sono svegliato con il sole negli occhi\nNessuna nuvola sopra, solo blu nel cielo\nScarpe ai piedi, sono pronto a correre\nOgni passo sembra una pistola carica\n[Coro]\nGiorni felici stanno arrivando\nLascia che la gioia sotto la mia pelle\nNiente più ombre, niente più bugie\nSolo la verità che mi solleva in alto\n[Verso 2]\nBallando per le strade della città\nUn ritmo che batte nel mio cuore\nGli sconosciuti sorridono, si sta diffondendo\nQuesto mondo è un palcoscenico, siamo tutti una canzone\n[Coro]\nGiorni felici stanno arrivando\nLascia che la gioia sotto la mia pelle\nNiente più ombre, niente più bugie\nSolo la verità che mi solleva in alto\n[Ponte]\nButta via le tue preoccupazioni\nLascia che affondino sul fondo dell'oceano\nSiamo vivi ed è abbastanza\nLa vita è disordinata ma è amore\n[Coro]\nGiorni felici stanno arrivando\nLascia che la gioia sotto la mia pelle\nNiente più ombre, niente più bugie\nSolo la verità che mi solleva in alto",
  "weirdness": 0.6,
  "lyrics_strength": 0.8,
  "audio_id": "d9ebc609-fb65-4a23-b914-c074747af6a4",
  "custom": true
}'

Test consentito, l’effetto generato è simile.

{
  "success": true,
  "task_id": "a903ac38-f129-4f85-9181-b1dc5579bd32",
  "trace_id": "9953af52-45e0-4808-bf13-88f0b21262c1",
  "data": [
    {
      "id": "7b2d653b-aaaa-41b0-b737-aee4c4c5693b",
      "title": "Mi sono svegliato con il sole negli occhi",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "lyric": "[Verso]\nMi sono svegliato con il sole negli occhi\nNessuna nuvola sopra, solo blu nel cielo\nScarpe ai piedi, sono pronto a correre\nOgni passo sembra una pistola carica\n[ ritornello ]\nGiorni felici stanno arrivando\nLascia che la gioia sotto la mia pelle\nNiente più ombre, niente più bugie\nSolo la verità che mi solleva in alto\n[Verso 2]\nBallando per le strade della città\nUn ritmo che batte nel mio cuore\nGli sconosciuti sorridono, si sta diffondendo\nQuesto mondo è un palcoscenico, siamo tutti una canzone\n[ ritornello ]\nGiorni felici stanno arrivando\nLascia che la gioia sotto la mia pelle\nNiente più ombre, niente più bugie\nSolo la verità che mi solleva in alto\n[Ponte]\nButta via le tue preoccupazioni\nLascia che affondino sul fondo dell'oceano\nSiamo vivi ed è abbastanza\nLa vita è disordinata ma è amore\n[ ritornello ]\nGiorni felici stanno arrivando\nLascia che la gioia sotto la mia pelle\nNiente più ombre, niente più bugie\nSolo la verità che mi solleva in alto",
      "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"
    }
  ]
}

Separazione di testo e musica

Se desideri utilizzare l’operazione ufficiale di separazione di testo e musica, puoi impostare il valore del parametro action su: stems, successivamente dobbiamo procedere alla separazione di testo e musica in base all’ID della canzone. Esempio di compilazione:

Una volta completato, il codice generato sarà il seguente:

Il codice corrispondente:

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

Il test è consentito, l’effetto generato è simile.

{
    "success": true,
    "task_id": "561ac695-b4aa-47cf-978d-fb7be2b9ebfc",
    "trace_id": "66d0d397-2987-4bde-84fb-a60d0023b217",
    "data": [
        {
            "title": "Mi sono svegliato con il sole negli occhi",
            "lyric": "",
            "stems_url": "https://platform.cdn.acedata.cloud/producer/561ac695-b4aa-47cf-978d-fb7be2b9ebfc.zip",
            "model": "",
            "progress": "100%",
            "state": "succeeded"
        }
    ]
}

Callback asincrona

Poiché il tempo di generazione dell’API Producer Audios può essere relativamente lungo, se l’API non risponde per un lungo periodo, la richiesta HTTP manterrà la connessione, causando un consumo aggiuntivo di risorse di sistema. Pertanto, questa API offre anche supporto per callback asincroni. Il flusso complessivo è: quando il client invia la richiesta, specifica un campo callback_url aggiuntivo. Dopo che il client ha inviato la richiesta API, l’API restituirà immediatamente un risultato, contenente un campo task_id, che rappresenta l’ID del compito corrente. Quando il compito è completato, il risultato del compito generato verrà inviato al callback_url specificato dal client in formato JSON POST, che include anche il campo task_id, in modo che il risultato del compito possa essere associato tramite l’ID. Di seguito, vediamo un esempio per capire come procedere. Innanzitutto, il callback Webhook è un servizio in grado di ricevere richieste HTTP, gli sviluppatori dovrebbero sostituirlo con l’URL del proprio server HTTP. Qui, per comodità di dimostrazione, utilizziamo un sito Web pubblico di esempio per Webhook https://webhook.site/, aprendo questo sito si ottiene un URL Webhook, come mostrato nell’immagine:

Copia questo URL e puoi usarlo come Webhook, l’esempio qui è https://webhook.site/#!/view/0d73431d-f833-4be4-9276-b6e1690d55c1. Successivamente, possiamo impostare il campo callback_url su questo URL Webhook, insieme ai parametri corrispondenti, il contenuto specifico è mostrato nell’immagine:

Cliccando su Esegui, possiamo notare che riceviamo immediatamente un risultato, come segue:

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

Dopo un momento, possiamo osservare il risultato del compito generato su https://webhook.site/#!/view/0d73431d-f833-4be4-9276-b6e1690d55c1, come mostrato nell’immagine:

Il contenuto è il seguente:

{
    "success": true,
    "task_id": "1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad",
    "trace_id": "1da03537-4eb8-410d-b849-43f03085a3bb",
    "data": [
        {
            "id": "1dd08826-478e-43a6-868f-aff5ababac2c",
            "title": "Mi sono svegliato con il sole negli occhi",
            "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
            "lyric": "[Verso]\nMi sono svegliato con il sole negli occhi\nNessuna nuvola sopra, solo blu nel cielo\nScarpe ai piedi, sono pronto a correre\nOgni passo sembra una pistola carica\n[ ritornello ]\nGiorni felici stanno arrivando\nLascia che la gioia sotto la mia pelle\nNiente più ombre, niente più bugie\nSolo la verità che mi solleva in alto\n[Verso 2]\nBallando per le strade della città\nUn ritmo che batte nel mio cuore\nGli sconosciuti sorridono, si sta diffondendo\nQuesto mondo è un palcoscenico, siamo tutti una canzone\n[ ritornello ]\nGiorni felici stanno arrivando\nLascia che la gioia sotto la mia pelle\nNiente più ombre, niente più bugie\nSolo la verità che mi solleva in alto\n[Ponte]\nButta via le tue preoccupazioni\nLascia che affondino sul fondo dell'oceano\nSiamo vivi ed è abbastanza\nLa vita è disordinata ma è amore\n[ ritornello ]\nGiorni felici stanno arrivando\nLascia che la gioia sotto la mia pelle\nNiente più ombre, niente più bugie\nSolo la verità che mi solleva in alto",
            "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"
        }
    ]
}

Si può vedere che nel risultato c’è un campo task_id, gli altri campi sono simili a quelli sopra, attraverso questo campo è possibile realizzare l’associazione del compito.

Gestione degli errori

Quando si chiama l’API, se si verifica un errore, l’API restituirà il codice di errore e le informazioni corrispondenti. Ad esempio:

400 token_mismatched: Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.
400 api_not_implemented: Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.
401 invalid_token: Non autorizzato, token di autorizzazione non valido o mancante.
429 too_many_requests: Troppe richieste, hai superato il limite di frequenza.
500 api_error: Errore interno del server, qualcosa è andato storto sul server.

Esempio di risposta di errore

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

Conclusione

Attraverso questo documento, hai compreso come utilizzare l’API di generazione di audio del produttore per generare musica tramite l’inserimento di parole chiave. Speriamo che questo documento possa aiutarti a integrare e utilizzare meglio questa API. Se hai domande, non esitare a contattare il nostro team di supporto tecnico.

Inizia

Chat AI

Immagine AI

Video AI

Audio AI

Web e Dati

CAPTCHA

Identità

Proxy

Avanzato

Coding

Producer Audios Generation API Integrazione Istruzioni

Procedura di richiesta

Utilizzo di base

Generazione personalizzata

Cover della canzone

Continuare a scrivere la canzone

Variazione musicale

Sostituzione di sezioni

Versione strumentale

Versione vocale

Separazione di testo e musica

Callback asincrona

Gestione degli errori

Esempio di risposta di errore

Conclusione

​Procedura di richiesta

​Utilizzo di base

​Generazione personalizzata

​Cover della canzone

​Continuare a scrivere la canzone

​Variazione musicale

​Sostituzione di sezioni

​Versione strumentale

​Versione vocale

​Separazione di testo e musica

​Callback asincrona

​Gestione degli errori

​Esempio di risposta di errore

​Conclusione

Procedura di richiesta

Utilizzo di base

Generazione personalizzata

Cover della canzone

Continuare a scrivere la canzone

Variazione musicale

Sostituzione di sezioni

Versione strumentale

Versione vocale

Separazione di testo e musica

Callback asincrona

Gestione degli errori

Esempio di risposta di errore

Conclusione