Producer Audios Generation API 연동 설명

본 문서에서는 Producer Audios Generation API 연동 설명을 소개합니다. 이 API는 사용자 정의 매개변수를 입력하여 Producer 공식 음악을 생성할 수 있습니다.

신청 절차

Producer Audios Generation API를 사용하려면 먼저 Ace Data Cloud 콘솔에서 API Token을 받아야 합니다. 이를 보관해 두세요.

로그인 또는 등록이 되어 있지 않으면 자동으로 로그인 페이지로 리디렉션되어 등록 및 로그인을 요청합니다. 완료 후 현재 페이지로 자동으로 돌아옵니다. 하나의 API Token으로 플랫폼의 모든 서비스를 호출할 수 있으며, 각 서비스마다 별도로 신청할 필요가 없습니다. 처음 신청 시 무료 할당량이 제공되어 무료로 체험할 수 있습니다. 할당량이 부족할 경우 콘솔에서 일반 잔액을 충전할 수 있습니다.

📘 전체 문서: Producer Audios Generation 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입니다.
async: 선택 사항으로, true로 설정하면 인터페이스가 즉시 task_id를 반환하며 callback_url을 제공할 필요가 없습니다. 이후 해당 작업 조회 인터페이스를 통해 결과를 폴링하여 얻을 수 있습니다.
instrumental: 가사가 없는 모드인지 여부입니다.

선택 후, 오른쪽에 해당 코드가 생성된 것을 확인할 수 있습니다. 아래 그림과 같이:

“Try” 버튼을 클릭하면 테스트를 진행할 수 있으며, 위 그림과 같이 다음과 같은 결과를 얻을 수 있습니다:

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

반환 결과는 여러 필드로 구성되어 있으며, 다음과 같이 설명할 수 있습니다:

success: 현재 음악 생성 작업의 상태입니다.
- data: 이번 음악 작업의 결과입니다.
  - id: 현재 음악 생성 작업의 ID입니다.
  - sound: 현재 음악 생성 작업의 힌트 단어입니다.
  - seed: 현재 음악 생성 작업의 시드 값입니다.
  - audio_url: 현재 음악 생성 작업의 오디오 링크입니다.
  - image_url: 현재 음악 생성 작업의 커버 링크입니다.
  - image_id: 현재 음악 생성 작업의 커버 ID입니다.
  - state: 현재 음악 생성 작업의 상태입니다.
  - duration: 현재 음악의 길이 정보입니다.
  - progress: 현재 음악 작업의 진행 값입니다.
  - model: 현재 음악 생성 작업에 사용된 모델 정보입니다.
  - lyric: 현재 음악 생성 작업의 가사 정보입니다.

우리는 생성하고자 하는 음악 정보를 얻었으며, 결과의 data에서 음악 링크 주소를 통해 생성된 Producer 음악을 얻을 수 있습니다. 또한, 해당 연동 코드를 생성하고 싶다면 직접 복사하여 생성할 수 있습니다. 예를 들어 CURL의 코드는 다음과 같습니다:

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

사용자 정의 생성

가사를 사용자 정의로 생성하고 싶다면 가사를 입력할 수 있습니다: 이때 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：노래 제목입니다.

입력 예시는 다음과 같습니다:

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

해당 코드:

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

테스트 허용, 생성된 효과는 유사합니다.

{
  "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://cdn.acedata.cloud/e724d7f13d.png",
      "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://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"
    }
  ]
}

커버 송

이미 생성된 노래를 커버하고 싶다면, 위에서 생성된 노래를 입력하여 커버할 수 있으며, 다음으로 가사와 제목에 따라 사용자 정의로 노래를 생성해야 합니다. 자신이 업로드한 노래를 계속 커버하고 싶다면, 매개변수 action을 upload_cover로 설정하고, 계속 커버할 노래의 ID를 입력하면 됩니다. 노래 ID는 Producer Upload API를 사용하여 얻을 수 있으며, 아래 그림과 같이 표시됩니다:

다음과 같은 내용을 지정할 수 있습니다:

