Create Video (Reference-Image-to-Video)

POST

/v1/video/generations

Model ID

happyhorse-1.0-r2v

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Example

{
    "model": "happyhorse-1.0-r2v",
    "prompt": "The woman in the red cheongsam character1. The camera first captures the tailored and S-shaped curve of the cheongsam from a side medium shot, then switches to a low-angle overhead shot to capture the details of the dangling pendant character3 as it gently swings along with her head as she lifts her slender hands to unfold the fan character2. Finally, it zooms in to a close-up of her face, freezing the subtle charm as she gently touches the fan ribs with her fingertips and her eyes move with a gentle expression. The scene showcases the Eastern charm from multiple perspectives and in all directions.",
    "images": [
        "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/mvzfud/hh-v2v-girl.jpg",
        "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/fvuihk/hh-v2v2-folding-fan.jpg",
        "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/imerii/hh-v2v-earrings.jpg"
    ],
    "metadata": {
        "parameters": {
            "ratio": "9:16",
            "watermark": false,
            "duration": 4,
            "resolution": "1080P"
        }
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://www.aiide.com/v1/video/generations' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "happyhorse-1.0-r2v",
    "prompt": "The woman in the red cheongsam character1. The camera first captures the tailored and S-shaped curve of the cheongsam from a side medium shot, then switches to a low-angle overhead shot to capture the details of the dangling pendant character3 as it gently swings along with her head as she lifts her slender hands to unfold the fan character2. Finally, it zooms in to a close-up of her face, freezing the subtle charm as she gently touches the fan ribs with her fingertips and her eyes move with a gentle expression. The scene showcases the Eastern charm from multiple perspectives and in all directions.",
    "images": [
        "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/mvzfud/hh-v2v-girl.jpg",
        "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/fvuihk/hh-v2v2-folding-fan.jpg",
        "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260424/imerii/hh-v2v-earrings.jpg"
    ],
    "metadata": {
        "parameters": {
            "ratio": "9:16",
            "watermark": false,
            "duration": 4,
            "resolution": "1080P"
        }
    }
}'

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
    "id": "string",
    "task_id": "string",
    "object": "string",
    "model": "string",
    "status": "string",
    "progress": 0,
    "created_at": 0
}

🟠429Rate Limit

🟠400Bad Request

Modified at 2026-09-10 06:18:32

Create Video (First-Frame Image-to-Video)

Create Video (Video Editing)