> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Integración y uso de la API de Tareas de Grok

> Grok API guide - Ace Data Cloud

La principal función de la API de Tareas de Grok es consultar el estado de ejecución de una tarea mediante el ID de tarea generado por la API de Generación de Videos de Grok.

Este documento detallará las instrucciones de integración de la API de Tareas de Grok, ayudándole a integrar y consultar fácilmente el estado de ejecución de las tareas de la API de Generación de Videos de Grok.

## Proceso de Solicitud

Para utilizar la API de Generación de Videos de Grok, primero dirígete a [la consola de Ace Data Cloud](https://platform.acedata.cloud/console/applications) para obtener tu Token de API, que debes guardar para uso futuro.

![](https://cdn.acedata.cloud/dvc3cg.jpg)

Si aún no has iniciado sesión o registrado, serás redirigido automáticamente a la página de inicio de sesión que te invitará a registrarte e iniciar sesión; una vez completado, serás devuelto automáticamente a la página actual.

**Un Token de API es suficiente para acceder a todos los servicios de la plataforma, no es necesario solicitar uno por cada servicio.** La primera solicitud incluirá un crédito gratuito para que puedas probarlo; si el crédito es insuficiente, puedes recargar el saldo general en [la consola](https://platform.acedata.cloud/console/coin).

> 📘 Documentación completa: [API de Generación de Videos de Grok →](https://platform.acedata.cloud/documents/grok-videos)

## Ejemplo de Solicitud

La API de Tareas de Grok se puede utilizar para consultar los resultados de la API de Generación de Videos de Grok.

### Configuración de los Encabezados de Solicitud y Cuerpo de Solicitud

**Encabezados de Solicitud** incluyen:

* `accept`: especifica que se aceptan respuestas en formato JSON, aquí se debe escribir `application/json`.
* `authorization`: la clave para llamar a la API, que puedes seleccionar directamente después de solicitarla.

**Cuerpo de Solicitud** incluye:

* `id`: el ID de la tarea que deseas consultar.
* `action`: el método de operación sobre la tarea, para una consulta individual se debe escribir `retrieve`.

### Ejemplo de Código CURL

```bash theme={null}
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"
}'
```

### Ejemplo de Respuesta

Después de una solicitud exitosa, la API devolverá la información detallada de la tarea aquí. El campo `request` es el cuerpo de la solicitud al iniciar la tarea, y el campo `response` es el cuerpo de la respuesta devuelta una vez que la tarea se completa, por ejemplo:

```json theme={null}
{
  "id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
  "started_at": 1769262721.823,
  "finished_at": 1769262729.623,
  "elapsed": 7.8,
  "request": {
    "prompt": "Una toma cinematográfica de un gatito persiguiendo una mariposa en un jardín iluminado por el sol",
    "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"
      }
    ]
  }
}
```

La descripción de los campos es la siguiente:

* `id`: el ID de la tarea generada, utilizado para identificar de manera única esta tarea de generación.
* `request`: información de la solicitud en la tarea consultada.
* `response`: información de la respuesta en la tarea consultada.
* `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.

## Operación de Consulta por Lotes

Para consultar los detalles de varias tareas ID, establece `action` como `retrieve_batch` y pasa un array de IDs de tarea a través de `ids`:

**Cuerpo de Solicitud** incluye:

* `ids`: array de IDs de tarea que deseas consultar.
* `action`: el método de operación sobre la tarea, para consultas por lotes se debe escribir `retrieve_batch`.

```bash theme={null}
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"
}'
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.