Browse ModelsAlibabaAlibaba Happyhorse 1.1 Reference To Video

Alibaba Happyhorse 1.1 Reference To Video

Alibaba Happyhorse 1.1 Reference To Video

Playground

Try it on WavespeedAI!

Alibaba HappyHorse 1.1 Reference to Video generates new video scenes from reference images, preserving character identity, visual style, and scene consistency. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Alibaba Happy Horse 1.1 Reference-to-Video

Alibaba Happy Horse 1.1 Reference-to-Video generates new video scenes guided by one or more reference images, helping maintain consistent characters, styles, and visual identity across the output. It combines reference-image grounding with natural-language prompting to create cinematic videos in 720p or 1080p.


Why Choose This?

  • Reference-guided consistency
    Use one or more reference images to preserve character identity, visual style, outfit details, and overall scene language.

  • Prompt and image control
    Combine reference images with a text prompt to control the scene, action, mood, and camera behavior more precisely.

  • Cinematic motion
    Generate smooth, expressive video motion while keeping important visual elements stable and recognizable.

  • Flexible output settings
    Choose output resolution, aspect ratio, duration, and seed to match your creative and production needs.

  • Production-ready API
    Access the model through a REST inference API for scalable integration into apps and workflows.


Parameters

ParameterRequiredDescription
imagesYesReference image URLs. Supports 1–9 images.
promptYesText description of the desired scene, action, style, or motion.
resolutionNoOutput resolution: 720p default or 1080p.
aspect_ratioNoOutput aspect ratio. Default: 16:9.
durationNoVideo length in seconds. Range: 3–15, default 5.
seedNoRandom seed for reproducibility. Range: 0–2147483647.

How to Use

  1. Upload your reference images — Provide 1–9 image URLs that define the character, style, or visual identity you want to preserve.
  2. Write your prompt — Describe the target scene, action, camera behavior, lighting, and mood.
  3. Choose resolution — Use 720p for lower-cost iteration or 1080p for higher-resolution output.
  4. Set aspect ratio — Choose the format that best fits your target platform or composition needs.
  5. Set duration — Choose a clip length between 3 and 15 seconds.
  6. Set a seed optional — Use a fixed seed for more reproducible generations.
  7. Submit — Generate and download your video.

Example Prompt

A cinematic fashion scene with the same character walking through a softly lit modern city street at night, gentle camera tracking, subtle wind in the hair and clothing, elegant movement, realistic lighting, premium commercial style.


Pricing

Per 5 Seconds

ResolutionCost
720p$0.70
1080p$0.945

Per Second

ResolutionCost
720p$0.14
1080p$0.189

Example Costs

Resolution3s5s10s15s
720p$0.42$0.70$1.40$2.10
1080p$0.567$0.945$1.89$2.835

Best Use Cases

  • Character consistency across scenes — Keep the same person, outfit, or visual identity across multiple generated videos.
  • Brand and campaign content — Maintain a stable look and style across ad creatives, promos, and commercial storytelling.
  • Style-preserving video generation — Use reference images to anchor art direction, color palette, and visual tone.
  • Narrative concepting — Generate new scenes based on known characters or environments for storyboarding and ideation.
  • Social media and short-form content — Create visually consistent clips tailored to different platforms and aspect ratios.
  • Creative prototyping — Explore motion and scene variations while preserving core reference details.

Pro Tips

  • Use clear, high-quality reference images that strongly represent the character, outfit, or style you want to preserve.
  • Include multiple reference images when consistency across facial features, costume details, or design elements is important.
  • Be specific in your prompt about scene, action, camera motion, lighting, and mood.
  • Use 720p for rapid testing, then switch to 1080p for higher-resolution output.
  • Reuse the same seed when you want more reproducible outputs.
  • Start with shorter durations to validate identity consistency and motion before generating longer clips.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result


# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/alibaba/happyhorse-1.1/reference-to-video" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "duration": 5
}'

# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"

Parameters

Task Submission Parameters

Request Parameters

ParameterTypeRequiredDefaultRangeDescription
promptstringYes-Text description of the desired scene.
imagesarrayYes[]1 ~ 9 itemsArray of reference image URLs (1-9).
resolutionstringNo720p720p, 1080pOutput video resolution.
aspect_ratiostringNo16:916:9, 9:16, 1:1, 4:3, 3:4The aspect ratio of the generated video.
durationintegerNo53 ~ 15Video length in seconds (3-15).
seedintegerNo--1 ~ 2147483647Random seed for reproducibility.

Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
data.idstringUnique identifier for the prediction, Task Id
data.modelstringModel ID used for the prediction
data.outputsarrayArray of URLs to the generated content (empty when status is not completed)
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds

Result Request Parameters

ParameterTypeRequiredDefaultDescription
idstringYes-Task ID

Result Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
dataobjectThe prediction data object containing all details
data.idstringUnique identifier for the prediction, the ID of the prediction to get
data.modelstringModel ID used for the prediction
data.outputsobjectArray of URLs to the generated content (empty when status is not completed).
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds
© 2025 WaveSpeedAI. All rights reserved.