Happy Horse 1.0 Reference to Video API

Alibaba Happy Horse 1.0 reference-to-video — multi-reference image input that preserves subject characters, driven by a text prompt. 720p / 1080p, 3-15 second clips. Integrate this model via REST with endpoint docs, parameters, and code examples.

Video Generation

Img2Vid

Credit Cost

20 credits

Type

video

Get API Key

Create auth keys for apps and agents

See Usage

Track requests, credits, and logs

Buy Credits

Top up prepaid API capacity

API Endpoint

POST

/api/v1/models/happyhorse-1.0-r2v/run

LLM.txt

AI-Ready

For AI assistants

Copy this model's documentation into Claude, GPT, or any AI for instant integration help.

/llm/happyhorse-1.0-r2v.txt

OpenAPI Spec

Swagger compatible

Import into Postman, Swagger UI, or generate client SDKs in any language.

/api/openapi

Parameters

Input parameters accepted by this model

Parameter	Type	Description	Default
`prompt` required	string	Text description of the video. Use character1 / character2 / … tokens to bind subjects to references.	-
`reference_urls` required	array	Reference image URLs (1-9). items: url min items: 1 \| max items: 9	-
`duration`	integer	Video duration in seconds (3-15). min: 3 \| max: 15	`5`
`resolution`	enum	Output resolution (case-insensitive — "720P"/"1080P" are normalized). `720p1080p`	`720p`
`aspectRatio`	enum	Output aspect ratio. `16:99:161:14:33:4`	`16:9`
`negative_prompt`	string	What to avoid in the video.	-
`seed`	integer	Random seed for reproducibility (0–2147483647). min: 0 \| max: 2147483647	-

Supported Aspect Ratios

16:9

9:16

1:1

4:3

3:4

Code Examples

Copy and paste to get started

bash

curl -X POST "https://pixeldojo.ai/api/v1/models/happyhorse-1.0-r2v/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A cinematic shot of ocean waves at sunset",
    "aspect_ratio": "16:9",
    "duration": 5
  }'

Response Format

Submit Response (202 Accepted)

json

{
  "jobId": "job_abc123...",
  "status": "pending",
  "statusUrl": "https://pixeldojo.ai/api/v1/jobs/job_abc123...",
  "creditCost": 20,
  "creditsRemaining": 95,
  "expiresAt": "2025-01-23T12:00:00Z"
}

Completed Response