Create a video

Supports text-to-video, image-to-video, and reference-image-to-video. The request body can use either the platform fields or the input / parameters structure.

POST/v1/video/generations

POST/v1/videos

Create an asynchronous HappyHorse video task with either the platform structure or the Alibaba-native input / parameters structure. Both structures are converted into the same upstream request.

Text-to-video does not require an image. Image-to-video requires one first-frame image. Reference-image-to-video requires 1–9 reference images, which can be referenced in the prompt with markers such as [Image 1] and [Image 2].

Authorization

bearerAuth

AuthorizationBearer <token>

Use Bearer your-api-key in the Authorization Header.

In: header

Request Body

application/json

Submit a HappyHorse request with either the platform structure or the Alibaba-native structure.

TypeScript Definitions

Use the request body type in TypeScript.

model*string

HappyHorse model ID. happyhorse-1.0-t2v is used for text-to-video, happyhorse-1.0-i2v for image-to-video with one first-frame image, and happyhorse-1.0-r2v for reference-image-to-video with 1–9 reference images. Available models are determined by the model list returned for the current API key.

Length1 <= length

prompt*string

Prompt describing the video content. Reference-image-to-video prompts can refer to reference images with markers such as [Image 1].

Length1 <= length

images?array<>

URL of the first-frame image for image-to-video. Provide exactly one image.

Items1 <= items <= 1

reference_images?array<>

Reference image URLs for reference-image-to-video. Supports 1–9 images.

Items1 <= items <= 9

duration?integer

Video duration in seconds. Supports 3–15 seconds and defaults to 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": "A miniature city built from cardboard and bottle caps comes alive at night.",    "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`