Skip to main content
After creating a HappyHorse 1.0 video generation task (any of t2v / i2v / r2v / video-edit), use this endpoint to poll the status and retrieve the result.

​
Endpoint

GET /v1/video/generations/{task_id}

​
Quick Example

curl https://ai.alad.com/v1/video/generations/asyntask_jwgfhsG0m2aDjLmiiELRf74eoWmss6ya \
  -H 'Authorization: Bearer YOUR_API_KEY'

​
Task Status

data.statusMeaningNext Action
NOT_STARTTask received, not yet startedContinue polling
QUEUEDQueuedContinue polling
IN_PROGRESSProcessing (progress increments from 50%)Continue polling, recommended 15s interval
SUCCESSCompleteRead data.result_url
FAILUREFailedRead data.fail_reason; platform auto-refunds
Video generation takes approximately 1–5 minutes. result_url is valid for 24 hours — download or transfer immediately.

​
Top-Level Response Fields

FieldTypeDescription
data.task_idstringPlatform task ID (format: asyntask_xxx)
data.actionstringTask subtype: generate / firstTailGenerate / referenceGenerate / omniGenerate
data.statusstringTask status (see table above)
data.result_urlstringPre-signed download URL, valid for 24 hours. Omitted for failed tasks
data.fail_reasonstringCopies result_url on success (for backward compatibility); contains error message on failure
data.submit_timeint64Submission timestamp (Unix seconds)
data.start_timeint64Upstream start timestamp; 0 if not started
data.finish_timeint64Completion timestamp
data.progressstringProgress percentage text, e.g. "50%", "100%"
data.request_idstringRequest tracing ID
data.dataobjectRaw upstream DashScope output + usage (see below)

​
data.data — Upstream DashScope Output

FieldDescription
output.task_idUpstream DashScope task ID (different from the outer task_id)
output.task_statusUpstream status: PENDING / RUNNING / SUCCEEDED / FAILED / CANCELED / UNKNOWN
output.video_urlVideo URL delivered by upstream (same as outer result_url)
output.orig_promptOriginal prompt echoed back
output.submit_time / scheduled_time / end_timeUpstream timestamps for each phase (string date format)
usage.SRActual resolution tier generated (number 720 / 1080)
usage.durationTotal billed duration
usage.input_video_durationInput video duration (0 for t2v / i2v / r2v; only present for video-edit)
usage.output_video_durationActual generated video duration
usage.ratioActual aspect ratio (only returned for t2v / r2v; not for i2v / video-edit)
usage.video_countNumber of videos (always 1)

​
Success Response

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "asyntask_jwgfhsG0m2aDjLmiiELRf74eoWmss6ya",
    "action": "generate",
    "status": "SUCCESS",
    "fail_reason": "https://dashscope-a717.oss-accelerate.aliyuncs.com/.../xxx_refiner.mp4?Expires=...",
    "result_url": "https://dashscope-a717.oss-accelerate.aliyuncs.com/.../xxx_refiner.mp4?Expires=...",
    "submit_time": 1777343862,
    "start_time": 1777343866,
    "finish_time": 1777343961,
    "progress": "100%",
    "request_id": "20260428023742441081000FMrSbjcs",
    "data": {
      "output": {
        "task_id": "e45a6a1b-6f05-43e5-ab06-ddfdc97587a7",
        "task_status": "SUCCEEDED",
        "submit_time": "2026-04-28 10:37:42.625",
        "scheduled_time": "2026-04-28 10:37:42.652",
        "end_time": "2026-04-28 10:39:04.185",
        "orig_prompt": "A cat running on a meadow",
        "video_url": "https://dashscope-a717.oss-accelerate.aliyuncs.com/.../xxx_refiner.mp4?Expires=..."
      },
      "request_id": "53121cad-c008-9b96-af1d-4289a4fc714b",
      "usage": {
        "SR": 720,
        "duration": 5,
        "input_video_duration": 0,
        "output_video_duration": 5,
        "ratio": "16:9",
        "video_count": 1
      }
    }
  }
}

​
Failure Response

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "asyntask_xxx",
    "action": "generate",
    "status": "FAILURE",
    "fail_reason": "task failed, code: InvalidParameter, message: Field required: input.prompt",
    "submit_time": 1777291928,
    "start_time": 0,
    "finish_time": 1777291932,
    "progress": "100%",
    "request_id": "20260427121207756348000PWNdDIZK"
  }
}
The platform automatically refunds the pre-charged quota — no action required from the caller.

API Reference

HappyHorse Task Query interactive Playground.