> ## Documentation Index > Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt > Use this file to discover all available pages before exploring further. # Интеграция и использование API Producer Tasks > Producer Music Generation 集成指南 - XHuoAPI Основная функция API Producer Tasks заключается в том, чтобы запрашивать статус выполнения задачи, используя ID задачи, сгенерированный API Producer Audios Generation. В этом документе подробно описывается интеграция API Producer Tasks, чтобы помочь вам легко интегрировать и в полной мере использовать мощные возможности этого API. С помощью API Producer Tasks вы можете легко запрашивать статус выполнения задач API Producer Audios Generation. ## Процесс подачи заявки Чтобы использовать API Producer Tasks, сначала необходимо перейти на страницу заявки [Producer Audios Generation API](https://api.xhuoapi.ai/documents/producer-audios) и запросить соответствующую услугу, затем скопировать ID задачи API Producer Audios Generation, как показано на рисунке:

Затем перейдите на страницу API Tasks [Producer Tasks API](https://api.xhuoapi.ai/documents/622626b1-30a7-4799-a772-4946e1df3ac0) и запросите соответствующую услугу, после перехода на страницу нажмите кнопку «Acquire», как показано на рисунке: ![Страница заявки](https://cdn.xhuoapi.ai/rci31i.png) Если вы еще не вошли в систему или не зарегистрированы, вы будете автоматически перенаправлены на [страницу входа](https://api.xhuoapi.ai), где вас пригласят зарегистрироваться и войти в систему. После входа в систему вы будете автоматически возвращены на текущую страницу. При первой подаче заявки предоставляется бесплатный лимит, который позволяет бесплатно использовать этот API. ## Пример запроса API Producer Tasks можно использовать для запроса результатов API Producer Audios Generation. Для получения информации о том, как использовать API Producer Audios Generation, обратитесь к документации [Producer Audios Generation API](https://api.xhuoapi.ai/documents/producer-audios-integration). Мы возьмем один из ID задач, возвращенных службой API Producer Audios Generation, в качестве примера и продемонстрируем, как использовать этот 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.xhuoapi.ai/v1/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, "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://storage.googleapis.com/corpusant-app-public/riffs/3bff6223-fe13-4bef-973e-2cbaef430d5d/image/1dd08826-478e-43a6-868f-aff5ababac2c.jpg", "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://storage.googleapis.com/corpusant-app-public/riffs/3bff6223-fe13-4bef-973e-2cbaef430d5d/audio/1dd08826-478e-43a6-868f-aff5ababac2c.m4a", "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" } ] }, "duration": 40.06500005722046, "finished_at": 1767119785.589 } ``` Возвращаемый результат содержит несколько полей, поле request — это тело запроса, отправленное при инициации задачи, а поле response — это тело ответа, возвращаемое после завершения задачи. Описание полей следующее. * `id` — ID сгенерированной задачи, используемый для уникальной идентификации данной задачи. * `request` — информация о запросе в задаче. * `response` — информация о возвращаемом ответе в задаче. ## Пакетный запрос Это запрос для получения деталей нескольких задач по их ID, в отличие от предыдущего, здесь необходимо выбрать действие retrieve\_batch. **Тело запроса** включает: * `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, "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://storage.googleapis.com/corpusant-app-public/riffs/3bff6223-fe13-4bef-973e-2cbaef430d5d/image/1dd08826-478e-43a6-868f-aff5ababac2c.jpg", "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://storage.googleapis.com/corpusant-app-public/riffs/3bff6223-fe13-4bef-973e-2cbaef430d5d/audio/1dd08826-478e-43a6-868f-aff5ababac2c.m4a", "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" } ] }, "duration": 40.06500005722046, "finished_at": 1767119785.589 }, { "_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, "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://storage.googleapis.com/corpusant-app-public/riffs/3bff6223-fe13-4bef-973e-2cbaef430d5d/image/1dd08826-478e-43a6-868f-aff5ababac2c.jpg", "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://storage.googleapis.com/corpusant-app-public/riffs/3bff6223-fe13-4bef-973e-2cbaef430d5d/audio/1dd08826-478e-43a6-868f-aff5ababac2c.m4a", "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" } ] }, "duration": 40.06500005722046, "finished_at": 1767119785.589 } ], "count": 2 } ``` Возвращаемый результат содержит несколько полей, среди которых items включает в себя конкретные детали пакетной задачи, каждая задача имеет такую же структуру полей, как и вышеупомянутое возвращаемое значение для одиночной задачи. Поля информации следующие. * `items`, все конкретные детали пакетной задачи. Это массив, каждый элемент массива имеет такую же структуру, как и вышеупомянутое возвращаемое значение для одиночной задачи. * `count`, количество задач в этой пакетной выборке. #### CURL ```bash theme={null} curl -X POST 'https://api.xhuoapi.ai/v1/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": "не удалось получить" }, "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89" } ``` ## Заключение С помощью этого документа вы узнали, как использовать API Producer Tasks для запроса всех конкретных деталей одиночной или пакетной задачи. Надеемся, этот документ поможет вам лучше интегрировать и использовать этот API. Если у вас есть какие-либо вопросы, пожалуйста, не стесняйтесь обращаться в нашу техническую поддержку.