Integration und Nutzung der Producer Tasks API

Die Hauptfunktion der Producer Tasks API besteht darin, den Ausführungsstatus einer Aufgabe durch Eingabe der von der Producer Audios Generation API generierten Aufgaben-ID abzufragen. Dieses Dokument stellt die Integrationsanleitung für die Producer Tasks API detailliert vor und hilft Ihnen, diese API einfach zu integrieren und ihre leistungsstarken Funktionen vollständig zu nutzen. Über die Producer Tasks API können Sie einfach den Aufgabenausführungsstatus der Producer Audios Generation API abfragen.

Antragsprozess

Um die Producer Audios Generation API zu nutzen, rufen Sie zunächst in der Ace Data Cloud-Konsole Ihren API-Token ab und bewahren Sie ihn zur späteren Verwendung auf.

Wenn Sie noch nicht angemeldet oder registriert sind, werden Sie automatisch zur Anmeldeseite weitergeleitet, um sich zu registrieren und anzumelden. Nach Abschluss kehren Sie automatisch zu dieser Seite zurück. Ein API-Token kann alle Dienste der Plattform aufrufen; es ist nicht erforderlich, für jeden Dienst einen separaten Antrag zu stellen. Bei der ersten Beantragung erhalten Sie ein kostenloses Kontingent für eine kostenlose Testnutzung; bei unzureichendem Kontingent können Sie in der Konsole allgemeines Guthaben aufladen.

📘 Vollständige Dokumentation: Producer Audios Generation API →

Anfragebeispiel

Die Producer Tasks API kann verwendet werden, um die Ergebnisse der Producer Audios Generation API abzufragen. Informationen zur Nutzung der Producer Audios Generation API finden Sie in der Dokumentation Producer Audios Generation API . Wir verwenden eine von dem Dienst Producer Audios Generation API zurückgegebene Aufgaben-ID als Beispiel, um zu zeigen, wie diese API verwendet wird. Angenommen, wir haben eine Aufgaben-ID: 1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad. Im Folgenden wird gezeigt, wie durch Übergabe einer Aufgaben-ID vorgegangen wird.

Beispielbild der Aufgabe

Anfrage-Header und Anfrage-Body festlegen

Request Headers umfassen:

accept: Gibt an, dass Antwortergebnisse im JSON-Format empfangen werden; hier wird application/json eingetragen.
authorization: Der Schlüssel zum Aufrufen der API, der nach der Beantragung direkt über das Dropdown-Menü ausgewählt werden kann.

Request Body umfasst:

id: Die hochgeladene Aufgaben-ID.
action: Die Vorgehensweise für die Aufgabe.

Die Einstellungen sind in der folgenden Abbildung dargestellt:

Codebeispiel

Es ist zu erkennen, dass auf der rechten Seite der Seite bereits automatisch Code in verschiedenen Sprachen generiert wurde, wie in der Abbildung dargestellt:

Einige Codebeispiele sind wie folgt:

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

Antwortbeispiel

Nach erfolgreicher Anfrage gibt die API die Detailinformationen dieser Aufgabe zurück. Zum Beispiel:

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

Das zurückgegebene Ergebnis enthält mehrere Felder. Das Feld request ist der Request Body beim Starten der Aufgabe, während das Feld response der nach Abschluss der Aufgabe zurückgegebene Response Body ist. Die Felder werden wie folgt vorgestellt.

id, die ID der Generierungsaufgabe, die zur eindeutigen Identifizierung dieser Generierungsaufgabe verwendet wird.
request, die Anfrageinformationen in der Abfrageaufgabe.
response, die Rückgabeinformationen in der Abfrageaufgabe.
created_at, die Erstellungszeit der Aufgabe, Unix-Zeitstempel (Sekunden, Gleitkommazahl).
started_at, die Startzeit der Aufgabenausführung, Unix-Zeitstempel (Sekunden, Gleitkommazahl).
finished_at, die Abschlusszeit der Aufgabe, Unix-Zeitstempel (Sekunden, Gleitkommazahl). Dieses Feld wird nicht zurückgegeben, wenn die Aufgabe nicht abgeschlossen ist.
elapsed, die Ausführungsdauer der Aufgabe in Sekunden (Gleitkommazahl, auf 3 Dezimalstellen gerundet). Dieses Feld wird nicht zurückgegeben, wenn die Aufgabe nicht abgeschlossen ist.

Stapelabfragevorgang

Dies dient der Abfrage von Aufgabendetails für mehrere Aufgaben-IDs. Anders als oben muss action auf retrieve_batch gesetzt werden. Request Body umfasst:

ids: Das Array der hochgeladenen Aufgaben-IDs.
action: Die Operationsmethode für die Aufgabe.

Legen Sie es wie in der folgenden Abbildung gezeigt fest:

Codebeispiel

