# Happy Horse 1.1

> Alibaba's Happy Horse 1.1 generates videos from text, animates a single image, or builds a video from multiple reference images. Supports 720p and 1080p, 3-15 second durations, and five aspect ratios.

- **Provider**: replicate
- **Model ID**: alibaba/happyhorse-1.1
- **Category**: video_generation
- **Credits**: 2090 per request
- **Pricing Type**: input_based

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `resolution` (string, optional): Output video resolution (Default: `1080p`; Options: `720p`, `1080p`)
- `prompt` (string, optional): Text prompt for video generation. Optional when a single image is provided (image-to-video). Required for text-to-video and reference-to-video. When providing multiple reference images, refer to them in the prompt as [Image 1], [Image 2], etc. (Default: ``)
- `seed` (integer, optional): Random seed for reproducible generation. Range: 0-2147483647 (Range: min: 0, max: 2147483647)
- `aspect_ratio` (string, optional): Aspect ratio of the generated video. Only applies to text-to-video and reference-to-video. When a single image is provided (image-to-video), the image's aspect ratio is used. (Default: `16:9`; Options: `16:9`, `9:16`, `1:1`, `4:3`, `3:4`)
- `images` (array, optional): Input images. Provide no images for text-to-video, one image to animate it as the first frame (image-to-video), or multiple images (up to 9) for reference-to-video. Accepts jpg/png/bmp/webp, <=10MB each, aspect ratio between 1:2.5 and 2.5:1, each side >=300px. (Default: `[]`)
- `duration` (integer, optional): Duration of the generated video in seconds (Default: `5`; Options: `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`; Range: min: 3, max: 15)

## Example Request

```json
{
  "model": "alibaba/happyhorse-1.1",
  "input": {
    "duration": 5,
    "aspect_ratio": "16:9",
    "prompt": "A majestic white horse gallops along a black-sand beach at golden hour, mane flowing in the wind, waves crashing in slow motion, cinematic tracking shot",
    "resolution": "1080p"
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "replicate",
  "model": "black-forest-labs/flux-schnell",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Output Type

url

## Tags

alibaba, happyhorse, video-generation, text-to-video, image-to-video, reference-to-video, multi-image, 1080p, 15-seconds

## Documentation

https://replicate.com/alibaba/happyhorse-1.1