> ## 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 Audios Generation API 연동 설명 > Producer Music Generation 集成指南 - XHuoAPI 본 문서에서는 Producer Audios Generation API 연동 설명을 소개합니다. 이 API는 사용자 정의 매개변수를 입력하여 Producer 공식 음악을 생성할 수 있습니다. ## 신청 절차 API를 사용하려면 먼저 [Producer Audios Generation API](https://api.xhuoapi.ai/documents/producer-audios) 해당 페이지에서 서비스를 신청해야 합니다. 페이지에 들어가면 「Acquire」 버튼을 클릭합니다, 아래 그림과 같이: ![](https://cdn.xhuoapi.ai/q6ytrc.png) 로그인 또는 등록이 되어 있지 않으면 자동으로 로그인 페이지로 이동하여 등록 및 로그인을 초대합니다. 로그인 및 등록 후에는 자동으로 현재 페이지로 돌아옵니다. 첫 신청 시 무료 한도가 제공되어 해당 API를 무료로 사용할 수 있습니다. ## 기본 사용 생각하는 곡을 입력할 수 있으며, 예를 들어 크리스마스에 대한 곡을 생성하고 싶다면 `a song for Christmas`를 입력하면 됩니다, 아래 그림과 같이:

여기서 우리는 Request Headers를 설정했습니다, 포함된 내용은 다음과 같습니다: * `accept`：어떤 형식의 응답 결과를 받고 싶은지, 여기서는 `application/json`으로 JSON 형식으로 입력합니다. * `authorization`：API 호출을 위한 키, 신청 후 직접 드롭다운에서 선택할 수 있습니다. 또한 Request Body의 매개변수는 다음과 같습니다: * `action`：이번 음악 생성 작업의 행동, 곡 생성을 위해서는 `generate`입니다. * `model`：곡 생성을 위해 사용하는 모델, 현재 주요 모델은: **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`：곡의 가사 내용입니다. * `custom`：곡을 사용자 정의 방식으로 생성할지 여부입니다. * `prompt`：영감 모드에서의 힌트 단어입니다. * `title`：곡 제목 정보입니다. * `audio_id`：참조 곡 ID, 이어쓰기/복사 등의 작업에 사용됩니다. * `continue_at`：지정된 초에서 곡을 이어쓰기 시작합니다. * `replace_section_start`/`replace_section_end`：대체 구간의 시작 및 종료 시간, 단위는 초입니다. * `lyrics_strength`：가사 강도, 가사가 오디오 생성에 미치는 영향을 나타내며, 0-1 사이의 선택 가능, 기본값은 0.7입니다. * `sound_strength`：오디오 힌트 단어 강도, 0.2-1 사이의 선택 가능, 기본값은 0.7입니다. * `cover_strength`：커버 강도 0.2-1 사이, 기본값은 1입니다. * `weirdness`：스타일 특이도, 0-1 사이의 선택 가능, 기본값은 0.5입니다. * `callback_url`：결과를 회신받을 URL입니다. * `instrumental`：가사 없는 모드인지 여부입니다. 선택 후, 오른쪽에서도 해당 코드가 생성된 것을 확인할 수 있습니다, 아래 그림과 같이:

「Try」 버튼을 클릭하면 테스트를 진행할 수 있습니다, 위 그림과 같이, 우리는 다음과 같은 결과를 얻었습니다: ```json theme={null} { "success": true, "task_id": "82fd443a-903a-4f18-8028-12d2f8a0a4be", "trace_id": "d85839fa-0bb1-42da-a9fc-cd582c29027d", "data": [ { "id": "6c947f13-a3c5-4b9c-8609-5639c37cdc2d", "title": "Untitled", "image_url": "https://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" } ] } ``` 반환 결과는 여러 필드로 구성되어 있으며, 설명은 다음과 같습니다: * `success`，현재 음악 생성 작업의 상태입니다. * `data`，이번 음악 작업의 결과입니다. * `id`，현재 음악 생성 작업의 ID입니다. * `sound`，현재 음악 생성 작업의 힌트 단어입니다. * `seed`，현재 음악 생성 작업의 시드 값입니다. * `audio_url`，현재 음악 생성 작업의 오디오 링크입니다. * `image_url`，현재 음악 생성 작업의 커버 링크입니다. * `image_id`，현재 음악 생성 작업의 커버 ID입니다. * `state`，현재 음악 생성 작업의 상태입니다. * `duration`，현재 음악의 길이 정보입니다. * `progress`，현재 음악 작업의 진행 값입니다. * `model`，현재 음악 생성 작업에 사용된 모델 정보입니다. * `lyric`，현재 음악 생성 작업의 가사 정보입니다. 우리는 생성하고자 하는 음악 정보를 얻었으며, 결과의 `data`에서 음악 링크 주소를 통해 생성된 Producer 음악을 가져올 수 있습니다. 또한, 해당 연동 코드를 생성하고 싶다면 직접 복사하여 생성할 수 있습니다, 예를 들어 CURL의 코드는 다음과 같습니다: ```shell theme={null} curl -X POST 'https://api.xhuoapi.ai/v1/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" }' ``` ## 사용자 정의 생성 가사를 사용자 정의로 생성하고 싶다면 가사를 입력할 수 있습니다: 이때 `lyric` 필드에는 다음과 같은 내용을 전달할 수 있습니다: ``` [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 ``` 다음으로 우리는 가사, 제목, 스타일에 따라 사용자 정의로 곡을 생성할 수 있으며, 다음과 같은 내용을 지정할 수 있습니다: * lyric：가사 텍스트 * custom：`true`로 입력하여 사용자 정의 생성을 나타내며, 이 매개변수의 기본값은 false로 `prompt` 생성을 의미합니다. * title：곡의 제목입니다. 填写样例如下：

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

对应的代码： ```shell theme={null} curl -X POST 'https://api.xhuoapi.ai/v1/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]\n햇살이 내 눈에 들어와서 일어났어\n구름은 없고 하늘은 파래\n내 발에 신발을 신고 달릴 준비가 됐어\n모든 발걸음이 장전된 총처럼 느껴져\n[Chorus]\n행복한 날들이 다가오고 있어\n내 피부 아래 기쁨이 흐르고 있어\n더 이상 그림자도 거짓도 없어\n그저 나를 높이는 진실만 있어\n[Verse 2]\n도시 거리에서 춤추고 있어\n내 심장 박동에 리듬이 쿵쿵거려\n낯선 사람들이 미소를 지어\n이 세상은 무대, 우리는 모두 노래야\n[Chorus]\n행복한 날들이 다가오고 있어\n내 피부 아래 기쁨이 흐르고 있어\n더 이상 그림자도 거짓도 없어\n그저 나를 높이는 진실만 있어\n[Bridge]\n걱정을 문 밖으로 던져\n그것들이 바다 바닥으로 가라앉게 해\n우리는 살아있고 그게 충분해\n인생은 엉망이지만 사랑이야\n[Chorus]\n행복한 날들이 다가오고 있어\n내 피부 아래 기쁨이 흐르고 있어\n더 이상 그림자도 거짓도 없어\n그저 나를 높이는 진실만 있어", "custom": true }' ``` 테스트 허용, 생성된 효과는 비슷할 것입니다. ```json theme={null} { "success": true, "task_id": "9f58bbd4-855a-4233-ac45-b63bf9168e02", "trace_id": "145ad117-6ce7-42dd-af12-70751c5284fc", "data": [ { "id": "38d3b9e2-0dfb-4338-b2a7-15e45656ed32", "title": "햇살이 내 눈에 들어와서 일어났어", "image_url": "https://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/image/38d3b9e2-0dfb-4338-b2a7-15e45656ed32.jpg", "lyric": "[Verse]\n햇살이 내 눈에 들어와서 일어났어\n구름은 없고 하늘은 파래\n내 발에 신발을 신고 달릴 준비가 됐어\n모든 발걸음이 장전된 총처럼 느껴져\n[Chorus]\n행복한 날들이 다가오고 있어\n내 피부 아래 기쁨이 흐르고 있어\n더 이상 그림자도 거짓도 없어\n그저 나를 높이는 진실만 있어\n[Verse 2]\n도시 거리에서 춤추고 있어\n내 심장 박동에 리듬이 쿵쿵거려\n낯선 사람들이 미소를 지어\n이 세상은 무대, 우리는 모두 노래야\n[Chorus]\n행복한 날들이 다가오고 있어\n내 피부 아래 기쁨이 흐르고 있어\n더 이상 그림자도 거짓도 없어\n그저 나를 높이는 진실만 있어\n[Bridge]\n걱정을 문 밖으로 던져\n그것들이 바다 바닥으로 가라앉게 해\n우리는 살아있고 그게 충분해\n인생은 엉망이지만 사랑이야\n[Chorus]\n행복한 날들이 다가오고 있어\n내 피부 아래 기쁨이 흐르고 있어\n더 이상 그림자도 거짓도 없어\n그저 나를 높이는 진실만 있어", "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" } ] } ``` ## 번안 곡 이미 생성된 곡을 번안하고 싶다면, 위에서 생성된 곡을 입력하여 번안할 수 있습니다. 다음으로 우리는 가사와 제목에 따라 곡을 사용자 정의하여 생성해야 합니다. 자신이 업로드한 곡을 계속 번안하고 싶다면, 매개변수 `action`을 `upload_cover`로 설정하고, 계속 번안할 사용자 정의 업로드 곡 ID를 입력해야 합니다. 곡 ID는 [Producer Upload API](https://api.xhuoapi.ai/documents/7fd2cb52-772e-4cc4-a018-e2626ff6f447)를 사용하여 얻을 수 있으며, 아래 그림과 같이 지정할 수 있습니다:

다음과 같은 내용을 지정할 수 있습니다: * action: 이번 곡 작업의 행동, 현재 지원되는 것은: generate, cover, extend, upload\_cover, upload\_extend, replace\_section, swap\_vocals, swap\_instrumentals, variation, 이번 번안에서는 `cover` 매개변수를 사용합니다. * lyric: 가사 텍스트 * title: 곡의 제목. * custom: 사용자 정의 모드로 생성할지 여부, 기본값은 false입니다. * audio\_id: 번안할 곡의 곡 ID. 작성 예시는 다음과 같습니다:

작성 완료 후 자동 생성된 코드는 다음과 같습니다:

해당 코드: ```shell theme={null} curl -X POST 'https://api.xhuoapi.ai/v1/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]\n햇살이 내 눈에 들어와서 일어났어\n구름은 없고 하늘은 파래\n내 발에 신발을 신고 달릴 준비가 됐어\n모든 발걸음이 장전된 총처럼 느껴져\n[Chorus]\n행복한 날들이 다가오고 있어\n내 피부 아래 기쁨이 흐르고 있어\n더 이상 그림자도 거짓도 없어\n그저 나를 높이는 진실만 있어\n[Verse 2]\n도시 거리에서 춤추고 있어\n내 심장 박동에 리듬이 쿵쿵거려\n낯선 사람들이 미소를 지어\n이 세상은 무대, 우리는 모두 노래야\n[Chorus]\n행복한 날들이 다가오고 있어\n내 피부 아래 기쁨이 흐르고 있어\n더 이상 그림자도 거짓도 없어\n그저 나를 높이는 진실만 있어\n[Bridge]\n걱정을 문 밖으로 던져\n그것들이 바다 바닥으로 가라앉게 해\n우리는 살아있고 그게 충분해\n인생은 엉망이지만 사랑이야\n[Chorus]\n행복한 날들이 다가오고 있어\n내 피부 아래 기쁨이 흐르고 있어\n더 이상 그림자도 거짓도 없어\n그저 나를 높이는 진실만 있어", "audio_id": "38d3b9e2-0dfb-4338-b2a7-15e45656ed32", "instrumental": false, "custom": true, "title": "Cover" }' ``` 테스트 허용, 생성된 효과는 비슷할 것입니다. ```json theme={null} { "success": true, "task_id": "dbca350e-6fb9-46ca-9c7e-4c1a9080806f", "trace_id": "a39e0fff-ced8-4b31-ae23-aef3badd90fa", "data": [ { "id": "e52dd729-38b4-4c2f-9031-59eb7953c593", "title": "커버", "image_url": "https://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/image/e52dd729-38b4-4c2f-9031-59eb7953c593.jpg", "lyric": "[Verse]\n햇살이 내 눈에 비치며 일어났어\n구름은 없고 하늘은 파래\n내 발에 신발을 신고 달릴 준비가 됐어\n모든 발걸음이 장전된 총 같아\n[Chorus]\n행복한 날들이 다가오고 있어\n내 피부 아래 기쁨을 느껴\n더 이상 그림자도 거짓도 없어\n그저 나를 높이는 진실만 있어\n[Verse 2]\n도시 거리에서 춤추며\n내 심장 박동에 리듬이 뛰어\n낯선 사람들이 미소를 지어\n이 세상은 무대, 우리는 모두 노래야\n[Chorus]\n행복한 날들이 다가오고 있어\n내 피부 아래 기쁨을 느껴\n더 이상 그림자도 거짓도 없어\n그저 나를 높이는 진실만 있어\n[Bridge]\n걱정을 문 밖으로 던져\n그것들이 바다 바닥으로 가라앉게 해\n우리는 살아있고 그게 충분해\n인생은 엉망이지만 사랑이야\n[Chorus]\n행복한 날들이 다가오고 있어\n내 피부 아래 기쁨을 느껴\n더 이상 그림자도 거짓도 없어\n그저 나를 높이는 진실만 있어", "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" } ] } ``` ## 노래 이어쓰기 노래를 이어 쓰고 싶다면, `action` 매개변수의 값을 `extend`로 설정해야 하며, 그 다음 가사, 제목, 스타일에 따라 노래를 맞춤 생성해야 합니다. 자신이 업로드한 노래를 계속 이어 쓰고 싶다면, `action` 매개변수를 `upload_extend`로 설정하고, 이어 쓸 사용자 정의 업로드 노래 ID를 입력해야 합니다. 노래 ID는 [Producer Upload API](https://api.xhuoapi.ai/documents/7fd2cb52-772e-4cc4-a018-e2626ff6f447)를 사용하여 얻을 수 있으며, 아래 그림과 같습니다:

작성 예시는 다음과 같습니다:

작성 완료 후 자동으로 생성된 코드는 다음과 같습니다:

해당 코드: ```shell theme={null} curl -X POST 'https://api.xhuoapi.ai/v1/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]\n햇살이 내 눈에 비치며 일어났어\n구름은 없고 하늘은 파래\n내 발에 신발을 신고 달릴 준비가 됐어\n모든 발걸음이 장전된 총 같아\n[Chorus]\n행복한 날들이 다가오고 있어\n내 피부 아래 기쁨을 느껴\n더 이상 그림자도 거짓도 없어\n그저 나를 높이는 진실만 있어\n[Verse 2]\n도시 거리에서 춤추며\n내 심장 박동에 리듬이 뛰어\n낯선 사람들이 미소를 지어\n이 세상은 무대, 우리는 모두 노래야\n[Chorus]\n행복한 날들이 다가오고 있어\n내 피부 아래 기쁨을 느껴\n더 이상 그림자도 거짓도 없어\n그저 나를 높이는 진실만 있어\n[Bridge]\n걱정을 문 밖으로 던져\n그것들이 바다 바닥으로 가라앉게 해\n우리는 살아있고 그게 충분해\n인생은 엉망이지만 사랑이야\n[Chorus]\n행복한 날들이 다가오고 있어\n내 피부 아래 기쁨을 느껴\n더 이상 그림자도 거짓도 없어\n그저 나를 높이는 진실만 있어", "continue_at": 3, "audio_id": "38d3b9e2-0dfb-4338-b2a7-15e45656ed32", "custom": true, "title": "확장", "weirdness": 0.3, "sound_strength": 0.3, "lyrics_strength": 0.6 }' ``` 테스트 허용, 생성된 효과는 유사합니다. ```json theme={null} { "success": true, "task_id": "834983cb-d62d-4750-b1aa-461da137e51f", "trace_id": "6923eee2-7403-432c-8bd1-e471086385b0", "data": [ { "id": "d9ebc609-fb65-4a23-b914-c074747af6a4", "title": "확장", "image_url": "https://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/image/d9ebc609-fb65-4a23-b914-c074747af6a4.jpg", "lyric": "[Verse]\n[Verse]\n햇살이 내 눈에 비치며 일어났어\n구름은 없고 하늘은 파래\n내 발에 신발을 신고 달릴 준비가 됐어\n모든 발걸음이 장전된 총 같아\n[Chorus]\n행복한 날들이 다가오고 있어\n내 피부 아래 기쁨을 느껴\n더 이상 그림자도 거짓도 없어\n그저 나를 높이는 진실만 있어\n[Verse 2]\n도시 거리에서 춤추며\n내 심장 박동에 리듬이 뛰어\n낯선 사람들이 미소를 지어\n이 세상은 무대, 우리는 모두 노래야\n[Chorus]\n행복한 날들이 다가오고 있어\n내 피부 아래 기쁨을 느껴\n더 이상 그림자도 거짓도 없어\n그저 나를 높이는 진실만 있어\n[Bridge]\n걱정을 문 밖으로 던져\n그것들이 바다 바닥으로 가라앉게 해\n우리는 살아있고 그게 충분해\n인생은 엉망이지만 사랑이야\n[Chorus]\n행복한 날들이 다가오고 있어\n내 피부 아래 기쁨을 느껴\n더 이상 그림자도 거짓도 없어\n그저 나를 높이는 진실만 있어", "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" } ] } ``` ## 음악 변환 이전 곡의 seed 값을 기반으로 유사한 효과의 새로운 음악을 생성하고 싶다면, `action` 매개변수의 값을 `variation`으로 설정해야 하며, 그 다음 유사한 효과의 새로운 음악을 맞춤 생성할 수 있습니다. 작성 예시는 다음과 같습니다:

작성 완료 후 자동 생성된 코드는 다음과 같습니다:

해당 코드: ```shell theme={null} curl -X POST 'https://api.xhuoapi.ai/v1/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 }' ``` 테스트 허용, 생성된 효과는 유사합니다. ```json theme={null} { "success": true, "task_id": "3a74da6d-a37d-4b5d-b116-821f455bce39", "trace_id": "8e28cce0-0400-4bfd-83db-6d27f97422c7", "data": [ { "id": "c14ca458-cd5a-4700-83d4-5249e15f2707", "title": "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" } ] } ``` ## 교체 구간 노래의 구간을 교체하고 싶다면, `action` 매개변수 값을 `replace_section`으로 설정해야 하며, 그 다음 가사와 제목에 따라 노래를 사용자 정의 생성해야 합니다. 자신이 업로드한 노래를 계속 교체하고 싶다면, 매개변수 `action`을 `upload_replace_section`으로 설정하고, 계속 작성할 사용자 정의 업로드 노래 ID를 입력해야 합니다. 노래 ID는 [Producer Upload API](https://api.xhuoapi.ai/documents/7fd2cb52-772e-4cc4-a018-e2626ff6f447)를 사용하여 가져올 수 있으며, 아래 그림과 같습니다:

작성 예시는 다음과 같습니다:

작성 완료 후 자동 생성된 코드는 다음과 같습니다:

해당 코드: ```shell theme={null} curl -X POST 'https://api.xhuoapi.ai/v1/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 }' ``` 테스트 허용, 생성된 효과는 유사합니다. ```json theme={null} { "success": true, "task_id": "3cb5ae96-01b0-4a37-afb0-e582608af56f", "trace_id": "3ebc6f63-5093-4499-bf9b-95c239e0da4f", "data": [ { "id": "a54609c6-13e2-4176-be0f-4d7eebc68e1f", "title": "햇살이 내 눈에 비치며 깨어났어", "image_url": "https://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/image/a54609c6-13e2-4176-be0f-4d7eebc68e1f.jpg", "lyric": "[Verse]\\n햇살이 내 눈에 비치며 깨어났어\\n구름은 없고 하늘은 파래\\n내 발에 신발을 신고 달릴 준비가 됐어\\n모든 발걸음이 장전된 총 같아\\n[Chorus]\\n행복한 날들이 다가오고 있어\\n내 피부 아래 기쁨을 느껴\\n더 이상 그림자도 거짓도 없어\\n그저 나를 높여주는 진실뿐\\n[Verse 2]\\n도시 거리를 춤추며 지나가\\n내 심장 박동에 리듬이 쿵쿵 울려\\n낯선 사람들이 미소를 지어\\n이 세상은 무대, 우리는 모두 노래야\\n[Chorus]\\n행복한 날들이 다가오고 있어\\n내 피부 아래 기쁨을 느껴\\n더 이상 그림자도 거짓도 없어\\n그저 나를 높여주는 진실뿐\\n[Bridge]\\n걱정을 문 밖으로 던져버려\\n그것들이 바다 바닥으로 가라앉게 해\\n우리는 살아있고 그게 충분해\\n인생은 엉망이지만 사랑이야\\n[Chorus]\\n행복한 날들이 다가오고 있어\\n내 피부 아래 기쁨을 느껴\\n더 이상 그림자도 거짓도 없어\\n그저 나를 높여주는 진실뿐", "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" } ] } ``` ## 반주 변환 공식 반주 변환 작업을 사용하고 싶다면 `action` 매개변수 값을 `swap_instrumentals`로 설정하면 됩니다. 다음으로 우리는 가사와 제목에 따라 곡을 사용자 정의 생성할 것입니다. 작성 예시는 다음과 같습니다:

작성 완료 후 자동 생성된 코드는 다음과 같습니다:

해당 코드: ```shell theme={null} curl -X POST 'https://api.xhuoapi.ai/v1/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": "행복", "audio_id": "d9ebc609-fb65-4a23-b914-c074747af6a4" }' ``` 테스트 허용, 생성된 효과는 유사합니다. ```json theme={null} { "success": true, "task_id": "d17d8376-3a58-451d-a976-404719bac11d", "trace_id": "ab596807-910a-4e30-bae2-4647895f7d0b", "data": [ { "id": "22d7d75c-9e0a-47a8-b22b-eea55eaa0c4b", "title": "확장 (사운드 교체)", "image_url": "https://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/image/22d7d75c-9e0a-47a8-b22b-eea55eaa0c4b.jpg", "lyric": "[Verse]\n햇살이 내 눈에 비치며 깨어났어\n구름은 없고 하늘은 파래\n내 발에 신발을 신고 달릴 준비가 됐어\n모든 발걸음이 장전된 총 같아\n[Chorus]\n행복한 날들이 다가오고 있어\n내 피부 아래 기쁨을 느껴\n더 이상 그림자도 거짓도 없어\n그저 나를 높여주는 진실뿐\n[Verse 2]\n도시 거리를 춤추며 지나가\n내 심장 박동에 리듬이 쿵쿵 울려\n낯선 사람들이 미소를 지어\n이 세상은 무대, 우리는 모두 노래야\n[Chorus]\n행복한 날들이 다가오고 있어\n내 피부 아래 기쁨을 느껴\n더 이상 그림자도 거짓도 없어\n그저 나를 높여주는 진실뿐\n[Bridge]\n걱정을 문 밖으로 던져버려\n그것들이 바다 바닥으로 가라앉게 해\n우리는 살아있고 그게 충분해\n인생은 엉망이지만 사랑이야\n[Chorus]\n행복한 날들이 다가오고 있어\n내 피부 아래 기쁨을 느껴\n더 이상 그림자도 거짓도 없어\n그저 나를 높여주는 진실뿐", "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": "행복", "created_at": "2025-12-30T18:09:49.594800Z", "model": "FUZZ-2.0 Pro", "progress": "100%", "state": "succeeded", "duration": "172.3849433106576" } ] } ``` ## 보컬 변환 공식 보컬 변환 작업을 사용하고 싶다면 `action` 매개변수 값을 `swap_vocals`로 설정하면 됩니다. 다음으로 우리는 가사, 제목, 스타일에 따라 곡을 사용자 정의 생성할 것입니다. 작성 예시는 다음과 같습니다:

작성 완료 후 자동 생성된 코드는 다음과 같습니다:

해당 코드: ```shell theme={null} curl -X POST 'https://api.xhuoapi.ai/v1/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]\n햇살이 내 눈에 비치며 일어났어\n구름은 없고 하늘은 파래\n내 발에 신발을 신고 달릴 준비가 됐어\n모든 발걸음이 장전된 총처럼 느껴져\n[Chorus]\n행복한 날들이 다가오고 있어\n내 피부 아래 기쁨을 느껴\n더 이상 그림자도 거짓도 없어\n그저 나를 높여주는 진실뿐이야\n[Verse 2]\n도시 거리를 춤추며 지나가\n내 심장 박동에 리듬이 쿵쿵 울려\n낯선 사람들이 미소를 지어\n이 세상은 무대, 우리는 모두 노래야\n[Chorus]\n행복한 날들이 다가오고 있어\n내 피부 아래 기쁨을 느껴\n더 이상 그림자도 거짓도 없어\n그저 나를 높여주는 진실뿐이야\n[Bridge]\n걱정을 문 밖으로 던져\n그것들이 바다 바닥으로 가라앉게 해\n우리는 살아있고 그게 충분해\n인생은 엉망이지만 사랑이야\n[Chorus]\n행복한 날들이 다가오고 있어\n내 피부 아래 기쁨을 느껴\n더 이상 그림자도 거짓도 없어\n그저 나를 높여주는 진실뿐이야", "weirdness": 0.6, "lyrics_strength": 0.8, "audio_id": "d9ebc609-fb65-4a23-b914-c074747af6a4", "custom": true }' ``` 테스트 허용, 생성된 효과는 유사합니다. ```json theme={null} { "success": true, "task_id": "a903ac38-f129-4f85-9181-b1dc5579bd32", "trace_id": "9953af52-45e0-4808-bf13-88f0b21262c1", "data": [ { "id": "7b2d653b-aaaa-41b0-b737-aee4c4c5693b", "title": "햇살이 내 눈에 비치며 일어났어", "image_url": "https://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/image/7b2d653b-aaaa-41b0-b737-aee4c4c5693b.jpg", "lyric": "[Verse]\n햇살이 내 눈에 비치며 일어났어\n구름은 없고 하늘은 파래\n내 발에 신발을 신고 달릴 준비가 됐어\n모든 발걸음이 장전된 총처럼 느껴져\n[Chorus]\n행복한 날들이 다가오고 있어\n내 피부 아래 기쁨을 느껴\n더 이상 그림자도 거짓도 없어\n그저 나를 높여주는 진실뿐이야\n[Verse 2]\n도시 거리를 춤추며 지나가\n내 심장 박동에 리듬이 쿵쿵 울려\n낯선 사람들이 미소를 지어\n이 세상은 무대, 우리는 모두 노래야\n[Chorus]\n행복한 날들이 다가오고 있어\n내 피부 아래 기쁨을 느껴\n더 이상 그림자도 거짓도 없어\n그저 나를 높여주는 진실뿐이야\n[Bridge]\n걱정을 문 밖으로 던져\n그것들이 바다 바닥으로 가라앉게 해\n우리는 살아있고 그게 충분해\n인생은 엉망이지만 사랑이야\n[Chorus]\n행복한 날들이 다가오고 있어\n내 피부 아래 기쁨을 느껴\n더 이상 그림자도 거짓도 없어\n그저 나를 높여주는 진실뿐이야", "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" } ] } ``` ## 가사와 곡 분리 공식적인 가사와 곡 분리 작업을 사용하고 싶다면 `action` 매개변수 값을 `stems`로 설정하면 됩니다. 다음으로 우리는 곡 ID에 따라 가사와 곡을 분리해야 합니다. 작성 예시는 다음과 같습니다:

작성 완료 후 자동으로 생성된 코드는 다음과 같습니다:

해당 코드: ```shell theme={null} curl -X POST 'https://api.xhuoapi.ai/v1/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" }' ``` 테스트 허용, 생성된 효과는 유사합니다. ```json theme={null} { "success": true, "task_id": "561ac695-b4aa-47cf-978d-fb7be2b9ebfc", "trace_id": "66d0d397-2987-4bde-84fb-a60d0023b217", "data": [ { "title": "햇살이 내 눈에 비치며 일어났어", "lyric": "", "stems_url": "https://platform.cdn.xhuoapi.ai/producer/561ac695-b4aa-47cf-978d-fb7be2b9ebfc.zip", "model": "", "progress": "100%", "state": "succeeded" } ] } ``` ## 비동기 콜백 Producer Audios Generation API의 생성 시간이 때때로 상대적으로 길어질 수 있으므로, API가 오랜 시간 동안 응답하지 않으면 HTTP 요청이 연결을 유지하여 추가 시스템 자원 소모를 초래할 수 있습니다. 따라서 이 API는 비동기 콜백 지원도 제공합니다. 전체 프로세스는 클라이언트가 요청을 시작할 때 추가로 `callback_url` 필드를 지정하는 것입니다. 클라이언트가 API 요청을 시작한 후, API는 즉시 결과를 반환하며, 현재 작업 ID를 나타내는 `task_id` 필드 정보를 포함합니다. 작업이 완료되면 생성된 작업 결과가 POST JSON 형식으로 클라이언트가 지정한 `callback_url`로 전송되며, 여기에도 `task_id` 필드가 포함되어 있어 작업 결과를 ID로 연결할 수 있습니다. 아래 예제를 통해 구체적으로 어떻게 작업하는지 알아보겠습니다. 먼저, Webhook 콜백은 HTTP 요청을 수신할 수 있는 서비스로, 개발자는 자신이 구축한 HTTP 서버의 URL로 교체해야 합니다. 여기서는 편리한 시연을 위해 공개 Webhook 샘플 사이트 [https://webhook.site/](https://webhook.site/)를 사용합니다. 해당 사이트를 열면 Webhook URL을 얻을 수 있습니다. 아래와 같이: ![](https://cdn.xhuoapi.ai/tbcnai.png) 이 URL을 복사하여 Webhook으로 사용할 수 있으며, 여기서의 샘플은 [https://webhook.site/#!/view/0d73431d-f833-4be4-9276-b6e1690d55c1](https://webhook.site/#!/view/0d73431d-f833-4be4-9276-b6e1690d55c1)입니다. 다음으로, `callback_url` 필드를 위의 Webhook URL로 설정하고, 해당 매개변수를 입력합니다. 구체적인 내용은 아래와 같습니다:

실행 버튼을 클릭하면 즉시 다음과 같은 결과를 얻을 수 있습니다: ``` { "task_id": "1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad" } ``` 잠시 기다려 주십시오. 우리는 [https://webhook.site/#!/view/0d73431d-f833-4be4-9276-b6e1690d55c1](https://webhook.site/#!/view/0d73431d-f833-4be4-9276-b6e1690d55c1)에서 생성 작업의 결과를 관찰할 수 있습니다. 아래와 같이: ![](https://cdn.xhuoapi.ai/k0kf0y.png) 내용은 다음과 같습니다: ```json theme={null} { "success": true, "task_id": "1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad", "trace_id": "1da03537-4eb8-410d-b849-43f03085a3bb", "data": [ { "id": "1dd08826-478e-43a6-868f-aff5ababac2c", "title": "햇살이 내 눈에 비치며 깨어났어요", "image_url": "https://storage.googleapis.com/corpusant-app-public/riffs/3bff6223-fe13-4bef-973e-2cbaef430d5d/image/1dd08826-478e-43a6-868f-aff5ababac2c.jpg", "lyric": "[Verse]\n햇살이 내 눈에 비치며 깨어났어요\n구름은 없고 하늘은 파랗고\n발에 신발을 신고 달릴 준비가 되었어요\n모든 발걸음이 장전된 총처럼 느껴져요\n[Chorus]\n행복한 날들이 다가오고 있어요\n내 피부 아래 기쁨이 흐르고 있어요\n더 이상 그림자도 거짓도 없어요\n그저 나를 높여주는 진실만 있어요\n[Verse 2]\n도시 거리에서 춤추며\n내 심장 박동에 리듬이 울려요\n낯선 사람들이 미소를 지어요, 전염되고 있어요\n이 세상은 무대, 우리는 모두 노래예요\n[Chorus]\n행복한 날들이 다가오고 있어요\n내 피부 아래 기쁨이 흐르고 있어요\n더 이상 그림자도 거짓도 없어요\n그저 나를 높여주는 진실만 있어요\n[Bridge]\n걱정을 문 밖으로 던져버려요\n그것들이 바다 바닥으로 가라앉게 해요\n우리는 살아있고 그게 충분해요\n인생은 엉망이지만 사랑이에요\n[Chorus]\n행복한 날들이 다가오고 있어요\n내 피부 아래 기쁨이 흐르고 있어요\n더 이상 그림자도 거짓도 없어요\n그저 나를 높여주는 진실만 있어요", "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`：잘못된 요청, 누락되었거나 잘못된 매개변수 때문일 수 있습니다. * `400 api_not_implemented`：잘못된 요청, 누락되었거나 잘못된 매개변수 때문일 수 있습니다. * `401 invalid_token`：권한 없음, 잘못되었거나 누락된 인증 토큰입니다. * `429 too_many_requests`：요청이 너무 많습니다. 비율 한도를 초과했습니다. * `500 api_error`：내부 서버 오류, 서버에서 문제가 발생했습니다. ### 오류 응답 예시 ```json theme={null} { "success": false, "error": { "code": "api_error", "message": "fetch failed" }, "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89" } ``` ## 결론 이 문서를 통해, Producer Audios Generation API를 사용하여 입력 프롬프트를 통해 음악을 생성하는 방법을 이해하셨습니다. 이 문서가 API를 더 잘 연결하고 사용하는 데 도움이 되기를 바랍니다. 질문이 있으시면 언제든지 기술 지원 팀에 문의해 주십시오.