HappyHorse 1.0 - Unifically

Generate videos using HappyHorse 1.0 with three modes: text-to-video, image-to-video (first frame), and reference-to-video (character consistency using reference images).

Model

alibaba/happyhorse-1.0-video

Modes

Mode	Description
`t2v`	Generate video from a text prompt
`i2v`	Generate video from a first frame image
`r2v`	Generate video from reference images. Use `characterN` in prompt to reference them

Parameters

Parameter	Type	Required	Default	Description
`mode`	string	No	`"t2v"`	`"t2v"`, `"i2v"`, or `"r2v"`
`prompt`	string	No	`""`	Text prompt describing the desired video. Supports any language. Max 5,000 non-Chinese characters or 2,500 Chinese characters; excess is truncated
`first_frame_url`	string	No	`null`	URL of the first frame image for I2V mode
`reference_image_urls`	string[]	No	`null`	Reference image URLs for R2V mode (1-9). Use `characterN` in prompt to reference them
`ratio`	string	No	`null`	Aspect ratio (T2V/R2V only): `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"`, `"3:4"`
`resolution`	string	No	`"1080P"`	`"720P"` or `"1080P"`
`duration`	integer	No	`5`	Output duration in seconds (3-15)
`watermark`	boolean	No	`false`	Add watermark to the output
`seed`	integer	No	`null`	Random seed for reproducible generation (0-2147483647)
`nsfw_check`	boolean	No	`true`	Check uploaded media inputs for NSFW content

Example - Text-to-Video

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "alibaba/happyhorse-1.0-video",
    "input": {
      "mode": "t2v",
      "prompt": "A golden retriever running through a field of wildflowers at sunset",
      "resolution": "1080P",
      "ratio": "16:9",
      "duration": 5
    }
  }'

Example - Image-to-Video

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "alibaba/happyhorse-1.0-video",
    "input": {
      "mode": "i2v",
      "prompt": "The camera slowly zooms out as the scene comes to life",
      "first_frame_url": "https://example.com/landscape.png",
      "resolution": "1080P",
      "duration": 10
    }
  }'

Example - Reference-to-Video

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "alibaba/happyhorse-1.0-video",
    "input": {
      "mode": "r2v",
      "prompt": "character1 walks confidently through a busy city street",
      "reference_image_urls": ["https://example.com/person.png"],
      "resolution": "1080P",
      "ratio": "16:9",
      "duration": 8
    }
  }'

Response

{
  "code": 200,
  "success": true,
  "data": {
    "task_id": "abc123def456",
    "status": "processing"
  }
}

Volume discounts are available for almost all models. Reach out at contact@unifically.com to discuss custom pricing.