Skip to main content
La API de HappyHorse Tasks se utiliza para consultar las tareas de generación o edición de videos creadas por la API de HappyHorse Videos.

​
Proceso de solicitud

Para utilizar la API de HappyHorse Videos, primero dirígete a la consola de Ace Data Cloud para obtener tu token de API, guárdalo 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 invita 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: HappyHorse Videos API →

​
Ejemplo de solicitud

La API de HappyHorse Tasks se puede utilizar para consultar los resultados de la API de HappyHorse Videos.

​
Configuración de encabezados y cuerpo de la solicitud

Request Headers incluye:
  • accept: especifica que se aceptan respuestas en formato JSON, aquí se debe escribir application/json.
  • authorization: la clave para llamar a la API, que se puede seleccionar directamente después de solicitarla.
Request Body incluye:
  • id: el ID de la tarea a 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á los detalles de la tarea. El campo request es el cuerpo de la solicitud al crear la tarea, el campo response es el cuerpo de la respuesta devuelta una vez que la tarea se ha completado, 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: la información de la solicitud al crear la tarea.
  • response: la información de retorno actual o final de la tarea.
  • created_at: la hora de creación de la tarea, marca de tiempo Unix (segundos, punto flotante).
  • started_at: la hora de inicio de la ejecución de la tarea, marca de tiempo Unix (segundos, punto flotante).
  • finished_at: la hora de finalización de la tarea, marca de tiempo Unix (segundos, punto flotante). Este campo no se devuelve si la tarea no se ha completado.
  • elapsed: el tiempo de ejecución de la tarea, en segundos (punto 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 tareas a través de ids:
El resultado devuelto incluirá los campos items y count, donde items es un array de detalles de las tareas y count es la cantidad de tareas coincidentes en esta consulta.