happyhorse-1.0

Create HappyHorse 1.0 tasks through POST /v1/video/generations. The four workflows use their own model IDs; optional controls can be placed at the top level or in parameters.

Text to video
Image to video
Reference to video
Video edit

Create task

POST /v1/video/generations

cURL

curl --request POST \
  --url https://www.anyfast.ai/v1/video/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "happyhorse-1.0-t2v",
    "prompt": "A cat running on grass",
    "parameters": {"resolution": "720P", "ratio": "16:9", "duration": 5, "watermark": false}
  }'

200

{
  "id": "asyntask_jwgfhsG0m2aDjLmiiELRf74eoWmss6ya",
  "task_id": "asyntask_jwgfhsG0m2aDjLmiiELRf74eoWmss6ya",
  "object": "video",
  "model": "happyhorse-1.0-t2v",
  "status": "queued",
  "progress": 0,
  "created_at": 1777343862
}

Request headers

string

required

Bearer authentication in the form Bearer YOUR_API_KEY.

string

default:"application/json"

required

Request body format.

Request parameters

string

required

Must be happyhorse-1.0-t2v.

string

required

Text description of the video.

Query task by ID

GET /v1/video/generations/{task_id}

Request headers

string

required

Bearer authentication in the form Bearer YOUR_API_KEY.

string

default:"application/json"

required

Request body format.

Path parameters

string

required

Task ID returned by the create request.

cURL

curl --request GET \
  --url https://www.anyfast.ai/v1/video/generations/TASK_ID \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json'

200

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "asyntask_6rTCHZ9Xi7wXdmotOYsZP3o0XWWA1dOY",
    "action": "generate",
    "status": "SUCCESS",
    "result_url": "https://dashscope-a717.oss-accelerate.aliyuncs.com/.../xxx_refiner.mp4?Expires=...",
    "fail_reason": "https://dashscope-a717.oss-accelerate.aliyuncs.com/.../xxx_refiner.mp4?Expires=...",
    "submit_time": 1777343862,
    "start_time": 1777343866,
    "finish_time": 1777343961,
    "progress": "100%",
    "request_id": "20260731061043150392831bGTNOtlT",
    "data": {
      "output": {
        "task_id": "e45a6a1b-6f05-43e5-ab06-ddfdc97587a7",
        "task_status": "SUCCEEDED",
        "video_url": "https://dashscope-a717.oss-accelerate.aliyuncs.com/.../xxx_refiner.mp4?Expires=...",
        "orig_prompt": "A cat running on grass",
        "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"
      },
      "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
      }
    }
  }
}

Response fields

string

success when the task query succeeds.

string

Additional response message.

string

AnyFast task ID.

string

Workflow action used to process the task.

string

Task status, such as QUEUED, IN_PROGRESS, SUCCESS, or FAILURE.

string

Result video URL when the task succeeds.

string

Failure detail returned by the upstream task service. The service may populate this field with a result URL in successful responses.

integer

Task submission time as a Unix timestamp.

integer

Task processing start time as a Unix timestamp.

integer

Task completion time as a Unix timestamp.

string

Task progress percentage.

string

Request ID for the outer AnyFast response.

object

Upstream task output details.

string

Upstream task ID.

string

Upstream task status, such as SUCCEEDED.

string

Upstream result video URL.

string

Original prompt submitted for the task.

string

Upstream task submission time.

string

Upstream task scheduling time.

string

Upstream task completion time.

string

Request ID returned by the upstream task service.

object

Usage and output metrics returned by the upstream task service.

integer

Output super-resolution value.

number

Requested or generated video duration.

number

Input video duration.

number

Output video duration.

string

Output aspect ratio.

integer

Number of generated videos.

Create task

POST /v1/video/generations

cURL

curl --request POST \
  --url https://www.anyfast.ai/v1/video/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "happyhorse-1.0-i2v",
    "prompt": "Camera slowly zooms in as the scene comes to life",
    "image": "https://example.com/first-frame.png",
    "parameters": {"resolution": "720P", "duration": 5, "watermark": false}
  }'

200

{
  "id": "asyntask_jwgfhsG0m2aDjLmiiELRf74eoWmss6ya",
  "task_id": "asyntask_jwgfhsG0m2aDjLmiiELRf74eoWmss6ya",
  "object": "video",
  "model": "happyhorse-1.0-i2v",
  "status": "queued",
  "progress": 0,
  "created_at": 1777343862
}