action：이번 노래 작업의 행동으로, 현재 지원되는 값은: generate, cover, extend, upload_cover, upload_extend, replace_section, swap_vocals, swap_instrumentals, variation이며, 이번 커버는 cover 매개변수를 사용합니다.
lyric：가사 텍스트
title：노래 제목입니다.
custom：사용자 정의 모드 생성을 사용할지 여부, 기본값은 false입니다.
audio_id：커버할 노래의 ID입니다.

입력 예시는 다음과 같습니다:

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

해당 코드:

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

테스트 허용, 생성된 효과는 유사합니다.

{
  "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://cdn.acedata.cloud/e724d7f13d.png",
      "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://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"
    }
  ]
}

노래 이어쓰기

노래를 이어 쓰고 싶다면, action 매개변수의 값을 extend로 설정해야 하며, 그 다음 가사, 제목, 스타일에 따라 노래를 맞춤 생성해야 합니다. 자신이 업로드한 노래를 계속 이어 쓰고 싶다면, action 매개변수를 upload_extend로 설정하고, 이어 쓸 사용자 정의 업로드 노래 ID를 입력해야 합니다. 노래 ID는 Producer Upload API를 사용하여 얻을 수 있으며, 아래 그림과 같습니다:

입력 예시는 다음과 같습니다:

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

해당 코드:

curl -X POST 'https://api.acedata.cloud/producer/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "extend",
  "model": "FUZZ-2.0 Pro",
  "instrumental": false,
  "lyric": "[Verse]\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": "Extend",
  "weirdness": 0.3,
  "sound_strength": 0.3,
  "lyrics_strength": 0.6
}'

테스트 허용, 생성된 효과는 유사합니다.

{
  "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://cdn.acedata.cloud/e724d7f13d.png",
      "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://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"
    }
  ]
}

음악 변환

이전 음악의 seed 값을 기반으로 유사한 효과의 새로운 음악을 생성하고 싶다면, action 매개변수의 값을 variation으로 설정해야 하며, 그 다음 유사한 효과의 새로운 음악을 맞춤 생성할 수 있습니다. 입력 예시는 다음과 같습니다:

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

해당 코드:

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",
  "model": "FUZZ-2.0 Pro",
  "seed": "358803418",
  "custom": true
}'

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

테스트 허용, 생성된 효과는 비슷할 것입니다.

{
    "success": true,
    "task_id": "3a74da6d-a37d-4b5d-b116-821f455bce39",
    "trace_id": "8e28cce0-0400-4bfd-83db-6d27f97422c7",
    "data": [
        {
            "id": "c14ca458-cd5a-4700-83d4-5249e15f2707",
            "title": "햇살이 내 눈에 비치며 일어났어",
            "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
            "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://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": "succeeded",
            "duration": "173.12798185941043"
        }
    ]
}

교체 구간

노래의 구간을 교체하고 싶다면, action 매개변수 값을 replace_section으로 설정해야 하며, 그 다음 가사와 제목에 따라 노래를 사용자 정의하여 생성해야 합니다. 자신이 업로드한 노래를 계속 교체하고 싶다면, action 매개변수를 upload_replace_section으로 설정하고, 계속 작성할 사용자 정의 업로드 노래 ID를 입력해야 합니다. 노래 ID는 Producer Upload API를 사용하여 얻을 수 있으며, 아래 그림과 같습니다:

입력 예시는 다음과 같습니다:

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

해당 코드:

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

테스트 허용, 생성된 효과는 비슷할 것입니다.

{
    "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://cdn.acedata.cloud/e724d7f13d.png",
            "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://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"
        }
    ]
}

반주 변환

공식 반주 변환 작업을 사용하고 싶다면 action 매개변수 값을 swap_instrumentals로 설정하면 됩니다. 다음으로 우리는 가사와 제목에 따라 곡을 사용자 정의하여 생성할 것입니다. 작성 예시는 다음과 같습니다:

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

해당 코드:

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

테스트 허용, 생성된 효과는 유사합니다.

