happyhorse-1.1

Create a HappyHorse 1.1 task with POST /v1/video/generations. Each workflow has its own model ID and input structure.

Text to video
Image to video
Reference to video

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.1-t2v",
    "input": {"prompt": "A miniature cardboard city comes to life at night."},
    "parameters": {
      "resolution": "720P",
      "ratio": "16:9",
      "duration": 5,
      "watermark": false,
      "seed": 42
    }
  }'

200

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

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.1-t2v.

string

required

Text prompt. Maximum 5,000 non-Chinese or 2,500 Chinese characters.

string

default:"1080P"

720P or 1080P.

string

default:"16:9"

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

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.1-i2v",
    "input": {
      "prompt": "The cat runs across the grass.",
      "media": [{"type": "first_frame", "url": "https://example.com/cat.png"}]
    },
    "parameters": {"resolution": "720P", "duration": 5, "watermark": false}
  }'

200

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

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.1-i2v.

object[]

required

Exactly one first-frame image object.

string

required

Must be first_frame.

string

required

Public image URL or Base64 data URL.

string

Not supported. The output follows the first-frame ratio.

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.1-r2v",
    "input": {
      "prompt": "[Image 1] opens the folding fan from [Image 2].",
      "media": [
        {"type": "reference_image", "url": "https://example.com/person.jpg"},
        {"type": "reference_image", "url": "https://example.com/fan.jpg"}
      ]
    },
    "parameters": {"resolution": "720P", "ratio": "16:9", "duration": 5, "watermark": false}
  }'

200

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

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.1-r2v.

object[]

required

1-9 reference image objects.

string

required

Must be reference_image.

string

required

Public image URL or Base64 data URL.

string

default:"16:9"

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

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.

Shared request parameters

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

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

​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

Shared request parameters

Response

Error responses