Integrering och användning av Producer Tasks API

Huvudfunktionen för Producer Tasks API är att fråga om exekveringsstatusen för en uppgift genom att ange uppgifts-ID:t som genererats av Producer Audios Generation API. Detta dokument kommer att ge en detaljerad introduktion till integreringsanvisningarna för Producer Tasks API, för att hjälpa dig att enkelt integrera och fullt ut utnyttja API:ets kraftfulla funktioner. Genom Producer Tasks API kan du enkelt fråga om uppgifters exekveringsstatus i Producer Audios Generation API.

Ansökningsprocess

För att använda Producer Audios Generation API, gå först till Ace Data Cloud-konsolen för att hämta din API-token och spara den för senare användning.

Om du ännu inte är inloggad eller registrerad omdirigeras du automatiskt till inloggningssidan där du uppmanas att registrera dig och logga in. När detta är klart återgår du automatiskt till den aktuella sidan. En API-token kan anropa alla tjänster på plattformen, utan att behöva ansöka separat för varje tjänst. Vid första ansökan får du en kostnadsfri kvot för att prova tjänsten gratis; när kvoten är otillräcklig kan du fylla på det gemensamma saldot i konsolen.

📘 Fullständig dokumentation: Producer Audios Generation API →

Begäransexempel

Producer Tasks API kan användas för att fråga om resultaten från Producer Audios Generation API. För information om hur du använder Producer Audios Generation API, se dokumentationen Producer Audios Generation API . Vi tar ett uppgifts-ID som returneras av tjänsten Producer Audios Generation API som exempel för att visa hur API:et används. Anta att vi har ett uppgifts-ID: 1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad, nedan visas hur du gör genom att ange ett uppgifts-ID.

Exempelbild för uppgift

Ange begärandehuvud och begärandetext

Request Headers inkluderar:

accept: anger att svar i JSON-format ska tas emot, ange här application/json.
authorization: nyckeln för att anropa API:et, som kan väljas direkt från rullgardinsmenyn efter ansökan.

Request Body inkluderar:

id: det uppladdade uppgifts-ID:t.
action: åtgärdssättet för uppgiften.

Inställningarna visas i bilden nedan:

Kodexempel

Du kan se att kod på olika språk redan har genererats automatiskt på höger sida av sidan, som visas i bilden:

Vissa kodexempel är följande:

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"
}'

Svarsexempel

Efter att begäran har lyckats kommer API:et att returnera detaljinformation om uppgiften här. Till exempel:

{
  "_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"
      }
    ]
  }
}

Det returnerade resultatet innehåller flera fält. Fältet request är request body när uppgiften startas, medan fältet response är response body som returneras efter att uppgiften har slutförts. Fältbeskrivningarna är följande.

id，ID för genereringsuppgiften, som används för att unikt identifiera denna genereringsuppgift.
request，begärandeinformation i frågeuppgiften.
response，returinformation i frågeuppgiften.
created_at，tid då uppgiften skapades, Unix-tidsstämpel (sekunder, flyttal).
started_at，tid då uppgiften började köras, Unix-tidsstämpel (sekunder, flyttal).
finished_at，tid då uppgiften slutfördes, Unix-tidsstämpel (sekunder, flyttal). Detta fält returneras inte när uppgiften inte är slutförd.
elapsed，uppgiftens körtid, i sekunder (flyttal, med 3 decimaler). Detta fält returneras inte när uppgiften inte är slutförd.

Åtgärd för batchfråga

Detta används för att fråga efter uppgiftsdetaljer för flera uppgifts-ID:n. Skillnaden jämfört med ovan är att action måste väljas som retrieve_batch Request Body inkluderar:

ids：arrayen med uppladdade uppgifts-ID:n.
action：åtgärdssättet för uppgiften.

Ställ in enligt bilden nedan:

Kodexempel

Det kan ses att kod för olika språk redan har genererats automatiskt på höger sida av sidan, som visas i bilden:

Vissa kodexempel är följande:

