Інтеграція та використання 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, спочатку отримайте ваш API Token у Ace Data Cloud консолі для подальшого використання.

Якщо ви ще не увійшли або не зареєстровані, система автоматично перенаправить вас на сторінку входу, де запропонує зареєструватися та увійти, після чого ви автоматично повернетесь на поточну сторінку. Один 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://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 містить тіло запиту, з яким було створено завдання, а поле response — тіло відповіді після завершення завдання. Опис полів наведено нижче.

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://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": "[Куплет]\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://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

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": "не вдалося отримати"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Висновок

Завдяки цьому документу ви дізналися, як використовувати API Producer Tasks для запиту всіх конкретних деталей одного або пакетного завдання. Сподіваємося, цей документ допоможе вам краще інтегруватися та використовувати цей API. Якщо у вас є будь-які питання, будь ласка, звертайтеся до нашої команди технічної підтримки.

Getting Started

AI Чат

AI Зображення

AI Відео

AI Аудіо

Веб і дані

CAPTCHA

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

Проксі

Advanced

Coding

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

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

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

Приклад зображення завдання

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

Приклад коду

CURL

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

Пакетний запит

Приклад коду

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

CURL

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

Приклад відповіді на помилку

Висновок

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

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

​Приклад зображення завдання

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

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

​CURL

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

​Пакетний запит

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

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

​CURL

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

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

​Висновок

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

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

Приклад зображення завдання

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

Приклад коду

CURL

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

Пакетний запит

Приклад коду

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

CURL

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

Приклад відповіді на помилку

Висновок