HappyHorse 1.0

HappyHorse 1.0 是阿里云百炼的视频生成模型系列。四种能力共用 POST /v1/video/generations 创建端点，并通过不同的 AnyFast 模型 ID 选择工作流。

能力	AnyFast 模型 ID	主要输入
文生视频	`happyhorse-1.0-t2v`	文本提示词
图生视频	`happyhorse-1.0-i2v`	1 张首帧图片，可选提示词
参考生视频	`happyhorse-1.0-r2v`	文本提示词和 1–3 张参考图片
视频编辑	`happyhorse-1.0-video-edit`	编辑提示词、1 个视频和 0–5 张参考图片

创建接口立即返回任务 ID。使用 GET /v1/video/generations/{task_id} 轮询，直到 data.status 变为 SUCCESS 或 FAILURE。

能力示例

以下素材来自阿里云官方文档，仅用于展示各工作流的输入形式，不代表通过 AnyFast 复现的输出结果。

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

只需描述主体、动作、场景、风格、镜头和声音。模型可输出带音频的 MP4 视频。

创建任务

所有工作流都使用原生 input 和 parameters 结构。示例中的 720P、3 秒、极宽或极高比例、三张参考图以及视频编辑音频策略均已通过 AnyFast 国内节点验证。

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

cURL

curl --request POST \
  --url https://www.anyfast.com.cn/v1/video/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "happyhorse-1.0-t2v",
    "input": {
      "prompt": "夜色中的未来城市，镜头贴近地面快速向前推进"
    },
    "parameters": {
      "resolution": "720P",
      "ratio": "21:9",
      "duration": 3,
      "watermark": false,
      "seed": 0
    }
  }'

图生视频只接受一个 first_frame。不支持 ratio；输出宽高比自动跟随首帧。

cURL

curl --request POST \
  --url https://www.anyfast.com.cn/v1/video/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "happyhorse-1.0-i2v",
    "input": {
      "prompt": "镜头缓缓拉近，画面中的人物自然转头",
      "media": [
        {"type": "first_frame", "url": "https://example.com/first-frame.png"}
      ]
    },
    "parameters": {
      "resolution": "720P",
      "duration": 3,
      "watermark": false,
      "seed": 1
    }
  }'

cURL

curl --request POST \
  --url https://www.anyfast.com.cn/v1/video/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "happyhorse-1.0-r2v",
    "input": {
      "prompt": "让参考人物手持折扇走过灯火通明的长廊",
      "media": [
        {"type": "reference_image", "url": "https://example.com/person.jpg"},
        {"type": "reference_image", "url": "https://example.com/fan.jpg"},
        {"type": "reference_image", "url": "https://example.com/earrings.jpg"}
      ]
    },
    "parameters": {
      "resolution": "720P",
      "ratio": "9:21",
      "duration": 3,
      "watermark": false,
      "seed": 2
    }
  }'

audio_setting: "origin" 保留原视频音频，auto 让模型自动处理音频。不要传 duration 或 ratio。

cURL

curl --request POST \
  --url https://www.anyfast.com.cn/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.webp"}
      ]
    },
    "parameters": {
      "resolution": "720P",
      "watermark": false,
      "audio_setting": "origin",
      "seed": 2147483647
    }
  }'

输出控制

参数	文生视频	图生视频	参考生视频	视频编辑
`resolution`	`720P`、`1080P`	`720P`、`1080P`	`720P`、`1080P`	`720P`、`1080P`
`ratio`	9 种固定比例	不支持，跟随首帧	9 种固定比例	不支持，跟随输入视频
`duration`	3–15 秒	3–15 秒	3–15 秒	不支持自定义
`watermark`	默认 `true`	默认 `true`	默认 `true`	默认 `true`
`seed`	0–2147483647	0–2147483647	0–2147483647	0–2147483647
`audio_setting`	不支持	不支持	不支持	`auto`、`origin`

文生视频和参考生视频支持的 9 种比例为：16:9、9:16、1:1、4:3、3:4、4:5、5:4、9:21、21:9。

seed 超出 0–2147483647、时长小于 3 秒或大于 15 秒时，创建接口仍可能先返回任务 ID，随后任务异步失败。

输入要求

提示词

文生视频、参考生视频和视频编辑必须提供 input.prompt；图生视频可省略。
非中文提示词最多 5,000 个字符，中文提示词最多 2,500 个字符；超出部分由上游自动截断。

图生视频图片

input.media 必须且只能包含 1 个 first_frame。
图片必须为公网可下载的 URL；输出比例跟随首帧，不要传 ratio。

参考生视频图片

AnyFast 当前节点支持 1–3 个 reference_image；不支持 reference_video。
每张图片使用公网可下载的 URL。

视频编辑素材

input.media 必须且只能包含 1 个 video，并可包含 0–5 个 reference_image。
视频：MP4 或 MOV，推荐 H.264；3–60 秒；长边不超过 4096 px、短边不低于 360 px；宽高比 1:2.5–2.5:1；不超过 100 MB；帧率高于 8 FPS。
参考图片：JPEG、JPG、PNG 或 WEBP；宽高均不低于 300 px；宽高比 1:2.5–2.5:1；单张不超过 20 MB。
输入视频不超过 15 秒时，输出时长大体跟随输入；超过 15 秒时，仅处理前 15 秒。

查询和保存结果

cURL

curl --request GET \
  --url https://www.anyfast.com.cn/v1/video/generations/TASK_ID \
  --header 'Authorization: Bearer YOUR_API_KEY'

轮询 data.status：NOT_START、QUEUED 和 IN_PROGRESS 时继续等待；SUCCESS 时读取 data.result_url；FAILURE 时读取 data.fail_reason。成功响应中的 fail_reason 也可能被兼容层填为结果 URL，因此必须以 status 判断任务是否成功。结果 URL 通常只保留 24 小时，请及时下载或转存。

快速开始

模型 API

资源

能力示例

创建任务

输出控制

输入要求

提示词

图生视频图片

参考生视频图片

视频编辑素材

查询和保存结果

相关文档

​能力示例

​创建任务

​输出控制

​输入要求

​提示词

​图生视频图片

​参考生视频图片

​视频编辑素材

​查询和保存结果

​相关文档

能力示例

创建任务

输出控制

输入要求

提示词

图生视频图片

参考生视频图片

视频编辑素材

查询和保存结果

相关文档