Producer Tasks API 연동 및 사용

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 콘솔에서 API Token을 발급받아 예비용으로 보관하세요.

아직 로그인하거나 등록하지 않은 경우, 자동으로 로그인 페이지로 이동하여 등록 및 로그인을 안내하며, 완료 후 자동으로 현재 페이지로 돌아옵니다. 하나의 API Token으로 플랫폼의 모든 서비스를 호출할 수 있으며, 서비스별로 별도 신청할 필요가 없습니다. 최초 신청 시 무료 크레딧이 제공되어 무료로 체험할 수 있습니다. 크레딧이 부족한 경우 콘솔에서 공통 잔액을 충전할 수 있습니다.

📘 전체 문서: Producer Audios Generation API →

요청 예시

Producer Tasks API는 Producer Audios Generation API의 결과를 조회하는 데 사용할 수 있습니다. Producer Audios Generation API 사용 방법에 대해서는 문서 Producer Audios Generation API 를 참조하세요. 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

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는 여기의 작업 상세 정보를 반환합니다. 예를 들면 다음과 같습니다:

{
  "_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://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.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는 이번의 모든 일괄 작업에 대한 구체적인 상세 정보를 반환합니다. 예를 들면 다음과 같습니다:

  "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://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.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://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.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

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: 내부 서버 오류, 서버에서 문제가 발생했습니다.

오류 응답 예시

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

결론

이 문서를 통해 Producer Tasks API를 사용하여 단일 또는 일괄 작업의 모든 구체적인 상세 정보를 조회하는 방법을 이해하셨습니다. 이 문서가 해당 API를 더 잘 연동하고 사용하는 데 도움이 되기를 바랍니다. 문의 사항이 있으시면 언제든지 기술 지원 팀에 연락해 주세요.

시작하기

AI 채팅

AI 이미지

AI 비디오

AI 오디오

웹 & 데이터

CAPTCHA

신원

Coding

추가 가이드

Producer Tasks API 연동 및 사용

신청 절차

요청 예시

작업 예시 이미지

요청 헤더 및 요청 본문 설정

코드 예시

CURL

응답 예시

일괄 조회 작업

코드 예시

응답 예시

CURL

오류 처리

오류 응답 예시

결론

​신청 절차

​요청 예시

​작업 예시 이미지

​요청 헤더 및 요청 본문 설정

​코드 예시

​CURL

​응답 예시

​일괄 조회 작업

​코드 예시

​응답 예시

​CURL

​오류 처리

​오류 응답 예시

​결론

신청 절차

요청 예시

작업 예시 이미지

요청 헤더 및 요청 본문 설정

코드 예시

CURL

응답 예시

일괄 조회 작업

코드 예시

응답 예시

CURL

오류 처리

오류 응답 예시

결론