Skip to content

Happy Horse · Reference to Video

Integrate

Model id alibaba/happy-horse/reference-to-video
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/alibaba/happy-horse/reference-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

This request: $1.40 1,400 API credits Run it on this page

Get API key
Alibaba Reference to Video Reference inputsLipsync3–15 sup to 1080p #stylized#transform

Generates video with native audio from a prompt plus 1 to 9 reference images for subject consistency

Alibaba · Video

Your first result goes here

Build a request below and run it with your API key. Outputs are copied to our storage, kept forever or 7 days for free.

Build a request

Controls are generated from the model schema. The code and the price update as you change them.

•required

Text describing the video to create, limited to 2500 characters. Identify image subjects with `character1`, `character2`, through `character9`, corresponding to their positions in `image_urls`.

•required image_urls
Drop a file, or

Subject-consistency references: supply 1–9 images, each no larger than 10 MB. Use JPEG, JPG, PNG, WEBP with a minimum shorter edge of 400 px; the recommended resolution is 720P or above.

duration 5 s

Length of the resulting video, from 3 to 15 seconds.

aspect_ratio default 16:9

Aspect ratio for the resulting video.

resolution default 1080p

Resolution tier for the resulting video.

Advanced seed · enable_safety_checker

Random seed enabling reproducible results, ranging from 0 to 2147483647.

POST /run/alibaba/happy-horse/reference-to-video?wait=20 quote → $1.40
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/alibaba/happy-horse/reference-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Run this request

Your key stays in this browser: it is sent only to the Doitong API and saved (localStorage) only if you tick Remember. Get an API key

About Happy Horse · Reference to Video

Creates a video from a `prompt` and 1 to 9 reference images in `image_urls`. Subjects are named in the prompt as character1 up to character9, in image order. `duration` is 3 to 15 seconds, `resolution` is 720p or 1080p, and `aspect_ratio` is 16:9, 9:16, 1:1, 4:3 or 3:4. The prompt is limited to 2500 characters.

Parameters

Send either the canonical name or the native name, not both. Canonical names

NameType DefaultAllowed Description
promptrequired
Typestring
Text describing the video to create, limited to 2500 characters. Identify image subjects with `character1`, `character2`, through `character9`, corresponding to their positions in `image_urls`.
image_urlsrequired images
Typeurl[] · image
Subject-consistency references: supply 1–9 images, each no larger than 10 MB. Use JPEG, JPG, PNG, WEBP with a minimum shorter edge of 400 px; the recommended resolution is 720P or above.
aspect_ratiooptional
Typeenum
Default16:9
16:99:161:14:33:4
Aspect ratio for the resulting video.
resolutionoptional
Typeenum
Default1080p
720p1080p
Resolution tier for the resulting video.
durationoptional
Typeenum
Default5
3456789101112131415
Length of the resulting video, from 3 to 15 seconds.
seedoptional
Typeinteger | null
Random seed enabling reproducible results, ranging from 0 to 2147483647.
enable_safety_checkeroptional
Typeboolean
Defaulttrue
Moderation of both input and output, enforced on every request unless the account is authorized to disable it and the option is turned off.
required Canonical name, also accepted

File parameters take a public https:// URL, a data: URI up to 10 MB, or the file_url of an upload. Files

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "alibaba/happy-horse/reference-to-video",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 1400,
    "usd": "1.40",
    "charged": 1400,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "fps": 1.0,
      "duration": 5,
      "num_frames": 1
    },
    "seed": 42
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Your files, your choiceEvery outputs[].url is a copy on our storage: kept forever (paid per GB-month) or 7 days for free, by your account setting or ?storage=.
Same shape on every modeltype, url, content_type, width, height and duration, for images, video and audio alike. output is the model’s own result object.
Fields of output
video
object {url, content_type, file_name, file_size, width, height, fps, duration, num_frames}Video file produced by generation.
seed
integerSeed value applied during generation.

More models: Reference to Video

For AI agents: this page as Markdown is at https://doitong.com/developers/models/alibaba/happy-horse/reference-to-video.md. All models and guides: https://doitong.com/developers/llms.txt