Es ist zu sehen, dass auf der rechten Seite der Seite automatisch Code in verschiedenen Sprachen generiert wurde, wie in der Abbildung gezeigt:

Einige Codebeispiele lauten wie folgt:

Antwortbeispiel

Nach erfolgreicher Anfrage gibt die API die spezifischen Detailinformationen aller Stapelaufgaben dieser Anfrage zurück. Zum Beispiel:

  "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": "Wachte mit der Sonne in meinen Augen auf",
            "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
            "lyric": "[Strophe]\nWachte mit der Sonne in meinen Augen auf\nKeine Wolken über mir, nur Blau am Himmel\nSchuhe an meinen Füßen, ich bin bereit zu laufen\nJeder Schritt fühlt sich wie eine geladene Waffe an\n[Refrain]\nGlückliche Tage ziehen ein\nLass die Freude unter meiner Haut\nKeine Schatten mehr, keine Lügen mehr\nNur die Wahrheit, die mich hochhebt\n[Strophe 2]\nTanzend durch die Straßen der Stadt\nEin Rhythmus hämmert in meinem Herzschlag\nFremde lächeln, es steckt an\nDiese Welt ist eine Bühne, wir sind alle ein Lied\n[Refrain]\nGlückliche Tage ziehen ein\nLass die Freude unter meiner Haut\nKeine Schatten mehr, keine Lügen mehr\nNur die Wahrheit, die mich hochhebt\n[Bridge]\nWirf deine Sorgen zur Tür hinaus\nLass sie auf den Meeresgrund sinken\nWir leben, und das ist genug\nDas Leben ist chaotisch, aber es ist Liebe\n[Refrain]\nGlückliche Tage ziehen ein\nLass die Freude unter meiner Haut\nKeine Schatten mehr, keine Lügen mehr\nNur die Wahrheit, die mich hochhebt",
            "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
}

Das zurückgegebene Ergebnis enthält mehrere Felder, wobei items die detaillierten Informationen der Stapelaufgaben enthält. Die spezifischen Informationen jeder Aufgabe entsprechen den oben genannten Feldern. Die Feldinformationen sind wie folgt.

items, alle detaillierten Informationen der Stapelaufgaben. Es ist ein Array, und jedes Element des Arrays hat dasselbe Format wie das Rückgabeergebnis für die Abfrage einer einzelnen Aufgabe oben.
count, die Anzahl der Aufgaben in dieser Stapelabfrage.

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

Fehlerbehandlung

Wenn bei der API-Nutzung ein Fehler auftritt, gibt die API den entsprechenden Fehlercode und die entsprechenden Informationen zurück. Zum Beispiel:

400 token_mismatched: Ungültige Anfrage, möglicherweise aufgrund fehlender oder ungültiger Parameter.
400 api_not_implemented: Ungültige Anfrage, möglicherweise aufgrund fehlender oder ungültiger Parameter.
401 invalid_token: Nicht autorisiert, ungültiges oder fehlendes Autorisierungstoken.
429 too_many_requests: Zu viele Anfragen, Sie haben das Ratenlimit überschritten.
500 api_error: Interner Serverfehler, auf dem Server ist ein Fehler aufgetreten.

Beispiel für eine Fehlerantwort

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

Fazit

Durch dieses Dokument haben Sie bereits erfahren, wie Sie die Producer Tasks API verwenden können, um alle detaillierten Informationen einzelner oder mehrerer Aufgaben abzufragen. Wir hoffen, dass dieses Dokument Ihnen dabei helfen kann, diese API besser anzubinden und zu verwenden. Bei Fragen kontaktieren Sie bitte jederzeit unser technisches Support-Team.

Erste Schritte

KI Chat

KI Bild

KI Video

KI Audio

Web & Daten

CAPTCHA

Identität

Coding

Weitere Anleitungen

Integration und Nutzung der Producer Tasks API

Antragsprozess

Anfragebeispiel

Beispielbild der Aufgabe

Anfrage-Header und Anfrage-Body festlegen

Codebeispiel

CURL

Antwortbeispiel

Stapelabfragevorgang

Codebeispiel

Antwortbeispiel

CURL

Fehlerbehandlung

Beispiel für eine Fehlerantwort

Fazit

​Antragsprozess

​Anfragebeispiel

​Beispielbild der Aufgabe

​Anfrage-Header und Anfrage-Body festlegen

​Codebeispiel

​CURL

​Antwortbeispiel

​Stapelabfragevorgang

​Codebeispiel

​Antwortbeispiel

​CURL

​Fehlerbehandlung

​Beispiel für eine Fehlerantwort

​Fazit

Antragsprozess

Anfragebeispiel

Beispielbild der Aufgabe

Anfrage-Header und Anfrage-Body festlegen

Codebeispiel

CURL

Antwortbeispiel

Stapelabfragevorgang

Codebeispiel

Antwortbeispiel

CURL

Fehlerbehandlung

Beispiel für eine Fehlerantwort

Fazit