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.

Processo di richiesta

Per utilizzare l’API, è necessario prima andare alla pagina corrispondente dell’API di generazione degli audio del produttore per richiedere il servizio corrispondente. Una volta entrati nella pagina, fare clic sul pulsante “Acquire”, come mostrato nell’immagine:

Se non si è ancora effettuato il login o la registrazione, si verrà automaticamente reindirizzati alla pagina di accesso che invita a registrarsi e accedere. Dopo aver effettuato il login o la registrazione, si verrà automaticamente riportati alla pagina corrente. Alla prima richiesta, verrà offerto un credito gratuito, che consente di utilizzare gratuitamente questa API.

Utilizzo di base

Per generare canzoni, è possibile inserire liberamente un testo, ad esempio, se voglio generare una canzone sul Natale, posso inserire a song for Christmas, come mostrato nell’immagine:

Si può notare 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, per 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 o riprodurre.
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.
instrumental: se è in modalità senza testo.

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

Cliccando sul pulsante “Try” è possibile effettuare un test, come mostrato nell’immagine sopra, e 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://storage.googleapis.com/corpusant-app-public/riffs/a853673e-615c-42ae-bdff-16b1add94861/image/6c947f13-a3c5-4b9c-8609-5639c37cdc2d.jpg",
      "lyric": "[Instrumental]",
      "audio_url": "https://storage.googleapis.com/corpusant-app-public/riffs/a853673e-615c-42ae-bdff-16b1add94861/audio/6c947f13-a3c5-4b9c-8609-5639c37cdc2d.m4a",
      "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 attuale del compito di generazione musicale.
  - 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.

Si può notare che abbiamo ottenuto le informazioni sulla musica che desideriamo generare, e dobbiamo solo ottenere la musica del produttore generata dal link audio in data. Inoltre, se si desidera generare il codice di integrazione corrispondente, è possibile copiarlo direttamente, 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 si desidera generare testi personalizzati, è possibile inserire il testo: In questo caso, il campo lyric può contenere contenuti simili a:

[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, per generare una canzone personalizzata in base al testo, al titolo e allo stile, è possibile specificare i seguenti contenuti:

lyric: testo della canzone
custom: impostato su true, rappresenta la generazione personalizzata, questo parametro è impostato su false per impostazione predefinita, rappresenta la generazione tramite prompt.
title: il titolo della canzone. 填写样例如下：

填写完毕之后自动生成了代码如下：

对应的代码：

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]\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[Chorus]\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[Verse 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[Chorus]\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[Bridge]\nButta via le tue preoccupazioni\nLascia che affondino sul fondo dell'oceano\nSiamo vivi ed è abbastanza\nLa vita è disordinata ma è amore\n[Chorus]\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
}'

Testo 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": "Mi sono svegliato con il sole negli occhi",
      "image_url": "https://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/image/38d3b9e2-0dfb-4338-b2a7-15e45656ed32.jpg",
      "lyric": "[Verse]\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[Chorus]\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[Verse 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[Chorus]\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[Bridge]\nButta via le tue preoccupazioni\nLascia che affondino sul fondo dell'oceano\nSiamo vivi ed è abbastanza\nLa vita è disordinata ma è amore\n[Chorus]\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://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/audio/38d3b9e2-0dfb-4338-b2a7-15e45656ed32.m4a",
      "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 di canzoni

Se desideri effettuare un’operazione di cover su una canzone già generata, puoi inserire la canzone generata sopra per fare la cover, successivamente dobbiamo generare una canzone personalizzata in base al testo, al titolo. Se desideri continuare a fare la cover di una 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 sottostante:

Puoi specificare i seguenti contenuti:

action: il comportamento di questo compito musicale, attualmente supporta: generate, cover, extend, upload_cover, upload_extend, replace_section, swap_vocals, swap_instrumentals, variation, per questa cover utilizziamo il parametro cover.
lyric: testo della canzone
title: titolo della canzone.
custom: se utilizzare la modalità personalizzata per generare, di default è false.
audio_id: ID della canzone da coprire.

Esempio di compilazione:

Compilato, 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]\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[Chorus]\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[Verse 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[Chorus]\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[Bridge]\nButta via le tue preoccupazioni\nLascia che affondino sul fondo dell'oceano\nSiamo vivi ed è abbastanza\nLa vita è disordinata ma è amore\n[Chorus]\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": "38d3b9e2-0dfb-4338-b2a7-15e45656ed32",
  "instrumental": false,
  "custom": true,
  "title": "Cover"
}'

Testo 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": "Copertina",
      "image_url": "https://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/image/e52dd729-38b4-4c2f-9031-59eb7953c593.jpg",
      "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://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/audio/e52dd729-38b4-4c2f-9031-59eb7953c593.m4a",
      "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://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/image/d9ebc609-fb65-4a23-b914-c074747af6a4.jpg",
      "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://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/audio/d9ebc609-fb65-4a23-b914-c074747af6a4.m4a",
      "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 simile basata sul valore seed della musica precedente, dobbiamo passare il valore del parametro action come: variation, poi possiamo generare una nuova musica simile. Esempio di compilazione:

填写完毕 dopo automaticamente generato il codice 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": "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
}'

Test consentito, l’effetto generato è simile.