Request headers

string

required

Bearer authentication in the form Bearer YOUR_API_KEY.

string

default:"application/json"

required

Request body format.

Request parameters

string

required

Must be happyhorse-1.0-i2v.

string

required

Text description of the desired motion.

string

required

First-frame image URL. images is also accepted, but only its first item is used.

Query task by ID

GET /v1/video/generations/{task_id}

Request headers

string

required

Bearer authentication in the form Bearer YOUR_API_KEY.

string

default:"application/json"

required

Request body format.

Path parameters

string

required

Task ID returned by the create request.

cURL

curl --request GET \
  --url https://www.anyfast.ai/v1/video/generations/TASK_ID \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json'

200

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "asyntask_6rTCHZ9Xi7wXdmotOYsZP3o0XWWA1dOY",
    "action": "firstTailGenerate",
    "status": "SUCCESS",
    "result_url": "https://dashscope-a717.oss-accelerate.aliyuncs.com/.../xxx_refiner.mp4?Expires=...",
    "fail_reason": "https://dashscope-a717.oss-accelerate.aliyuncs.com/.../xxx_refiner.mp4?Expires=...",
    "submit_time": 1777343862,
    "start_time": 1777343866,
    "finish_time": 1777348588,
    "progress": "100%",
    "request_id": "20260731061043150392831bGTNOtlT",
    "data": {
      "output": {
        "task_id": "e45a6a1b-6f05-43e5-ab06-ddfdc97587a7",
        "task_status": "SUCCEEDED",
        "video_url": "https://dashscope-a717.oss-accelerate.aliyuncs.com/.../xxx_refiner.mp4?Expires=...",
        "orig_prompt": "A cat running on grass",
        "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"
      },
      "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
      }
    }
  }
}

Response fields

string

success when the task query succeeds.

string

Additional response message.

string

AnyFast task ID.

string

Workflow action used to process the task.

string

Task status, such as QUEUED, IN_PROGRESS, SUCCESS, or FAILURE.

string

Result video URL when the task succeeds.

string

Failure detail returned by the upstream task service. The service may populate this field with a result URL in successful responses.

integer

Task submission time as a Unix timestamp.

integer

Task processing start time as a Unix timestamp.

integer

Task completion time as a Unix timestamp.

string

Task progress percentage.

string

Request ID for the outer AnyFast response.

object

Upstream task output details.

string

Upstream task ID.

string

Upstream task status, such as SUCCEEDED.

string

Upstream result video URL.

string

Original prompt submitted for the task.

string

Upstream task submission time.

string

Upstream task scheduling time.

string

Upstream task completion time.

string

Request ID returned by the upstream task service.

object

Usage and output metrics returned by the upstream task service.

integer

Output super-resolution value.

number

Requested or generated video duration.

number

Input video duration.

number

Output video duration.

string

Output aspect ratio.

integer

Number of generated videos.

Create task

POST /v1/video/generations

cURL

curl --request POST \
  --url https://www.anyfast.ai/v1/video/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "happyhorse-1.0-r2v",
    "prompt": "A woman in a red qipao gracefully unfolds a folding fan",
    "images": ["https://example.com/ref1.jpg", "https://example.com/ref2.jpg"],
    "parameters": {"resolution": "720P", "ratio": "16:9", "duration": 5, "watermark": false}
  }'

200

{
  "id": "asyntask_jwgfhsG0m2aDjLmiiELRf74eoWmss6ya",
  "task_id": "asyntask_jwgfhsG0m2aDjLmiiELRf74eoWmss6ya",
  "object": "video",
  "model": "happyhorse-1.0-r2v",
  "status": "queued",
  "progress": 0,
  "created_at": 1777343862
}

Request headers

string

required

Bearer authentication in the form Bearer YOUR_API_KEY.

string

default:"application/json"

required

Request body format.

Request parameters

string

required

Must be happyhorse-1.0-r2v.

string

required

Text description of the video.

string[]

required

1-3 reference image URLs.

Query task by ID

GET /v1/video/generations/{task_id}

Request headers

string

required

Bearer authentication in the form Bearer YOUR_API_KEY.

string

default:"application/json"

required

