典名词元典名词元首页
API 文档三方工具教程
AI 模型接口视频HappyHorse

参考生视频

POST/api/v1/video/generation

Header Parameters

Authorization*string

格式: Authorization: Bearer sk-xxxxxx

X-DashScope-Async*string

异步处理配置参数。HTTP请求只支持异步,必须设置为enable。

Request Body

application/json

model*string

模型名称,固定值: happyhorse-1.0-r2v

input*object

输入的基本信息,包括参考图像和提示词。

prompt?string

文本提示词。用来描述生成视频中期望包含的元素和视觉特点。

支持任何语言输入,长度不超过5000个非中文字符或2500个中文字符,超过部分会自动截断。

参考指代:在prompt中通过“[Image 1]、[Image 2]”标识指代media数组中对应位置的参考图像,顺序与media数组顺序一致。使用时需要指明参考图中的具体对象,例如“[Image 1]中身着红色旗袍的女性”。

media?array<object>

媒体素材列表,用于指定参考图像。

数组的每个元素为一个媒体对象,包含 type和 url字段。

按照数组顺序定义prompt中角色引用的顺序。

数组中的第 1 个reference_image对应 [Image 1],第 2 个对应 [Image 2],以此类推。

[]?object
type*string

媒体素材类型。固定值为:

reference_image:参考图像。

素材限制:

参考图像数量:1~9张。

url*string

参考图像URL或 Base64 编码数据。

parameters*object

视频处理参数,如设置视频分辨率、设置视频时长、开启prompt智能改写、添加水印等。

resolution?string

视频分辨率,支持:720P、1080P(默认值)。

ratio?string

生成视频的宽高比。

可选值:

16:9:默认值。

9:16

3:4

4:3

1:1

duration?integer

视频时长,单位秒,取值范围 [3, 15] 的整数,默认 5

watermark?string

是否在视频右下角添加水印标识(文案固定为"Happy Horse"),默认 true

seed?string

随机数种子,取值范围 [0, 2147483647]。固定 seed 值可提升生成结果的可复现性

Response Body

application/json

curl -X POST "https://api.aa.com.cn/api/v1/video/generation" \  -H "Authorization: string" \  -H "X-DashScope-Async: string" \  -H "Content-Type: application/json" \  -d '{    "model": "string",    "input": {      "prompt": "string",      "media": [        {          "type": "string",          "url": "string"        }      ]    },    "parameters": {      "resolution": "string",      "ratio": "string",      "duration": 0,      "watermark": "string",      "seed": "string"    }  }'
{
  "code": 0,
  "data": {
    "urls": [
      "string"
    ],
    "usage": {
      "images": 0,
      "seconds": 0,
      "input_tokens": 0,
      "total_tokens": 0,
      "output_tokens": 0
    },
    "expired": "string",
    "task_id": "string",
    "task_status": "string"
  },
  "message": "string",
  "request_id": "string"
}