Development Dreamina Tasks

​

Integração e Uso da API Dreamina Tasks

​

Processo de Solicitação

​

Parâmetros de Solicitação

• accept: especifica que a resposta deve ser no formato JSON, preenchendo application/json.
• authorization: chave para chamar a API, no formato Bearer {token}.
• content-type: preencha com application/json.

Ao consultar uma única tarefa, pelo menos um de id ou trace_id deve ser fornecido.

​

Consulta de uma Única Tarefa

​

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)

​

Exemplo de Resposta

{
  "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 da tarefa de geração de vídeo.
• trace_id: ID de rastreamento da solicitação, usado para resolução de problemas.
• request: Conteúdo da solicitação enviado ao criar a tarefa.
• response: Conteúdo da resposta retornado após a conclusão da tarefa. Quando response.data.status é done, response.data.video_url é o endereço final do vídeo.
• created_at: Hora de criação da tarefa, timestamp Unix (segundos, ponto flutuante).
• started_at: Hora de início da execução da tarefa, timestamp Unix (segundos, ponto flutuante).
• finished_at: Hora de conclusão da tarefa, timestamp Unix (segundos, ponto flutuante). Este campo não é retornado se a tarefa não estiver concluída.
• elapsed: Tempo gasto na execução da tarefa, em segundos (ponto flutuante, com 3 casas decimais). Este campo não é retornado se a tarefa não estiver concluída.

Se a tarefa ainda não estiver concluída, o status pode não ser done; se a tarefa não existir ou ainda não tiver gerado resultados, a interface retornará um objeto vazio {}, por favor, tente novamente mais tarde.

​

Consulta em Lote de Tarefas

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

​

Tratamento de Erros

• 400 bad_request: Erro na solicitação, pode faltar id / trace_id ou outros parâmetros necessários.
• 401 invalid_token: Não autorizado, o token de autorização é inválido ou está ausente.
• 429 too_many_requests: Muitas solicitações, excedeu o limite de taxa.
• 500 api_error: Erro interno do servidor.

​

Exemplo de Resposta de Erro

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

​

Conclusão