Request body format.

Path parameters

string

required

Task ID returned by the create request.

cURL

curl --request GET \
  --url https://www.anyfast.ai/v1/video/generations/TASK_ID \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json'

200

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "asyntask_6rTCHZ9Xi7wXdmotOYsZP3o0XWWA1dOY",
    "action": "referenceGenerate",
    "status": "SUCCESS",
    "result_url": "https://dashscope-a717.oss-accelerate.aliyuncs.com/.../xxx_refiner.mp4?Expires=...",
    "fail_reason": "https://dashscope-a717.oss-accelerate.aliyuncs.com/.../xxx_refiner.mp4?Expires=...",
    "submit_time": 1777343862,
    "start_time": 1777343866,
    "finish_time": 1777348588,
    "progress": "100%",
    "request_id": "20260731061043150392831bGTNOtlT",
    "data": {
      "output": {
        "task_id": "e45a6a1b-6f05-43e5-ab06-ddfdc97587a7",
        "task_status": "SUCCEEDED",
        "video_url": "https://dashscope-a717.oss-accelerate.aliyuncs.com/.../xxx_refiner.mp4?Expires=...",
        "orig_prompt": "A cat running on grass",
        "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"
      },
      "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
      }
    }
  }
}

Response fields

string

success when the task query succeeds.

string

Additional response message.

string

AnyFast task ID.

string

Workflow action used to process the task.

string

Task status, such as QUEUED, IN_PROGRESS, SUCCESS, or FAILURE.

string

Result video URL when the task succeeds.

string

Failure detail returned by the upstream task service. The service may populate this field with a result URL in successful responses.

integer

Task submission time as a Unix timestamp.

integer

Task processing start time as a Unix timestamp.

integer

Task completion time as a Unix timestamp.

string

Task progress percentage.

string

Request ID for the outer AnyFast response.

object

Upstream task output details.

string

Upstream task ID.

string

Upstream task status, such as SUCCEEDED.

string

Upstream result video URL.

string

Original prompt submitted for the task.

string

Upstream task submission time.

string

Upstream task scheduling time.

string

Upstream task completion time.

string

Request ID returned by the upstream task service.

object

Usage and output metrics returned by the upstream task service.

integer

Output super-resolution value.

number

Requested or generated video duration.

number

Input video duration.

number

Output video duration.

string

Output aspect ratio.

integer

Number of generated videos.

Create task

POST /v1/video/generations

cURL

curl --request POST \
  --url https://www.anyfast.ai/v1/video/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "happyhorse-1.0-video-edit",
    "input": {
      "prompt": "Make the character wear the striped sweater from the image.",
      "media": [
        {"type": "video", "url": "https://example.com/source.mp4"},
        {"type": "reference_image", "url": "https://example.com/sweater.png"}
      ]
    },
    "parameters": {"resolution": "720P", "watermark": false}
  }'

200

{
  "id": "asyntask_jwgfhsG0m2aDjLmiiELRf74eoWmss6ya",
  "task_id": "asyntask_jwgfhsG0m2aDjLmiiELRf74eoWmss6ya",
  "object": "video",
  "model": "happyhorse-1.0-video-edit",
  "status": "queued",
  "progress": 0,
  "created_at": 1777343862
}

Request headers

string

required

Bearer authentication in the form Bearer YOUR_API_KEY.

string

default:"application/json"

required

Request body format.

Request parameters

string

required

Must be happyhorse-1.0-video-edit.

string

required

Editing instruction. Maximum 5,000 non-Chinese or 2,500 Chinese characters.

object[]

required

Contains exactly one source-video item and 0-5 optional reference-image items.

string

required

video for the one source video or reference_image for an optional reference image.

string

required

Publicly accessible media URL.

string

default:"1080P"

720P or 1080P.

integer

Output duration follows the source video and this parameter might not take effect.

Query task by ID

GET /v1/video/generations/{task_id}

Request headers

string

required

Bearer authentication in the form Bearer YOUR_API_KEY.

string

default:"application/json"

required

Request body format.

Path parameters

string

required

Task ID returned by the create request.

cURL

curl --request GET \
  --url https://www.anyfast.ai/v1/video/generations/TASK_ID \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json'

