Development Dreamina Tasks

​

Intégration et utilisation de l’API Dreamina Tasks

​

Processus de demande

​

Paramètres de demande

• accept : spécifie que la réponse doit être au format JSON, remplissez application/json.
• authorization : clé d’API pour appeler l’API, au format Bearer {token}.
• content-type : remplissez application/json.

Lors de l’interrogation d’une seule tâche, id et trace_id doivent en fournir au moins un.

​

Interroger une seule tâche

​

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)

​

Exemple de réponse

{
  "id": "362b4fed-67bd-11f1-ad11-00163e57d510",
  "started_at": 1769262721.823,
  "finished_at": 1769262769.123,
  "elapsed": 47.3,
  "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 : ID unique de la tâche de génération de vidéo.
• trace_id : ID de suivi de cette demande, utilisé pour le dépannage.
• request : Contenu de la demande soumis lors de la création de la tâche.
• response : Contenu de la réponse renvoyé après l’achèvement de la tâche. Lorsque response.data.status est done, response.data.video_url est l’adresse vidéo finale.
• created_at : Heure de création de la tâche, horodatage Unix (secondes, flottant).
• started_at : Heure de début d’exécution de la tâche, horodatage Unix (secondes, flottant).
• finished_at : Heure d’achèvement de la tâche, horodatage Unix (secondes, flottant). Ce champ n’est pas renvoyé si la tâche n’est pas terminée.
• elapsed : Temps d’exécution de la tâche, en secondes (flottant, avec 3 décimales). Ce champ n’est pas renvoyé si la tâche n’est pas terminée.

Si la tâche n’est pas encore terminée, status peut ne pas être dans l’état done ; si la tâche n’existe pas ou n’a pas encore généré de résultats, l’interface renverra un objet vide {}, veuillez réessayer plus tard.

​

Interrogation par lot de tâches

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

​

Gestion des erreurs

• 400 bad_request : Erreur de demande, il peut manquer des paramètres nécessaires comme id / trace_id.
• 401 invalid_token : Non autorisé, le jeton d’autorisation est invalide ou manquant.
• 429 too_many_requests : Trop de demandes, dépassement de la limite de taux.
• 500 api_error : Erreur interne du serveur.

​

Exemple de réponse d’erreur

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

​

Conclusion