Development Dreamina Tasks

​

Integracja i użycie API Dreamina Tasks

​

Proces aplikacji

​

Parametry żądania

• accept: określa, że oczekujesz odpowiedzi w formacie JSON, wpisz application/json.
• authorization: klucz do wywołania API, w formacie Bearer {token}.
• content-type: wpisz application/json.

Przy zapytaniu o pojedyncze zadanie, przynajmniej jedno z id lub trace_id musi być podane.

​

Zapytanie o pojedyncze zadanie

​

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)

​

Przykład odpowiedzi

{
  "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: unikalne ID zadania generowania wideo.
• trace_id: ID śledzenia tego żądania, używane do rozwiązywania problemów.
• request: treść żądania złożonego przy tworzeniu zadania.
• response: treść odpowiedzi zwrócona po zakończeniu zadania. Gdy response.data.status jest done, response.data.video_url to ostateczny adres wideo.
• created_at: czas utworzenia zadania, znacznik czasu Unix (sekundy, liczba zmiennoprzecinkowa).
• started_at: czas rozpoczęcia wykonania zadania, znacznik czasu Unix (sekundy, liczba zmiennoprzecinkowa).
• finished_at: czas zakończenia zadania, znacznik czasu Unix (sekundy, liczba zmiennoprzecinkowa). To pole nie jest zwracane, gdy zadanie nie jest zakończone.
• elapsed: czas wykonania zadania, jednostka to sekundy (liczba zmiennoprzecinkowa, z 3 miejscami po przecinku). To pole nie jest zwracane, gdy zadanie nie jest zakończone.

Jeśli zadanie nie jest jeszcze zakończone, status może być w stanie innym niż done; jeśli zadanie nie istnieje lub nie wygenerowano jeszcze wyników, interfejs zwróci pusty obiekt {}, spróbuj ponownie później.

​

Zapytanie zbiorcze o zadania

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

​

Obsługa błędów

• 400 bad_request: błąd żądania, mogą brakować niezbędne parametry, takie jak id / trace_id.
• 401 invalid_token: brak autoryzacji, token autoryzacyjny jest nieprawidłowy lub brakujący.
• 429 too_many_requests: zbyt wiele żądań, przekroczono limit szybkości.
• 500 api_error: wewnętrzny błąd serwera.

​

Przykład odpowiedzi błędu

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

​

Wnioski