{
  "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://cdn.acedata.cloud/e724d7f13d.png",
      "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://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": "행복",
      "created_at": "2025-12-30T18:09:49.594800Z",
      "model": "FUZZ-2.0 Pro",
      "progress": "100%",
      "state": "succeeded",
      "duration": "172.3849433106576"
    }
  ]
}

보컬 변환

공식 보컬 변환 작업을 사용하고 싶다면 action 매개변수 값을 swap_vocals로 설정하면 됩니다. 다음으로 우리는 가사, 제목, 스타일에 따라 곡을 사용자 정의하여 생성할 것입니다. 작성 예시는 다음과 같습니다:

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

해당 코드:

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

테스트 허용, 생성된 효과는 유사합니다.

{
  "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://cdn.acedata.cloud/e724d7f13d.png",
      "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://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"
    }
  ]
}

곡과 가사 분리

공식적인 곡과 가사 분리 작업을 사용하고 싶다면 action 매개변수 값을 stems로 설정하면 됩니다. 다음으로 우리는 곡 ID에 따라 곡과 가사를 분리해야 합니다. 작성 예시는 다음과 같습니다:

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

해당 코드:

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": "햇살이 내 눈에 비치는 아침",
            "lyric": "",
            "stems_url": "https://platform.cdn.acedata.cloud/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/를 사용합니다. 해당 사이트를 열면 Webhook URL을 얻을 수 있습니다. 아래와 같이 표시됩니다:

이 URL을 복사하면 Webhook으로 사용할 수 있습니다. 여기서의 샘플은 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에서 생성된 작업의 결과를 확인할 수 있습니다. 아래와 같이 표시됩니다:

내용은 다음과 같습니다:

{
    "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://cdn.acedata.cloud/e724d7f13d.png",
            "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://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"
        }
    ]
}

결과에서 task_id 필드가 있으며, 다른 필드는 위와 유사하여 이 필드를 통해 작업을 연결할 수 있습니다.

오류 처리

API를 호출할 때 오류가 발생하면, API는 해당 오류 코드와 정보를 반환합니다. 예를 들어:

400 token_mismatched：잘못된 요청, 누락되었거나 잘못된 매개변수 때문일 수 있습니다.
400 api_not_implemented：잘못된 요청, 누락되었거나 잘못된 매개변수 때문일 수 있습니다.
401 invalid_token：권한 없음, 잘못되었거나 누락된 인증 토큰입니다.
429 too_many_requests：요청이 너무 많음, 비율 제한을 초과했습니다.
500 api_error：서버 내부 오류, 서버에서 문제가 발생했습니다.

오류 응답 예시

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "가져오기 실패"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

결론

이 문서를 통해 Producer Audios Generation API를 사용하여 입력 프롬프트를 통해 음악을 생성하는 방법을 이해하게 되었습니다. 이 문서가 API를 더 잘 연결하고 사용하는 데 도움이 되기를 바랍니다. 질문이 있으시면 언제든지 기술 지원 팀에 문의해 주십시오.

시작하기

AI 채팅

AI 이미지

AI 비디오

AI 오디오

웹 & 데이터

CAPTCHA

신원

프록시

고급

Coding

Producer Audios Generation API 연동 설명

신청 절차

기본 사용

사용자 정의 생성

커버 송

노래 이어쓰기

음악 변환

교체 구간

반주 변환

보컬 변환

곡과 가사 분리

비동기 콜백

오류 처리

오류 응답 예시

결론

​신청 절차

​기본 사용

​사용자 정의 생성

​커버 송

​노래 이어쓰기

​음악 변환

​교체 구간

​반주 변환

​보컬 변환

​곡과 가사 분리

​비동기 콜백

​오류 처리

​오류 응답 예시

​결론

신청 절차

기본 사용

사용자 정의 생성

커버 송

노래 이어쓰기

음악 변환

교체 구간

반주 변환

보컬 변환

곡과 가사 분리

비동기 콜백

오류 처리

오류 응답 예시

결론