Development Dreamina Tasks

​

Dreamina Tasks API Integration und Nutzung

​

Antragsprozess

​

Anfrageparameter

• accept: Gibt an, dass die Antwort im JSON-Format empfangen werden soll, trage application/json ein.
• authorization: Der Schlüssel zum Aufrufen der API, im Format Bearer {token}.
• content-type: Trage application/json ein.

Bei der Abfrage einer einzelnen Aufgabe muss entweder id oder trace_id bereitgestellt werden.

​

Abfrage einer einzelnen Aufgabe

​

CURL

curl -X POST 'https://api.acedata.cloud/dreamina/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "retrieve",
  "id": "362b4fed-67bd-11f1-ad11-00163e57d510"
}'

​

Python

import requests

url = "https://api.acedata.cloud/dreamina/tasks"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "action": "retrieve",
    "id": "362b4fed-67bd-11f1-ad11-00163e57d510"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

​

Beispielantwort

{
  "id": "362b4fed-67bd-11f1-ad11-00163e57d510",
  "trace_id": "a9063166-26ed-4451-85b5-54e896817c69",
  "request": {
    "model": "omnihuman-1.5",
    "image_url": "https://cdn.acedata.cloud/4hfydw.jpg",
    "audio_url": "https://cdn.acedata.cloud/6f7d62b18b.wav"
  },
  "response": {
    "success": true,
    "data": {
      "task_id": "362b4fed67bd11f1ad1100163e57d510",
      "status": "done",
      "video_url": "https://cdn.acedata.cloud/634d760216.mp4",
      "image_url": "https://cdn.acedata.cloud/4hfydw.jpg",
      "audio_url": "https://cdn.acedata.cloud/6f7d62b18b.wav"
    }
  }
}

• id: Die eindeutige ID der Videoerzeugungsaufgabe.
• trace_id: Die Verfolgungs-ID dieser Anfrage, die zur Fehlersuche verwendet wird.
• request: Der Inhalt der Anfrage, der bei der Erstellung der Aufgabe übermittelt wurde.
• response: Der Antwortinhalt nach Abschluss der Aufgabe. Wenn response.data.status done ist, ist response.data.video_url die endgültige Video-URL.
• created_at: Erstellungszeit der Aufgabe, Unix-Zeitstempel (Sekunden, Fließkomma).
• started_at: Beginn der Ausführung der Aufgabe, Unix-Zeitstempel (Sekunden, Fließkomma).
• finished_at: Abschlusszeit der Aufgabe, Unix-Zeitstempel (Sekunden, Fließkomma). Dieses Feld wird nicht zurückgegeben, wenn die Aufgabe nicht abgeschlossen ist.
• elapsed: Die für die Ausführung der Aufgabe benötigte Zeit, in Sekunden (Fließkomma, auf 3 Dezimalstellen gerundet). Dieses Feld wird nicht zurückgegeben, wenn die Aufgabe nicht abgeschlossen ist.

Wenn die Aufgabe noch nicht abgeschlossen ist, kann der status einen anderen Wert als done haben; wenn die Aufgabe nicht existiert oder noch kein Ergebnis generiert wurde, gibt die API ein leeres Objekt {} zurück, bitte später erneut versuchen.

​

Batchabfrage von Aufgaben

curl -X POST 'https://api.acedata.cloud/dreamina/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "retrieve_batch",
  "ids": [
    "362b4fed-67bd-11f1-ad11-00163e57d510",
    "0c0b4d3a-2f1e-4a6b-9c2d-2b3c4d5e6f70"
  ]
}'

​

Fehlerbehandlung

• 400 bad_request: Anfragefehler, möglicherweise fehlen notwendige Parameter wie id / trace_id.
• 401 invalid_token: Nicht autorisiert, der Autorisierungstoken ist ungültig oder fehlt.
• 429 too_many_requests: Zu viele Anfragen, die Ratebegrenzung wurde überschritten.
• 500 api_error: Interner Serverfehler.

​

Beispiel für eine Fehlerantwort

{
  "error": {
    "code": "bad_request",
    "message": "id or trace_id is required to retrieve a task"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​

Fazit