Edit a video

Provide one input video and optionally up to five reference images. The request body can use either the platform structure or the Alibaba-native media structure.

POST/v1/videos/edits

Create an asynchronous video editing task with one input video and optional reference images. The platform structure uses input_reference and reference_images; the Alibaba-native structure uses input.media.

Video editing accepts one input video and up to five reference images. It does not support the ratio parameter.

Authorization

bearerAuth

AuthorizationBearer <token>

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

In: header

Request Body

application/json

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

TypeScript Definitions

Use the request body type in TypeScript.

model*string

HappyHorse video editing model ID. Recorded models include happyhorse-1.0-video-edit; available models are determined by the model list returned for the current API key.

Length1 <= length

prompt*string

Describe the desired video editing result.

Length1 <= length

input_reference*string

URL of the input video to edit. Provide exactly one video.

Formaturi

reference_images?array<>

Optional style or content reference image URLs, up to five images.

Itemsitems <= 5

metadata?

Response Body

`application/json`

curl -X POST "https://example.com/v1/videos/edits" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "Restyle the video with a warm golden cinematic look at sunset while preserving the subject\'s motion.",    "input_reference": "https://example.com/input.mp4",    "reference_images": [      "https://example.com/style-reference.png"    ],    "metadata": {      "resolution": "720p",      "duration": 5,      "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

`application/json`