> ## Documentation Index > Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt > Use this file to discover all available pages before exploring further. # Producer Tasks API의 대결 및 사용 > Producer Music Generation API guide - Ace Data Cloud Producer Tasks API의 주요 기능은 Producer Audios Generation API에서 생성된 작업 ID를 입력하여 해당 작업의 실행 상태를 조회하는 것입니다. 본 문서는 Producer Tasks API의 대결 설명을 자세히 소개하여 귀하가 이 API의 강력한 기능을 쉽게 통합하고 충분히 활용할 수 있도록 돕습니다. Producer Tasks API를 통해 Producer Audios Generation API의 작업 실행 상태를 쉽게 조회할 수 있습니다. ## 신청 절차 Producer Audios Generation API를 사용하려면 먼저 [Ace Data Cloud 콘솔](https://platform.acedata.cloud/console/applications)에서 API Token을 받아야 하며, 이를 보관해 두십시오. ![](https://cdn.acedata.cloud/dvc3cg.jpg) 로그인 또는 등록이 되어 있지 않은 경우 자동으로 로그인 페이지로 리디렉션되어 등록 및 로그인을 초대합니다. 완료 후 현재 페이지로 자동으로 돌아옵니다. **하나의 API Token으로 플랫폼의 모든 서비스를 호출할 수 있으며, 각 서비스마다 별도로 신청할 필요가 없습니다.** 최초 신청 시 무료 한도가 제공되어 무료로 체험할 수 있으며, 한도가 부족할 경우 [콘솔](https://platform.acedata.cloud/console/coin)에서 일반 잔액을 충전할 수 있습니다. > 📘 전체 문서: [Producer Audios Generation API →](https://platform.acedata.cloud/documents/producer-audios) ## 요청 예시 Producer Tasks API는 Producer Audios Generation API의 결과를 조회하는 데 사용할 수 있습니다. Producer Audios Generation API를 사용하는 방법에 대한 자세한 내용은 문서 [Producer Audios Generation API](https://platform.acedata.cloud/documents/producer-audios-integration)를 참조하십시오. 우리는 Producer Audios Generation API 서비스에서 반환된 작업 ID를 하나의 예로 사용하여 이 API를 사용하는 방법을 시연합니다. 가정해 보겠습니다. 작업 ID가: 1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad인 경우, 다음은 작업 ID를 전달하여 사용하는 방법입니다. ### 작업 예시 그림

### 요청 헤더 및 요청 본문 설정 **Request Headers**에는 다음이 포함됩니다: * `accept`: JSON 형식의 응답 결과를 수신하도록 지정하며, 여기서는 `application/json`으로 입력합니다. * `authorization`: API 호출에 필요한 키로, 신청 후 직접 드롭다운에서 선택할 수 있습니다. **Request Body**에는 다음이 포함됩니다: * `id`: 업로드된 작업 ID. * `action`: 작업의 조작 방식. 설정은 아래 그림과 같이 합니다:

### 코드 예시 페이지 오른쪽에는 다양한 언어의 코드가 자동으로 생성된 것을 확인할 수 있습니다. 아래 그림과 같습니다:

일부 코드 예시는 다음과 같습니다: #### CURL ```bash theme={null} curl -X POST 'https://api.acedata.cloud/producer/tasks' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "id": "1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad", "action": "retrieve" }' ``` ### 응답 예시 요청이 성공하면 API는 해당 작업의 세부 정보를 반환합니다. 예를 들어: ```json theme={null} { "_id": "69541b81ff2676299ccc3b29", "id": "1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad", "api_id": "01d96900-9f8c-41d7-814c-95c7a885ba61", "application_id": "920ba772-867a-48ae-8efa-9b9f94136199", "created_at": 1767119745.524, "started_at": 1767119745.584, "finished_at": 1767119785.589, "elapsed": 40.005, "credential_id": "eeae817d-d6ff-493e-8f88-6c62391da7c6", "request": { "action": "generate", "model": "FUZZ-2.0 Pro", "instrumental": false, "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high", "custom": true, "callback_url": "https://webhook.site/0d73431d-f833-4be4-9276-b6e1690d55c1" }, "trace_id": "1da03537-4eb8-410d-b849-43f03085a3bb", "type": "audios", "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf", "response": { "task_id": "1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad", "data": [ { "id": "1dd08826-478e-43a6-868f-aff5ababac2c", "title": "Woke up with the sun in my eyes", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": null, "image_id": "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" } ] } } ``` 반환 결과에는 여러 필드가 있으며, request 필드는 작업을 시작할 때의 request body이고, response 필드는 작업 완료 후 반환된 response body입니다. 필드 설명은 다음과 같습니다. * `id`，생성 작업의 ID로, 이번 생성 작업을 고유하게 식별하는 데 사용됩니다. * `request`，조회 작업의 요청 정보입니다. * `response`，조회 작업의 반환 정보입니다. * `created_at`，작업 생성 시간, Unix 타임스탬프(초, 부동 소수점). * `started_at`，작업 시작 실행 시간, Unix 타임스탬프(초, 부동 소수점). * `finished_at`，작업 완료 시간, Unix 타임스탬프(초, 부동 소수점). 작업이 완료되지 않은 경우 이 필드는 반환되지 않습니다. * `elapsed`，작업 실행 소요 시간, 단위는 초(부동 소수점, 소수점 3자리). 작업이 완료되지 않은 경우 이 필드는 반환되지 않습니다. ## 배치 조회 작업 여러 작업 ID에 대해 작업 세부 정보를 조회하는 것으로, 위와 다른 점은 action을 retrieve\_batch로 선택해야 한다는 것입니다. **Request Body**에는 다음이 포함됩니다: * `ids`：업로드된 작업 ID 배열입니다. * `action`：작업의 작업 방식입니다. 설정은 아래 그림과 같습니다:

