HappyHorse -- 文生视频 - 千问云

HappyHorse

HappyHorse -- 文生视频

提交 HappyHorse 文生视频任务

POST

/services/aigc/video-generation/video-synthesis

cURL - 文生视频

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
  -H 'X-DashScope-Async: enable' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "happyhorse-1.0-t2v",
  "input": {
    "prompt": "一座由硬纸板和瓶盖搭建的微型城市，在夜晚焕发出生机。一列硬纸板火车缓缓驶过，小灯点缀其间，照亮前路。"
  },
  "parameters": {
    "resolution": "720P",
    "ratio": "16:9",
    "duration": 5
  }
}'

{
  "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx",
  "output": {
    "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx",
    "task_status": "PENDING"
  }
}

输入文本提示词生成物理真实、运动流畅的视频，最长 15 秒，支持 1080P 分辨率。

鉴权

string

header

必填

千问云 API Key。详见获取 API Key。

Header 参数

enum<string>

必填

必须设置为 enable，表示异步提交任务。

可选值：enable

请求体

application/json

enum<string>

必填

模型名称。固定值：happyhorse-1.0-t2v。

可选值：happyhorse-1.0-t2v

示例:happyhorse-1.0-t2v

object

必填

模型的输入信息。

显示子属性

string

必填

文本提示词，用于描述期望生成的视频内容。支持任何语言输入，长度不超过5000个非中文字符或2500个中文字符，超过部分将自动截断。

示例:一座由硬纸板和瓶盖搭建的微型城市，在夜晚焕发出生机。

object

视频处理参数。

显示子属性

enum<string>

默认值"1080P"

指定生成视频的分辨率档位。

可选值：720P,1080P

enum<string>

默认值"16:9"

指定生成视频的宽高比。

可选值：16:9,9:16,1:1,4:3,3:4,4:5,5:4

integer

默认值5

指定生成视频的时长，单位为秒。取值为 [3, 15] 之间的整数。

取值范围：3 <= x <= 15

boolean

默认值true

是否在生成的视频上添加水印标识。水印位于视频右下角，文案固定为"Happy Horse"。true（默认）：添加水印。false：不添加水印。

integer

随机数种子。相同的种子和参数会生成相似（但不完全相同）的结果。

取值范围：0 <= x <= 2147483647

响应

200-application/json

string

请求唯一标识，用于链路追踪和问题排查。

示例:4909100c-7b5a-9f92-bfe5-xxxxxx

object

显示子属性

string

任务 ID，用于后续轮询查询任务状态。配合 GET /tasks/{task_id} 使用。

示例:0385dc79-5ff8-4d82-bcb6-xxxxxx

enum<string>

初始任务状态，通常为 PENDING。

可选值：PENDING,RUNNING,SUCCEEDED,FAILED

cURL - 文生视频

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
  -H 'X-DashScope-Async: enable' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "happyhorse-1.0-t2v",
  "input": {
    "prompt": "一座由硬纸板和瓶盖搭建的微型城市，在夜晚焕发出生机。一列硬纸板火车缓缓驶过，小灯点缀其间，照亮前路。"
  },
  "parameters": {
    "resolution": "720P",
    "ratio": "16:9",
    "duration": 5
  }
}'

{
  "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx",
  "output": {
    "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx",
    "task_status": "PENDING"
  }
}