Development Dreamina Tasks

​

Integración y uso de la API de Dreamina Tasks

​

Proceso de solicitud

​

Parámetros de solicitud

• accept: especifica que se aceptan respuestas en formato JSON, escribe application/json.
• authorization: clave para llamar a la API, en el formato Bearer {token}.
• content-type: escribe application/json.

Al consultar una tarea individual, se debe proporcionar al menos uno de id o trace_id.

​

Consultar una tarea individual

​

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)

​

Ejemplo de respuesta

{
  "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 único de la tarea de generación de video.
• trace_id: ID de seguimiento de esta solicitud, utilizado para la resolución de problemas.
• request: contenido de la solicitud enviado al crear la tarea.
• response: contenido de la respuesta devuelta después de completar la tarea. Cuando response.data.status es done, response.data.video_url es la dirección final del video.
• created_at: hora de creación de la tarea, marca de tiempo Unix (segundos, flotante).
• started_at: hora de inicio de ejecución de la tarea, marca de tiempo Unix (segundos, flotante).
• finished_at: hora de finalización de la tarea, marca de tiempo Unix (segundos, flotante). Este campo no se devuelve si la tarea no se ha completado.
• elapsed: tiempo de ejecución de la tarea, en segundos (flotante, con 3 decimales). Este campo no se devuelve si la tarea no se ha completado.

Si la tarea aún no se ha completado, el status puede no ser done; si la tarea no existe o aún no se ha generado un resultado, la interfaz devolverá un objeto vacío {}, por favor intenta de nuevo más tarde.

​

Consulta de tareas por lotes

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

​

Manejo de errores

• 400 bad_request: error en la solicitud, puede faltar id / trace_id u otros parámetros necesarios.
• 401 invalid_token: no autorizado, el token de autorización es inválido o está ausente.
• 429 too_many_requests: demasiadas solicitudes, se ha superado el límite de velocidad.
• 500 api_error: error interno del servidor.

​

Ejemplo de respuesta de error

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

​

Conclusión