Skip to main content
The HappyHorse Tasks API is used to query the video generation or editing tasks created by the HappyHorse Videos API.

​
Application Process

To use the HappyHorse Videos API, first obtain your API Token from the Ace Data Cloud Console for future reference. If you are not logged in or registered, you will be automatically redirected to the login page inviting you to register and log in, after which you will be automatically returned to the current page. One API Token is sufficient to call all services on the platform, and there is no need to apply separately for each service. The first application will grant a free quota for a trial experience; when the quota is insufficient, you can recharge the general balance in the console.
📘 Complete Documentation: HappyHorse Videos API →

​
Request Example

The HappyHorse Tasks API can be used to query the results of the HappyHorse Videos API.

​
Setting Request Headers and Request Body

Request Headers include:
  • accept: Specifies that the response result should be in JSON format, set to application/json.
  • authorization: The key to call the API, which can be selected directly after application.
Request Body includes:
  • id: The task ID to query.
  • action: The operation method for the task, set to retrieve for a single query.

​
CURL Code Example

​
Response Example

Upon a successful request, the API will return the details of the task. The request field contains the request body when the task was created, and the response field contains the response body returned after the task is completed, for example:
Field descriptions are as follows:
  • id: The ID of the generated task, used to uniquely identify this generation task.
  • request: The request information when the task was created.
  • response: The current or final return information of the task.
  • created_at: The task creation time, Unix timestamp (seconds, float).
  • started_at: The time when the task started executing, Unix timestamp (seconds, float).
  • finished_at: The time when the task was completed, Unix timestamp (seconds, float). This field is not returned if the task is not completed.
  • elapsed: The time taken for task execution, in seconds (float, rounded to 3 decimal places). This field is not returned if the task is not completed.

​
Batch Query Operation

When querying task details for multiple task IDs, set the action to retrieve_batch and pass the task ID array through ids:
The returned result will include the items and count fields, where items is the array of task details, and count is the number of tasks matched in this query.