happyhorse-1.0/reference-to-video

POST

/openapi/v2/alibaba/happyhorse-1.0/reference-to-video

HappyHorse 1.0 Reference-to-Video: generates short videos from multiple reference images plus a text prompt, keeping style alignment and smooth motion. Supports 720P/1080P, multiple aspect ratios and 3–15s duration — ideal for multi-image storytelling and consistent character/scene dynamics.

Request

Authorization

Header Params

Body Params application/jsonRequired

Example

{
    "prompt": "Combine the content of the two images: use the minimalist light-filled home from the first image as the background, and let the ancient-style woman from the second image perform subtle natural movements in the scene. Generate a video with smooth transitions and consistent style. Keep soft natural lighting, unified visual texture, natural integration of the character with the background, no visual errors or mismatches.",
    "imageUrls": [
        "https://www.runninghub.cn/view?filename=1a257306ea0855cb507b1683f2ef75d588f683bd5213905a1f31070a04eb7ebe.png&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3Nzc5MDM2OTE0MzQsInRzIjoxNzc3Mjk4ODkxNDM0LCJzaWduIjoiNjMzZTA1ZDgwNGRjMGNkNTBmYjljNjg0ZWIwZjZkZmEifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.7282892975291608"
    ],
    "resolution": "1080p",
    "aspectRatio": "16:9",
    "duration": "5"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://www.runninghub.ai/openapi/v2/alibaba/happyhorse-1.0/reference-to-video' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "Combine the content of the two images: use the minimalist light-filled home from the first image as the background, and let the ancient-style woman from the second image perform subtle natural movements in the scene. Generate a video with smooth transitions and consistent style. Keep soft natural lighting, unified visual texture, natural integration of the character with the background, no visual errors or mismatches.",
    "imageUrls": [
        "https://www.runninghub.cn/view?filename=1a257306ea0855cb507b1683f2ef75d588f683bd5213905a1f31070a04eb7ebe.png&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3Nzc5MDM2OTE0MzQsInRzIjoxNzc3Mjk4ODkxNDM0LCJzaWduIjoiNjMzZTA1ZDgwNGRjMGNkNTBmYjljNjg0ZWIwZjZkZmEifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.7282892975291608"
    ],
    "resolution": "1080p",
    "aspectRatio": "16:9",
    "duration": "5"
}'

Responses

🟢200成功

application/json

Task result query endpoint: /openapi/v2/query

Body

Examples

Submit response exampleTask success response example

{
    "taskId": "2013508786110730241",
    "status": "RUNNING",
    "errorCode": "",
    "errorMessage": "",
    "results": null,
    "clientId": "f828b9af25161bc066ef152db7b29ccc",
    "promptTips": "{\"result\": true, \"error\": null, \"outputs_to_execute\": [\"4\"], \"node_errors\": {}}"
}

Modified at 2026-04-28 04:00:16

seedance-2.0-global-fast/multimodal-video

Vidu-text-to-video-q2