Інтеграція та використання Producer Tasks API

Основна функція Producer Tasks API полягає в запиті статусу виконання завдання шляхом введення ID завдання, згенерованого Producer Audios Generation API. У цьому документі буде детально представлено інструкції з інтеграції 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 。 Ми візьмемо як приклад один ID завдання, повернений сервісом Producer Audios Generation API, щоб продемонструвати, як використовувати цей 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 timestamp (секунди, з плаваючою комою).
started_at，час початку виконання завдання, Unix timestamp (секунди, з плаваючою комою).
finished_at，час завершення завдання, Unix timestamp (секунди, з плаваючою комою). Це поле не повертається, коли завдання не завершено.
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": "[Куплет]\nПрокинувся з сонцем в очах\nЖодної хмари над головою, лише блакить у небесах\nВзуття на ногах, я готовий бігти\nКожен крок відчувається як заряджена рушниця\n[Приспів]\nЩасливі дні насуваються\nНехай радість буде під моєю шкірою\nБільше ніяких тіней, більше ніякої брехні\nЛише правда, що підносить мене високо\n[Куплет 2]\nТанцюючи міськими вулицями\nРитм гупає в моєму серцебитті\nНезнайомці посміхаються, це передається\nЦей світ — сцена, ми всі — пісня\n[Приспів]\nЩасливі дні насуваються\nНехай радість буде під моєю шкірою\nБільше ніяких тіней, більше ніякої брехні\nЛише правда, що підносить мене високо\n[Бридж]\nВикинь свої турботи за двері\nНехай вони опустяться на дно океану\nМи живі, і цього достатньо\nЖиття безладне, але це любов\n[Приспів]\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. Якщо у вас виникнуть будь-які запитання, будь ласка, звертайтеся до нашої команди технічної підтримки.

Getting Started

AI Чат

AI Зображення

AI Відео

AI Аудіо

Веб і дані

CAPTCHA

Ідентичність

Coding

Інші посібники

Інтеграція та використання Producer Tasks API

Процес подання заявки

Приклад запиту

Зображення прикладу завдання

Налаштування заголовків запиту та тіла запиту

Приклад коду

CURL

Приклад відповіді

Операція пакетного запиту

Приклад коду

Приклад відповіді

CURL

Обробка помилок

Приклад відповіді з помилкою

Висновок

​Процес подання заявки

​Приклад запиту

​Зображення прикладу завдання

​Налаштування заголовків запиту та тіла запиту

​Приклад коду

​CURL

​Приклад відповіді

​Операція пакетного запиту

​Приклад коду

​Приклад відповіді

​CURL

​Обробка помилок

​Приклад відповіді з помилкою

​Висновок

Процес подання заявки

Приклад запиту

Зображення прикладу завдання

Налаштування заголовків запиту та тіла запиту

Приклад коду

CURL

Приклад відповіді

Операція пакетного запиту

Приклад коду

Приклад відповіді

CURL

Обробка помилок

Приклад відповіді з помилкою

Висновок