Skip to main content
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 para obtener tu Token de API, que debes guardar para uso futuro. 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.
📘 Documentación completa: API de Generación de Videos de Grok →

​
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

​
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:
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.