happyhorse-1.1

通过 POST /v1/video/generations 创建 HappyHorse 1.1 任务。三种工作流使用不同的模型 ID 和输入结构。

文生视频
图生视频
参考图生视频

创建任务

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": "夜晚，一座纸板搭建的微缩城市苏醒。"},
    "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
}

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

请求体格式。

请求参数

string

必填

必须为 happyhorse-1.1-t2v。

string

必填

文本提示，最多 5000 个非中文字符或 2500 个中文字符。

string

默认值:"1080P"

720P 或 1080P。

string

默认值:"16:9"

16:9、9:16、1:1、4:3、3:4、4:5、5:4、9:21 或 21:9。

查询任务（单个）

GET /v1/video/generations/{task_id}

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

请求体格式。

路径参数

string

必填

创建任务时返回的任务 ID。

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
      }
    }
  }
}

响应字段

string

查询成功时为 success。

string

附加响应消息。

string

AnyFast 任务 ID。

string

任务使用的工作流动作。

string

任务状态，例如 QUEUED、IN_PROGRESS、SUCCESS 或 FAILURE。

string

任务成功后的结果视频 URL。

string

上游任务服务返回的失败详情；成功响应中该字段也可能被填充为结果 URL。

integer

任务提交时间，Unix 时间戳。

integer

任务开始处理时间，Unix 时间戳。

integer

任务完成时间，Unix 时间戳。

string

任务进度百分比。

string

AnyFast 外层响应的请求 ID。

object

上游任务输出详情。

string

上游任务 ID。

string

上游任务状态，例如 SUCCEEDED。

string

上游结果视频 URL。

string

任务提交时使用的原始提示词。

string

上游任务提交时间。

string

上游任务调度时间。

string

上游任务完成时间。

string

上游任务服务返回的请求 ID。

object

上游任务服务返回的用量和输出指标。

integer

输出超分辨率值。

number

请求或生成的视频时长。

number

输入视频时长。

number

输出视频时长。

string

输出画面比例。

integer

生成的视频数量。

创建任务

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": "小猫从草地上快速跑过。",
      "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
}

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

请求体格式。

请求参数

string

必填

必须为 happyhorse-1.1-i2v。

object[]

必填

必须且只能包含一张首帧图片对象。

string

必填

必须为 first_frame。

string

必填

公网图片 URL 或 Base64 Data URL。

string

不支持；输出比例跟随首帧图片。

查询任务（单个）

GET /v1/video/generations/{task_id}

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

请求体格式。

路径参数

string

必填

创建任务时返回的任务 ID。

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
      }
    }
  }
}

响应字段

string

查询成功时为 success。

string

附加响应消息。

string

AnyFast 任务 ID。

string

任务使用的工作流动作。

string

任务状态，例如 QUEUED、IN_PROGRESS、SUCCESS 或 FAILURE。

string

任务成功后的结果视频 URL。

string

上游任务服务返回的失败详情；成功响应中该字段也可能被填充为结果 URL。

integer

任务提交时间，Unix 时间戳。

integer

任务开始处理时间，Unix 时间戳。

integer

任务完成时间，Unix 时间戳。

string

任务进度百分比。

string

AnyFast 外层响应的请求 ID。

object

上游任务输出详情。

string

上游任务 ID。

string

上游任务状态，例如 SUCCEEDED。

string

上游结果视频 URL。

string

任务提交时使用的原始提示词。

string

上游任务提交时间。

string

上游任务调度时间。

string

上游任务完成时间。

string

上游任务服务返回的请求 ID。

object

上游任务服务返回的用量和输出指标。

integer

输出超分辨率值。

number

请求或生成的视频时长。

number

输入视频时长。

number

输出视频时长。

string

输出画面比例。

integer

生成的视频数量。

创建任务

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]展开[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
}

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

请求体格式。

请求参数

string

必填

必须为 happyhorse-1.1-r2v。

object[]

必填

包含 1 至 9 张参考图对象。

string

必填

必须为 reference_image。

string

必填

公网图片 URL 或 Base64 Data URL。

string

默认值:"16:9"

16:9、9:16、1:1、4:3、3:4、4:5、5:4、9:21 或 21:9。

查询任务（单个）

GET /v1/video/generations/{task_id}

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

请求体格式。

路径参数

string

必填

创建任务时返回的任务 ID。

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
      }
    }
  }
}

响应字段

string

查询成功时为 success。

string

附加响应消息。

string

AnyFast 任务 ID。

string

任务使用的工作流动作。

string

任务状态，例如 QUEUED、IN_PROGRESS、SUCCESS 或 FAILURE。

string

任务成功后的结果视频 URL。

string

上游任务服务返回的失败详情；成功响应中该字段也可能被填充为结果 URL。

integer

任务提交时间，Unix 时间戳。

integer

任务开始处理时间，Unix 时间戳。

integer

任务完成时间，Unix 时间戳。

string

任务进度百分比。

string

AnyFast 外层响应的请求 ID。

object

上游任务输出详情。

string

上游任务 ID。

string

上游任务状态，例如 SUCCEEDED。

string

上游结果视频 URL。

string

任务提交时使用的原始提示词。

string

上游任务提交时间。

string

上游任务调度时间。

string

上游任务完成时间。

string

上游任务服务返回的请求 ID。

object

上游任务服务返回的用量和输出指标。

integer

输出超分辨率值。

number

请求或生成的视频时长。

number

输入视频时长。

number

输出视频时长。

string

输出画面比例。

integer

生成的视频数量。

通用请求参数

integer

默认值:5

视频时长，范围为 3 至 15 秒。

boolean

默认值:true

是否添加 HappyHorse 水印。

integer

[0, 2147483647] 范围内的随机种子。

响应

string

创建后的任务 ID。

string

创建后的任务 ID，用于查询任务。

string

创建任务所使用的模型。

string

任务初始状态。

integer

任务初始进度。

错误响应

400 Bad Request - 请求参数无效或参数组合不支持。
401 Unauthorized - API 密钥缺失或无效。
429 Rate limit exceeded - 请求超过适用的速率限制。

概览

原生兼容端点

模型 API

创建任务

请求头

请求参数

查询任务（单个）

请求头

路径参数

响应字段

创建任务

请求头

请求参数

查询任务（单个）

请求头

路径参数

响应字段

响应字段

创建任务

请求头

请求参数

查询任务（单个）

请求头

路径参数

响应字段

响应字段

通用请求参数

响应

错误响应

​创建任务

​请求头

​请求参数

​查询任务（单个）

​请求头

​路径参数

​响应字段

​创建任务

​请求头

​请求参数

​查询任务（单个）

​请求头

​路径参数

​响应字段

​响应字段

​创建任务

​请求头

​请求参数

​查询任务（单个）

​请求头

​路径参数

​响应字段

​响应字段

​通用请求参数

​响应

​错误响应

创建任务

请求头

请求参数

查询任务（单个）

请求头

路径参数

响应字段

创建任务

请求头

请求参数

查询任务（单个）

请求头

路径参数

响应字段

响应字段

创建任务

请求头

请求参数

查询任务（单个）

请求头

路径参数

响应字段

响应字段

通用请求参数

响应

错误响应