Runflow
Back to Gallery

alibaba/happy-horse/reference-to-video

Generate 1080p video with synchronized native audio from a text prompt and references. Aspect ratios: 16:9, 9:16, 1:1, 4:3, 3:4. Duration: 3–15s.

$0.14/second 2026-04-28

Install

pip install requests

Run the model

import requests

response = requests.post(
    "https://api.runflow.io/v1/run/happy-horse/reference-to-video",
    headers={"Authorization": "Bearer RUNFLOW_API_KEY"},
    json={
    "prompt": "character1 walks confidently down a neon-lit Tokyo street at night, cinematic...",
    "duration": 5,
    "image_urls": [
        "https://images.unsplash.com/photo-1535713875002-d1d0cf377fde?w=1024&q=80"
    ],
    "resolution": "720p",
    "aspect_ratio": "16:9"
    },
)

data = response.json()
print(data["video"]["url"])

Input schema

ParameterTypeDescription
promptstringText prompt describing the desired video. Reference subjects from your images using ``character1``, ``character2``, ... up to ``character9`` (the order matches the order of ``image_urls``). Max 2500 characters.
image_urlsimage_listReference images for subject consistency (1-9 images). Formats: JPEG, JPG, PNG, WEBP. Shortest side must be at least 400 px (720P or higher recommended). Max 10 MB each.
aspect_ratiostringAspect ratio of the generated video.
durationintegerOutput video duration in seconds (3-15).
enable_safety_checkerbooleanEnable content moderation for input and output.
resolutionstringOutput video resolution tier.
seedintegerRandom seed for reproducibility (0-2147483647).

Output schema

FieldTypeDescription
outputsjsonUnified output array — one entry per generated artifact with url/type/width/height/duration/etc.
seedjsonDeterministic seed used for generation, or null if the provider doesn't return one.
timingjsonProvider timing info (inference_ms etc.), or null.
nsfw_detectedjsontrue if the provider flagged output as NSFW, false if cleared, null if not checked.

Related models

Start generating with Happy Horse Reference-to-Video

Get API access in minutes. No GPU setup, no infrastructure to manage.