创建视频

支持文生、图生和参考图生视频；请求体可使用平台统一字段或 input / parameters 结构。

POST/v1/video/generations

POST/v1/videos

使用平台统一结构或阿里原生 input / parameters 结构创建 HappyHorse 异步视频任务。两种结构会转换为相同的上游请求。

文生视频不需要图片；图生视频需要一张首帧图；参考生视频需要 1 到 9 张参考图，并可在提示词中使用 [Image 1]、[Image 2] 引用图片。

Authorization

bearerAuth

AuthorizationBearer <token>

在 Authorization Header 中使用 Bearer your-api-key。

In: header

Request Body

application/json

选择平台统一结构或阿里原生结构提交 HappyHorse 请求。

TypeScript Definitions

Use the request body type in TypeScript.

model*string

HappyHorse 模型 ID。happyhorse-1.0-t2v 用于文生视频，happyhorse-1.0-i2v 用于单张首帧图生视频，happyhorse-1.0-r2v 用于 1 到 9 张参考图生视频；实际可用模型以当前 API Key 返回的模型列表为准。

Length1 <= length

prompt*string

视频内容提示词。参考生视频可使用 [Image 1] 等标记引用参考图。

Length1 <= length

images?array<>

图生视频的首帧图片 URL，仅传一张。

Items1 <= items <= 1

reference_images?array<>

参考生视频使用的参考图片 URL，支持 1 到 9 张。

Items1 <= items <= 9

duration?integer

视频时长，单位为秒，支持 3 到 15，默认 5。

Range3 <= value <= 15

Default5

metadata?

Response Body

`application/json`

curl -X POST "https://example.com/v1/video/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "一座由硬纸板和瓶盖搭建的微型城市，在夜晚焕发生机。",    "duration": 5,    "metadata": {      "resolution": "1080p",      "ratio": "16:9",      "watermark": false,      "seed": 12345    }  }'

{
  "id": "video_123",
  "object": "video",
  "model": "MODEL_ID",
  "status": "queued",
  "progress": 0,
  "created_at": 1640995200
}

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`