> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Producer Upload Reference Audio API Integration Instructions

> Producer Music Generation 集成指南 - XHuoAPI

O Producer nos permite fazer upload de áudio de referência para recriação. Este documento explica como integrar a API relacionada.

Esta API possui apenas um parâmetro de entrada, que é `audio_url`, que é um endereço CDN acessível publicamente, suportando a extensão mp3.

Aqui, o `audio_url` que inserimos é `https://cdn.xhuoapi.ai/suno_demo.mp3`, que é um endereço CDN acessível publicamente.

```bash theme={null}
curl -X POST 'https://api.xhuoapi.ai/v1/producer/upload' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "audio_url": "https://cdn.xhuoapi.ai/suno_demo.mp3"
}'
```

O resultado é o seguinte:

```
{
  "success": true,
  "task_id": "23e7d4ec-d1a8-429f-87d8-9f53fc3b6666",
  "data": {
    "audio_id": "d906da31-87cb-42f5-98df-2fc4969923b1",
    "lyric": "[Mandopop, Acoustic Pop]\n[Soft female vocals, bright and cheerful]\n\n[Verse 1]\n阳光洒在海边\n浪花笑得灿烂\n你和我在沙滩\n钟表停止转\n冰淇淋在融化\n手牵手去散步\n风儿轻轻吹过\n心跳不停跳\n\n[Chorus]\n夏天夏天\n时间停在这一天\n笑声回荡\n蔚蓝天空在身旁",
    "audio_url": "https://storage.googleapis.com/corpusant-app-public/producer/raw/d906da31-87cb-42f5-98df-2fc4969923b1.mp3"
  }
}
```

Pode-se ver que o campo `audio_id` em `data` é o ID da música após o upload.

Com o ID da música, podemos usar a [Producer Audios Generation API](https://api.xhuoapi.ai/documents/producer-audios-integration) para gerar músicas personalizadas, por exemplo, passando `action` como `upload_extend`, enquanto `audio_id` é o ID da música retornado, podemos gerar uma nova música com base no áudio de referência.