reference-to-video

Happy Horse 1.1 - Create video from reference images

Generate a high-quality AI video guided by 1 to 9 reference images that define characters, objects or scenes using Happy Horse 1.1, Alibaba's reference-to-video model.

How to use references:

  • Provide 1 to 9 reference images via image_urls
  • Reference each image in the prompt by its 1-based positional index (character1, character2, ...)
  • The order of image_urls matches the character index in the prompt

Key features:

  • 720P and 1080P resolution support
  • 9 aspect ratio options
  • Duration range: 3-15 seconds
  • Optional bottom-right "Happy Horse" watermark
  • Prompt up to 5000 characters
post/v1/ai/reference-to-video/happy-horse-1-1

Request

  • Base URL: https://api.magnific.com
  • URL: https://api.magnific.com/v1/ai/reference-to-video/happy-horse-1-1
  • Auth: API key in header x-magnific-api-key

Request body

webhook_urlstring uri

Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.

promptstring required

Text prompt describing the desired elements and visual style of the generated video. Supports any language. Requests with prompts longer than 5000 characters are rejected by validation; the upstream provider further treats 5000 non-Chinese characters or 2500 Chinese characters as the effective ceiling.

Use character1, character2, ... in the prompt to reference the corresponding image in the image_urls array; the order matches the array order.

Example: "character1 and character2 walk together through a sunlit forest path"

aspect_ratio'16:9' | '9:16' | '1:1' | '4:3' | '3:4' | '21:9' | '9:21' | '5:4' | '4:5'

Output video aspect ratio:

  • 16:9: Landscape (widescreen)
  • 9:16: Portrait (vertical, mobile-optimized)
  • 1:1: Square
  • 4:3: Standard landscape
  • 3:4: Standard portrait
  • 21:9: Ultra-wide cinematic
  • 9:21: Ultra-tall vertical
  • 5:4: Classic landscape
  • 4:5: Classic portrait
resolution'720P' | '1080P'

Output video resolution:

  • 720P: 720p HD (1280x720)
  • 1080P: 1080p Full HD (1920x1080)
durationinteger

Duration of the generated video in seconds.

watermarkboolean

Whether to add a watermark to the generated video. The watermark appears in the bottom-right corner with the fixed text "Happy Horse".

seedinteger

Random seed for reproducibility. Use the same seed with identical parameters to improve reproducibility (does not guarantee identical results). Leave unset for a random seed.

Example request

{
  "webhook_url": "https://www.example.com/webhook",
  "prompt": "character1 and character2 walk together through a sunlit forest path",
  "image_urls": [
    {
      "url": "https://example.com/character1.jpg"
    }
  ],
  "duration": 5,
  "seed": 12345
}

Response

OK - The task exists and the status is returned

Example response

{
  "data": {
    "generated": [
      "https://openapi-generator.tech",
      "https://openapi-generator.tech"
    ],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "CREATED"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.