200

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "asyntask_6rTCHZ9Xi7wXdmotOYsZP3o0XWWA1dOY",
    "action": "videoEdit",
    "status": "SUCCESS",
    "result_url": "https://dashscope-a717.oss-accelerate.aliyuncs.com/.../xxx_refiner.mp4?Expires=...",
    "fail_reason": "https://dashscope-a717.oss-accelerate.aliyuncs.com/.../xxx_refiner.mp4?Expires=...",
    "submit_time": 1777343862,
    "start_time": 1777343866,
    "finish_time": 1777348588,
    "progress": "100%",
    "request_id": "20260731061043150392831bGTNOtlT",
    "data": {
      "output": {
        "task_id": "e45a6a1b-6f05-43e5-ab06-ddfdc97587a7",
        "task_status": "SUCCEEDED",
        "video_url": "https://dashscope-a717.oss-accelerate.aliyuncs.com/.../xxx_refiner.mp4?Expires=...",
        "orig_prompt": "A cat running on grass",
        "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"
      },
      "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
      }
    }
  }
}

Response fields

string

success when the task query succeeds.

string

Additional response message.

string

AnyFast task ID.

string

Workflow action used to process the task.

string

Task status, such as QUEUED, IN_PROGRESS, SUCCESS, or FAILURE.

string

Result video URL when the task succeeds.

string

Failure detail returned by the upstream task service. The service may populate this field with a result URL in successful responses.

integer

Task submission time as a Unix timestamp.

integer

Task processing start time as a Unix timestamp.

integer

Task completion time as a Unix timestamp.

string

Task progress percentage.

string

Request ID for the outer AnyFast response.

object

Upstream task output details.

string

Upstream task ID.

string

Upstream task status, such as SUCCEEDED.

string

Upstream result video URL.

string

Original prompt submitted for the task.

string

Upstream task submission time.

string

Upstream task scheduling time.

string

Upstream task completion time.

string

Request ID returned by the upstream task service.

object

Usage and output metrics returned by the upstream task service.

integer

Output super-resolution value.

number

Requested or generated video duration.

number

Input video duration.

number

Output video duration.

string

Output aspect ratio.

integer

Number of generated videos.

Shared request parameters

string

default:"1080P"

720P or 1080P.

string

default:"16:9"

16:9, 9:16, 1:1, 4:3, or 3:4.

integer

default:5

Video duration from 3 to 15 seconds.

boolean

default:true

Whether to add the HappyHorse watermark.

integer

Random seed in [0, 2147483647].

Response

string

Created task ID.

string

Created task ID; use it for task queries.

string

Model used for task creation.

string

Initial task status.

integer

Initial task progress.

Error responses

400 Bad Request - Invalid input or unsupported parameter combination.
401 Unauthorized - API key is missing or invalid.
429 Rate limit exceeded - Request rate exceeded the applicable limit.

Overview

Native Compatible Endpoints

Model APIs

Create task

Request headers

Request parameters

Query task by ID

Request headers

Path parameters

Response fields

Create task

Request headers

Request parameters

Query task by ID

Request headers

Path parameters

Response fields

Response fields

Create task

Request headers

Request parameters

Query task by ID

Request headers

Path parameters

Response fields

Response fields

Create task

Request headers

Request parameters

Query task by ID

Request headers

Path parameters

Response fields

Response fields

Shared request parameters

Response

Error responses

​Create task

​Request headers

​Request parameters

​Query task by ID

​Request headers

​Path parameters

​Response fields

​Create task

​Request headers

​Request parameters

​Query task by ID

​Request headers

​Path parameters

​Response fields

​Response fields

​Create task

​Request headers

​Request parameters

​Query task by ID

​Request headers

​Path parameters

​Response fields

​Response fields

​Create task

​Request headers

​Request parameters

​Query task by ID

​Request headers

​Path parameters

​Response fields

​Response fields

​Shared request parameters

​Response

​Error responses

Create task

Request headers

Request parameters

Query task by ID

Request headers

Path parameters

Response fields

Create task

Request headers

Request parameters

Query task by ID

Request headers

Path parameters

Response fields

Response fields

Create task

Request headers

Request parameters

Query task by ID

Request headers

Path parameters

Response fields

Response fields

Create task

Request headers

Request parameters

Query task by ID

Request headers

Path parameters

Response fields

Response fields

Shared request parameters

Response

Error responses