{
    "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://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/image/c14ca458-cd5a-4700-83d4-5249e15f2707.jpg",
            "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://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/audio/c14ca458-cd5a-4700-83d4-5249e15f2707.m4a",
            "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"
        }
    ]
}

Sostituzione di sezioni

Se si desidera sostituire una sezione della canzone, è necessario passare il valore del parametro action come: replace_section, successivamente dobbiamo generare la canzone in modo personalizzato in base al testo e al titolo. Se si desidera continuare a sostituire sezioni di una 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 seguente:

Esempio di compilazione:

Compilato automaticamente genera il codice 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": "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
}'

Test consentito, l’effetto generato è 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://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/image/a54609c6-13e2-4176-be0f-4d7eebc68e1f.jpg",
            "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://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/audio/a54609c6-13e2-4176-be0f-4d7eebc68e1f.m4a",
            "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://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/image/22d7d75c-9e0a-47a8-b22b-eea55eaa0c4b.jpg",
      "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://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/audio/22d7d75c-9e0a-47a8-b22b-eea55eaa0c4b.m4a",
      "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": "[Verse]\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[Chorus]\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[Verse 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[Chorus]\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[Bridge]\nButta via le tue preoccupazioni\nLascia che affondino sul fondo dell'oceano\nSiamo vivi ed è abbastanza\nLa vita è disordinata ma è amore\n[Chorus]\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
}'

测试允许，生成的效果是类似的。

{
  "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://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/image/7b2d653b-aaaa-41b0-b737-aee4c4c5693b.jpg",
      "lyric": "[Verse]\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[Chorus]\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[Verse 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[Chorus]\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[Bridge]\nButta via le tue preoccupazioni\nLascia che affondino sul fondo dell'oceano\nSiamo vivi ed è abbastanza\nLa vita è disordinata ma è amore\n[Chorus]\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://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/audio/7b2d653b-aaaa-41b0-b737-aee4c4c5693b.m4a",
      "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 testi e musica

Se si desidera utilizzare l’operazione ufficiale di separazione di testi e musica, è possibile impostare il valore del parametro action su: stems, successivamente dobbiamo procedere alla separazione di testi e musica in base all’ID 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": "stems",
  "audio_id": "a54609c6-13e2-4176-be0f-4d7eebc68e1f"
}'

测试允许，生成的效果是类似的。

{
    "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ò a volte 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, quindi questa API offre anche supporto per callback asincrone. Il flusso complessivo è: quando il client avvia la richiesta, specifica un campo callback_url aggiuntivo, dopo che il client ha avviato 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, attraverso un esempio, vediamo come procedere. Innanzitutto, il callback Webhook è un servizio in grado di ricevere richieste HTTP, gli sviluppatori dovrebbero sostituirlo con l’URL del server HTTP che hanno costruito. 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, mentre inseriamo i parametri corrispondenti, il contenuto specifico è mostrato nell’immagine:

Cliccando su Esegui, si può notare che si ottiene immediatamente un risultato, come segue:

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

稍等片刻，我们可以在 https://webhook.site/#!/view/0d73431d-f833-4be4-9276-b6e1690d55c1 上观察到生成任务的结果，如图所示：

内容如下：

{
    "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://storage.googleapis.com/corpusant-app-public/riffs/3bff6223-fe13-4bef-973e-2cbaef430d5d/image/1dd08826-478e-43a6-868f-aff5ababac2c.jpg",
            "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, è contagioso\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://storage.googleapis.com/corpusant-app-public/riffs/3bff6223-fe13-4bef-973e-2cbaef430d5d/audio/1dd08826-478e-43a6-868f-aff5ababac2c.m4a",
            "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"
        }
    ]
}

可以看到结果中有一个 task_id 字段，其他的字段都和上文类似，通过该字段即可实现任务的关联。

错误处理

在调用 API 时，如果遇到错误，API 会返回相应的错误代码和信息。例如：

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.

错误响应示例

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

结论

通过本文档，您已经了解了如何使用 Producer Audios Generation API 可通过输入提示词来生成音乐。希望本文档能帮助您更好地对接和使用该 API。如有任何问题，请随时联系我们的技术支持团队。

Inizia

AI Chat

AI Image

AI Video

AI Audio

Web & Data

CAPTCHA

Identity

Proxy

Avanzato

Producer Audios Generation API Integrazione Istruzioni

Processo di richiesta

Utilizzo di base

Generazione personalizzata

Cover di canzoni

Continuare a scrivere la canzone

Variazione musicale

Sostituzione di sezioni

Versione strumentale

Versione vocale

Separazione di testi e musica

Callback asincrona

错误处理

错误响应示例

结论

Inizia

AI Chat

AI Image

AI Video

AI Audio

Web & Data

CAPTCHA

Identity

Proxy

Avanzato

​Processo di richiesta

​Utilizzo di base

​Generazione personalizzata

​Cover di canzoni

​Continuare a scrivere la canzone

​Variazione musicale

​Sostituzione di sezioni

​Versione strumentale

​Versione vocale

​Separazione di testi e musica

​Callback asincrona

​错误处理

​错误响应示例

​结论

Processo di richiesta

Utilizzo di base

Generazione personalizzata

Cover di canzoni

Continuare a scrivere la canzone

Variazione musicale

Sostituzione di sezioni

Versione strumentale

Versione vocale

Separazione di testi e musica

Callback asincrona

错误处理

错误响应示例

结论