Integração e Uso da API Grok Tasks

​

Processo de Solicitação

📘 Documentação Completa: Grok Videos Generation API →

​

Exemplo de Solicitação

​

Configurando Cabeçalhos e Corpo da Solicitação

• accept: especifica que a resposta deve ser no formato JSON, preenchido como application/json.
• authorization: a chave para chamar a API, que pode ser selecionada diretamente após a solicitação.

• id: o ID da tarefa a ser consultada.
• action: a forma de operação na tarefa, para consulta única, preencha como retrieve.

​

Exemplo de Código CURL

curl -X POST 'https://api.acedata.cloud/grok/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
  "action": "retrieve"
}'

​

Exemplo de Resposta

{
  "id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
  "started_at": 1769262721.823,
  "finished_at": 1769262729.623,
  "elapsed": 7.8,
  "request": {
    "prompt": "Uma cena cinematográfica de um gatinho perseguindo uma borboleta em um jardim ensolarado",
    "model": "grok-imagine-video-1.5-fast:reverse",
    "resolution": "480p",
    "duration": 8
  },
  "type": "videos",
  "response": {
    "success": true,
    "task_id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
    "trace_id": "fb751e1e-4705-49ea-9fd4-5024b7865ea2",
    "data": [
      {
        "id": "grok-imagine-video-1.5-fast:reverse:41eb9a5f-3b2d-4d1e-9f5a-6c2f1a0b9e77",
        "video_url": "https://cdn.acedata.cloud/c8cbf53aa0.mp4",
        "state": "succeeded"
      }
    ]
  }
}

• id: ID da tarefa gerada, usado para identificar exclusivamente esta tarefa de geração.
• request: informações da solicitação na tarefa consultada.
• response: informações da resposta na tarefa consultada.
• created_at: data e hora de criação da tarefa, timestamp Unix (segundos, ponto flutuante).
• started_at: data e hora em que a tarefa começou a ser executada, timestamp Unix (segundos, ponto flutuante).
• finished_at: data e hora em que a tarefa foi concluída, 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.

​

Operação de Consulta em Lote

• ids: array de IDs de tarefas a serem consultadas.
• action: a forma de operação na tarefa, para consulta em lote, preencha como retrieve_batch.

curl -X POST 'https://api.acedata.cloud/grok/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["b8976e18-32dc-4718-9ed8-1ea090fcb6ea"],
  "action": "retrieve_batch"
}'