典名词元典名词元首页
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-t2v

input*object

输入的基本信息,如提示词等。

prompt?string

文本提示词,用于描述期望生成的视频内容。

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

parameters*object

视频处理参数,如设置视频分辨率、设置视频时长等。

resolution?string

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

ratio?string

视频宽高比,默认 16:9,支持:16:9、9:16、1:1、4:3、3:4、4:5、5:4、9:21、21:9

duration?integer

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

watermark?string

是否在生成的视频上添加水印标识。水印位于视频右下角,文案固定为“Happy Horse”。

true:默认值,添加水印。

false:不添加水印。

seed?string

随机数种子,取值范围为[0, 2147483647]。

未指定时,系统自动生成随机种子。若需提升生成结果的可复现性,建议固定seed值。

请注意,由于模型生成具有概率性,即使使用相同 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"    },    "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"
}