happyhorse-1.0

通过 POST /v1/video/generations 创建 HappyHorse 1.0 任务。四种工作流使用各自的模型 ID；可选控制参数可放在顶层或 parameters 中。

文生视频
图生视频
参考图生视频
视频编辑

创建任务

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": "一只猫在草地上奔跑",
    "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
}

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

请求体格式。

请求参数

string

必填

必须为 happyhorse-1.0-t2v。

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": "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.0-i2v",
    "prompt": "镜头缓缓拉近，画面逐渐动起来",
    "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
}

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

请求体格式。

请求参数

string

必填

必须为 happyhorse-1.0-i2v。

string

必填

预期动作的文本描述。

string

必填

首帧图片 URL。也支持 images，但只使用其中第一张。

查询任务（单个）

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.0-r2v",
    "prompt": "身着红色旗袍的女性轻抬玉手展开折扇",
    "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
}

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

请求体格式。

请求参数

string

必填

必须为 happyhorse-1.0-r2v。

string

必填

视频内容描述。

string[]

必填

1 至 3 张参考图 URL。

查询任务（单个）

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

生成的视频数量。

创建任务

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": "让视频中的角色穿上图片中的条纹毛衣。",
      "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
}

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

请求体格式。

请求参数

string

必填

必须为 happyhorse-1.0-video-edit。

string

必填

编辑指令，最多 5000 个非中文字符或 2500 个中文字符。

object[]

必填

有且仅有一条原始视频，另可选包含 0 至 5 张参考图。

string

必填

原始视频使用 video，可选参考图使用 reference_image。

string

必填

公网可访问的媒体 URL。

string

默认值:"1080P"

720P 或 1080P。

integer

输出时长由原始视频决定，该参数可能不生效。

查询任务（单个）

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

响应字段

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

生成的视频数量。

通用请求参数

string

默认值:"1080P"

720P 或 1080P。

string

默认值:"16:9"

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

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

创建任务

请求头

请求参数

查询任务（单个）

请求头

路径参数

响应字段

创建任务

请求头

请求参数

查询任务（单个）

请求头

路径参数

响应字段

响应字段

创建任务

请求头

请求参数

查询任务（单个）

请求头

路径参数

响应字段

响应字段

创建任务

请求头

请求参数

查询任务（单个）

请求头

路径参数

响应字段

响应字段

通用请求参数

响应

错误响应

​创建任务

​请求头

​请求参数

​查询任务（单个）

​请求头

​路径参数

​响应字段

​创建任务

​请求头

​请求参数

​查询任务（单个）

​请求头

​路径参数

​响应字段

​响应字段

​创建任务

​请求头

​请求参数

​查询任务（单个）

​请求头

​路径参数

​响应字段

​响应字段

​创建任务

​请求头

​请求参数

​查询任务（单个）

​请求头

​路径参数

​响应字段

​响应字段

​通用请求参数

​响应

​错误响应

创建任务

请求头

请求参数

查询任务（单个）

请求头

路径参数

响应字段

创建任务

请求头

请求参数

查询任务（单个）

请求头

路径参数

响应字段

响应字段

创建任务

请求头

请求参数

查询任务（单个）

请求头

路径参数

响应字段

响应字段

创建任务

请求头

请求参数

查询任务（单个）

请求头

路径参数

响应字段

响应字段

通用请求参数

响应

错误响应