Retrieve a video

Use the task ID returned by a create or edit endpoint to retrieve its status and result. Both retrieval paths use the same authentication, parameters, and response structure.

GET/v1/video/generations/{task_id}

GET/v1/videos/{task_id}

Use the task ID to retrieve a HappyHorse task. This path returns the platform envelope; task status and results are in the root data field.

Authorization

bearerAuth

AuthorizationBearer <token>

Use Bearer your-api-key in the Authorization Header.

In: header

Path Parameters

task_id*string

HappyHorse task ID returned by a create or edit endpoint.

Length1 <= length

Response Body

`application/json`

curl -X GET "https://example.com/v1/video/generations/task_id_here"

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "task_id_here",
    "action": "textGenerate",
    "status": "SUCCESS",
    "fail_reason": null,
    "submit_time": 1640995200,
    "start_time": 1640995210,
    "finish_time": 1640995290,
    "progress": "100%",
    "data": {
      "output": {
        "task_id": "task_id_here",
        "task_status": "SUCCEEDED",
        "video_url": "https://example.com/video.mp4"
      },
      "request_id": "REQUEST_ID",
      "usage": {
        "duration": 5,
        "output_video_duration": 5,
        "ratio": "16:9",
        "video_count": 1
      }
    }
  }
}

Authorization

Path Parameters

Response Body

200application/json

400application/json

401application/json

403application/json

404application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`