HappyHorse 1.0

授权

Authorization

string

header

必填

在请求 Header 中传入 Authorization: Bearer <YOUR_API_KEY>。前往 API Keys 管理页创建和管理 API Key。

请求体

application/json

model

string

必填

固定值 dashscope/happyhorse-1.0

prompt

string

提示词，长度不超过 5000 字符。支持中、英、日、韩等多语言。

参考生视频场景下，prompt 中可用 character1、character2 … 指代 reference_images 中第 N 张参考图（顺序与数组一致）。

示例:

"一座由硬纸板和瓶盖搭建的微型城市，在夜晚焕发出生机。一列硬纸板火车缓缓驶过，小灯点缀其间，照亮前路。"

resolution

enum<string>

默认值:1080P

输出分辨率，默认 1080P。

可用选项:

720P,

1080P

aspect_ratio

enum<string>

默认值:16:9

输出宽高比，默认 16:9。仅文生视频与参考生视频接受；图生视频-首帧（输出跟随首帧）、视频编辑（输出跟随源视频）不接受此参数。

可用选项:

16:9,

9:16,

1:1,

4:3,

3:4

duration

integer

默认值:5

视频时长（秒），默认 5，取值范围 3 ~ 15 的整数。视频编辑场景不接受此参数（输出时长跟随源视频，最长 15 秒）。

必填范围: 3 <= x <= 15

reference_images

object[]

参考图列表。按 reference_type 与 reference_videos 的组合决定输入模式：

图生视频-首帧：1 张 first_frame
参考生视频：1~9 张 asset，无 reference_videos
视频编辑：0~5 张 asset，配合 1 段 reference_videos

图片要求：格式 jpg / jpeg / png / webp；公网可访问 URL 或 data:image/ base64；首帧场景宽高 ≥ 300 px、宽高比 1:2.5 ~ 2.5:1、单张 ≤ 10 MB；参考生视频场景短边 ≥ 400 px，推荐 720P 以上。

Maximum array length: 9

Show child attributes

reference_videos

object[]

参考视频列表，视频编辑场景必填且仅 1 段。仅支持公网可访问 URL，不支持 base64。

视频要求：格式 mp4 / mov（建议 H.264 编码）；时长 3 ~ 60 秒（超过 15 秒会从头自动截取前 15 秒）；分辨率长边 ≤ 2160 px、短边 ≥ 320 px；宽高比 1:2.5 ~ 2.5:1；单段 ≤ 100 MB；FPS > 8。

Maximum array length: 1

Show child attributes

extra_params

object

模型扩展参数，全部选填：

audio_setting — 字符串，仅视频编辑场景生效。声音控制策略：
- auto（默认）：由模型自动决定
- origin：保留源视频的原始声音

Show child attributes

响应

提交成功（异步模式）

task_id

string

任务唯一 ID，用于后续轮询查询

示例:

"task_2044275355061448704"

model

string

本次任务使用的模型 ID

示例:

"dashscope/happyhorse-1.0"

created_at

string

任务创建时间（ISO 8601）

示例:

"2026-04-27T10:43:20.233Z"

request_id

string

请求唯一 ID

示例:

"67e2e394-cf6f-4998-b293-ebf20d14dc26"

图像模型 API

视频模型 API

授权

请求体

响应