> ## 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. # Producer Tasks API 的對接和使用 > Producer Music Generation 集成指南 - XHuoAPI Producer Tasks API 的主要功能是通過輸入 Producer Audios Generation API 生成的任務ID來查詢該任務的執行情況。 本文檔將詳細介紹 Producer Tasks API 的對接說明，幫助您輕鬆集成並充分利用該 API 的強大功能。通過 Producer Tasks API，您可以輕鬆實現查詢 Producer Audios Generation API 的任務執行情況。 ## 申請流程 要使用 Producer Tasks API，需要先到 申請頁面 [Producer Audios Generation API ](https://api.xhuoapi.ai/documents/producer-audios)申請相應的服務，然後複製 Producer Audios Generation API的任務ID，如圖所示：

最後進入Tasks API頁面 [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。 ## 請求示例 Producer Tasks API 可以用於查詢 Producer Audios Generation API 的結果。關於怎樣使用 Producer Audios Generation API，請參考文檔 [Producer Audios Generation API ](https://api.xhuoapi.ai/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.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 字段就是發起任務時的 request body，同時response 字段是任務完成後返回的response body。字段介紹如下。 * `id`，生成任務的 ID，用於唯一標識此次生成任務。 * `request`，查詢任務中的請求信息。 * `response`，查詢任務中的返回信息。 ## 批量查詢操作 這是針對多個任務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, "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": "[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://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": "fetch failed" }, "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89" } ``` ## 結論 通過本文檔，您已經了解了如何使用 Producer Tasks API 進行查詢單個或批量任務的所有具體詳情信息。希望本文檔能幫助您更好地對接和使用該 API。如有任何問題，請隨時聯繫我們的技術支持團隊。