### 코드 예시 페이지 오른쪽에서 다양한 언어의 코드가 자동으로 생성된 것을 확인할 수 있습니다, 아래 그림과 같습니다:

일부 코드 예시는 다음과 같습니다: ### 응답 예시 요청이 성공하면, API는 이번 모든 배치 작업의 구체적인 세부 정보를 반환합니다. 예를 들어: ```json { theme={null} "items": [ { "_id": "69541b81ff2676299ccc3b29", "id": "1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad", "api_id": "01d96900-9f8c-41d7-814c-95c7a885ba61", "application_id": "920ba772-867a-48ae-8efa-9b9f94136199", "created_at": 1767119745.524, "started_at": 1767119745.584, "finished_at": 1767119785.589, "elapsed": 40.005, "credential_id": "eeae817d-d6ff-493e-8f88-6c62391da7c6", "request": { "action": "generate", "model": "FUZZ-2.0 Pro", "instrumental": false, "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high", "custom": true, "callback_url": "https://webhook.site/0d73431d-f833-4be4-9276-b6e1690d55c1" }, "trace_id": "1da03537-4eb8-410d-b849-43f03085a3bb", "type": "audios", "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf", "response": { "task_id": "1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad", "data": [ { "id": "1dd08826-478e-43a6-868f-aff5ababac2c", "title": "Woke up with the sun in my eyes", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": null, "image_id": "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" } ] } }, { "_id": "69541b81ff2676299ccc3b29", "id": "1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad", "api_id": "01d96900-9f8c-41d7-814c-95c7a885ba61", "application_id": "920ba772-867a-48ae-8efa-9b9f94136199", "created_at": 1767119745.524, "started_at": 1767119745.584, "finished_at": 1767119785.589, "elapsed": 40.005, "credential_id": "eeae817d-d6ff-493e-8f88-6c62391da7c6", "request": { "action": "generate", "model": "FUZZ-2.0 Pro", "instrumental": false, "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high", "custom": true, "callback_url": "https://webhook.site/0d73431d-f833-4be4-9276-b6e1690d55c1" }, "trace_id": "1da03537-4eb8-410d-b849-43f03085a3bb", "type": "audios", "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf", "response": { "task_id": "1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad", "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" } ] } } ], "count": 2 } ``` 반환 결과는 여러 필드를 포함하고 있으며, items는 배치 작업의 구체적인 세부 정보를 포함하고 있습니다. 각 작업의 구체적인 정보는 위의 필드와 동일하며, 필드 정보는 다음과 같습니다. * `items`, 배치 작업의 모든 구체적인 세부 정보. 이는 배열이며, 각 배열의 요소는 위의 단일 작업 쿼리의 반환 결과 형식과 동일합니다. * `count`, 이곳에서 배치 쿼리 작업의 개수입니다. #### CURL ```bash theme={null} curl -X POST 'https://api.acedata.cloud/producer/tasks' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "ids": ["1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad","1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad"], "action": "retrieve_batch" }' ``` ## 오류 처리 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 Tasks API를 사용하여 단일 또는 배치 작업의 모든 구체적인 세부 정보를 쿼리하는 방법을 이해하게 되었습니다. 이 문서가 API를 더 잘 연결하고 사용하는 데 도움이 되기를 바랍니다. 질문이 있으시면 언제든지 기술 지원 팀에 문의해 주십시오.