Svarsexempel

Efter att begäran har lyckats returnerar API:et specifik detaljinformation om alla batchuppgifter denna gång. Till exempel:

  "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": "Vaknade med solen i mina ögon",
            "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
            "lyric": "[Vers]\nVaknade med solen i mina ögon\nInga moln ovanför, bara blått på himlen\nSkor på fötterna, jag är redo att springa\nVarje steg känns som en laddad pistol\n[Refräng]\nGlada dagar rullar in\nLåt glädjen under min hud\nInga fler skuggor, inga fler lögner\nBara sanningen som lyfter mig högt\n[Vers 2]\nDansar genom stadens gator\nEn rytm som dunkar i mitt hjärta\nFrämlingar ler, det smittar av sig\nDen här världen är en scen, vi är alla en sång\n[Refräng]\nGlada dagar rullar in\nLåt glädjen under min hud\nInga fler skuggor, inga fler lögner\nBara sanningen som lyfter mig högt\n[Brygga]\nKasta ut dina bekymmer genom dörren\nLåt dem sjunka till havsbotten\nVi lever och det räcker\nLivet är rörigt men det är kärlek\n[Refräng]\nGlada dagar rullar in\nLåt glädjen under min hud\nInga fler skuggor, inga fler lögner\nBara sanningen som lyfter mig högt",
            "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": "lyckades",
            "duration": "135.2330158730159"
          }
        ]
      }
    }
  ],
  "count": 2
}

Det returnerade resultatet innehåller flera fält, där items innehåller den detaljerade informationen om batchuppgifterna, och den specifika informationen för varje uppgift är densamma som fälten ovan. Fältinformationen är följande.

items, all detaljerad information om batchuppgifterna. Det är en array, och varje element i arrayen har samma format som returresultatet för att fråga en enskild uppgift ovan.
count, antalet uppgifter i denna batchfråga.

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"
}'

Felhantering

När API:et anropas returnerar API:et motsvarande felkod och information om ett fel uppstår. Till exempel:

400 token_mismatched：Felaktig begäran, möjligen på grund av saknade eller ogiltiga parametrar.
400 api_not_implemented：Felaktig begäran, möjligen på grund av saknade eller ogiltiga parametrar.
401 invalid_token：Obehörig, ogiltig eller saknad auktoriseringstoken.
429 too_many_requests：För många begäranden, du har överskridit hastighetsgränsen.
500 api_error：Internt serverfel, något gick fel på servern.

Exempel på felsvar

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

Slutsats

Genom detta dokument har du redan förstått hur du använder Producer Tasks API för att fråga all detaljerad information om enskilda uppgifter eller batchuppgifter. Vi hoppas att detta dokument kan hjälpa dig att bättre integrera och använda detta API. Om du har några frågor, kontakta gärna vårt tekniska supportteam när som helst.

Getting Started

AI Samtal

AI Bild

AI Video

AI Ljud

Web & Data

CAPTCHA

Identitet

Coding

Fler guider

Integrering och användning av Producer Tasks API

Ansökningsprocess

Begäransexempel

Exempelbild för uppgift

Ange begärandehuvud och begärandetext

Kodexempel

CURL

Svarsexempel

Åtgärd för batchfråga

Kodexempel

Svarsexempel

CURL

Felhantering

Exempel på felsvar

Slutsats

​Ansökningsprocess

​Begäransexempel

​Exempelbild för uppgift

​Ange begärandehuvud och begärandetext

​Kodexempel

​CURL

​Svarsexempel

​Åtgärd för batchfråga

​Kodexempel

​Svarsexempel

​CURL

​Felhantering

​Exempel på felsvar

​Slutsats

Ansökningsprocess

Begäransexempel

Exempelbild för uppgift

Ange begärandehuvud och begärandetext

Kodexempel

CURL

Svarsexempel

Åtgärd för batchfråga

Kodexempel

Svarsexempel

CURL

Felhantering

Exempel på felsvar

Slutsats