# Alibaba | HappyHorse 1.0 | Image to Video

Generates video from images while preserving key details like subject, style, and text elements with high visual consistency across dynamic transitions.

## API Information

- **Model Slug:** alibaba-happyhorse-1-0-image-to-video
- **Branded URL:** https://www.eachlabs.ai/alibaba/happyhorse-1-0/alibaba-happyhorse-1-0-image-to-video
- **Provider:** Alibaba
- **Category:** Image to Video
- **Output Type:** video
- **Status:** active
- **Version:** 0.0.1
- **Base Cost:** 720P pricing: $0.14/sec
- **Estimated Processing Time:** 140 seconds
- **Last Updated:** 2026-06-01
- **Interactive Demo:** https://www.eachlabs.ai/ai-models/alibaba-happyhorse-1-0-image-to-video

## Pricing

- **Charge Type:** dynamic
- **Estimated Price (default example):** $0.7000
- **Pricing Details:** 720P pricing: $0.14/sec

### Pricing Rules

| Condition | Pricing |
| --- | --- |
| resolution == "720P" | 720P pricing: $0.14/sec |
| Rule 2 | 1080P pricing: $0.24/sec (default) |

## Input Schema

| Parameter | Type | Required | Default | Constraints | Description |
|-----------|------|----------|---------|-------------|-------------|
| prompt | string | No | - | - | Optional text description guiding the generated motion. Supports any language. Max 5,000 non-Chinese / 2,500 Chinese characters. |
| first_frame | string | Yes | - | - | URL of the image to use as the first frame. JPEG/JPG/PNG/WEBP. Min 300px each side. Aspect 1:2.5-2.5:1. Max 10MB. |
| resolution | string | No | 1080P | ["720P","1080P"] | Output resolution. 720P: lower cost, faster. 1080P: higher quality (default). |
| duration | integer | No | 5 | 3–15 | Video duration in seconds. Range: 3-15. Each second is billed separately. Default: 5. |
| seed | integer | No | - | 0–2147483647 | Seed for reproducibility. Same seed produces similar (not identical) results. Random if omitted. |

## Example Request

```bash
curl -X POST https://api.eachlabs.ai/v1/prediction/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "alibaba-happyhorse-1-0-image-to-video",
  "input": {
    "first_frame": "https://cdn-us.eachlabs.ai/uploads/3771631f-ba57-426a-a159-b63f5ef6cda1.png"
  }
}'
```

## Output Schema

Response returned by `GET /v1/prediction/{id}` when the job completes:

```json
{
  "status": "success",
  "predictionID": "string",
  "output": "string (URL of generated video)",
  "metrics": {
    "predict_time": "number (seconds)"
  }
}
```

## Polling

```bash
curl https://api.eachlabs.ai/v1/prediction/{PREDICTION_ID} \
  -H "X-API-Key: YOUR_API_KEY"
```

| Status | Meaning |
|--------|---------|
| `processing` | Still running — poll again |
| `success` | Done — read `output` |
| `error` | Failed — read `message` / `details` |

## Webhook (alternative to polling)

Pass `"webhook_url": "https://your.host/path"` in the create request. Eachlabs POSTs this payload when the job ends:

```json
{
  "exec_id": "prediction-uuid",
  "status": "succeeded",
  "output": "https://...",
  "error": ""
}
```

`status` is `"succeeded"` or `"failed"`. `exec_id` equals the `predictionID` from create. Return 2xx within 30 seconds.

## Errors

Error body: `{ "status": "error", "message": "...", "details": "..." }`

| Code | Meaning |
|------|---------|
| `400` | Invalid input |
| `401` | Missing / invalid `X-API-Key` |
| `404` | Unknown model or prediction id |
| `429` | Rate limit — 100 creates / min, 10 concurrent per key |
| `5xx` | Retry with backoff |

## Overview

**Alibaba | HappyHorse 1.0 | Image to Video Overview**

Alibaba | HappyHorse 1.0 | Image to Video transforms a single input image into physically realistic videos with smooth, natural motion, optionally guided by a text prompt. This Alibaba Cloud model, part of their advanced video generation suite, solves the challenge of animating static images into dynamic content while preserving the input's aspect ratio automatically. Its primary differentiator is the "First-frame-to-video" capability, using the provided image as the exact starting frame for seamless video extension. Ideal for creators needing quick, high-fidelity animations without complex setups, it supports 720P or 1080P resolutions and 3-15 second durations. Available via Alibaba Cloud Model Studio, this image-to-video tool stands out for realistic physics simulation in motion generation.

## Usage Notes

- API Base URL: `https://api.eachlabs.ai/v1`
- Authentication: send `X-API-Key: YOUR_API_KEY`. Generate a key from the Eachlabs dashboard at https://www.eachlabs.ai/dashboard/api-keys.
- File-typed parameters (`*_url`, `image_url`, `video_url`, `audio_url`, etc.) accept publicly-reachable HTTPS URLs only. Upload your asset first (GCS / S3 / your CDN) and pass the resulting URL. Data-URIs and localhost URLs are rejected.
- For structured parameters (arrays / objects) send real JSON values, not stringified payloads.
- Monetary values are reported in USD; per-token / per-megapixel rates may be billed in micro-cents internally.
- Prefer `webhook_url` over polling for long-running predictions — see the Webhook Callback section.