# HappyHorse 1.0 Reference-to-Video API — pricing & specs

HappyHorse 1.0 Reference-to-Video is an Alibaba model that generates a video clip guided by reference images. On KeepRouter, HappyHorse 1.0 Reference-to-Video costs $0.1400 per second of video, billed pay-as-you-go with no monthly fee; the cost follows the clip's `duration`. Call it through a compatible KeepRouter endpoint supported by its active route, with the model id `happyhorse-1.0-r2v`.

| Spec | Value |
|---|---|
| Maker | Alibaba |
| Modality | Reference-to-video |
| Clip length | 3 to 15 seconds |
| Output price | $0.1400 per second of video |
| Capabilities | Reference-to-video, Asynchronous task: poll for the finished clip |
| Endpoint | POST /v1/video/generations, then GET /v1/videos/{id} |
| Model id | `happyhorse-1.0-r2v` |

## Call it via video generations endpoint

Submit the render to POST /v1/video/generations, then poll GET /v1/videos/{id} until status is completed and read url.

### cURL

```bash
# This model needs an input: media[0].type is "reference_image", and the URL must be fetchable by the provider.
# 1. Submit the render and keep the task id
TASK=$(curl -s https://keeprouter.com/v1/video/generations \
  -H "Authorization: Bearer $KEEPROUTER_KEY" -H "Content-Type: application/json" \
  -d '{"model":"happyhorse-1.0-r2v","prompt":"a paper plane gliding over a sunlit desk","duration":5,"media":[{"type":"reference_image","url":"https://keeprouter.com/editorial/blog/async-video-generation-api.png"}]}' \
  | python3 -c 'import json,sys; print(json.load(sys.stdin)["id"])')
# 2. Poll until the clip is ready
curl -s https://keeprouter.com/v1/videos/$TASK -H "Authorization: Bearer $KEEPROUTER_KEY"
```

### Python

```python
import os, time, requests
headers = {"Authorization": "Bearer " + os.environ["KEEPROUTER_KEY"]}
task = requests.post("https://keeprouter.com/v1/video/generations", headers=headers, json={
    "model": "happyhorse-1.0-r2v", "prompt": "a paper plane gliding over a sunlit desk", "duration": 5,
    "media": [{"type": "reference_image", "url": "https://keeprouter.com/editorial/blog/async-video-generation-api.png"}],
}).json()
while True:
    state = requests.get(f"https://keeprouter.com/v1/videos/{task['id']}", headers=headers).json()
    if state["status"] in ("completed", "failed", "canceled"):
        break
    time.sleep(5)
print(state["url"] or state["error"])
```

### JavaScript

```js
const headers = { Authorization: "Bearer " + process.env.KEEPROUTER_KEY, "Content-Type": "application/json" };
const task = await (await fetch("https://keeprouter.com/v1/video/generations", {
  method: "POST", headers,
  body: JSON.stringify({ model: "happyhorse-1.0-r2v", prompt: "a paper plane gliding over a sunlit desk", duration: 5, media: [{ type: "reference_image", url: "https://keeprouter.com/editorial/blog/async-video-generation-api.png" }] }),
})).json();
let state;
do {
  await new Promise((r) => setTimeout(r, 5000));
  state = await (await fetch("https://keeprouter.com/v1/videos/" + task.id, { headers })).json();
} while (state.status !== "completed" && state.status !== "failed" && state.status !== "canceled");
console.log(state.url ?? state.error);
```

## Estimate API costs

At the current KeepRouter customer price, an example workload of 6 seconds of generated video per request costs approximately $0.8400 per request. At 100 requests per day, that is $2520.00 over 30 days. This is a usage estimate, excluding processing fees, taxes, retries and application infrastructure. Actual usage, cache hits and supported generation durations need their own checks.

[Adjust quantities in the API cost calculator](/tools/api-cost-calculator?model=happyhorse-1.0-r2v).

## Model identity and official sources

Sources checked 2026-09-29.

### Who makes this model?

Alibaba develops the HappyHorse video model family. This entry belongs to HappyHorse 1.0.

[Alibaba Group · HappyHorse 1.0](https://home.alibabagroup.com/en-US/document-1985814249229778944)

### What does this variant do?

Reference images guide the generated clip's subjects and appearance.

[Alibaba Cloud · video models](https://www.alibabacloud.com/help/en/model-studio/video-generate-edit-model)

### Why are there multiple entries?

Four task types each have a 720p and a 1080p pricing tier on KeepRouter. This ID selects 720p; it uses the same r2v model as the other resolution tier. Alibaba documents 3–15-second, 24 fps MP4 output for HappyHorse 1.0.

[Alibaba Cloud · video models](https://www.alibabacloud.com/help/en/model-studio/video-generate-edit-model) · [KeepRouter · catalog tiers](https://keeprouter.com/models)

## How to evaluate HappyHorse 1.0 Reference-to-Video

HappyHorse 1.0 Reference-to-Video is listed on KeepRouter as reference-to-video under the exact id `happyhorse-1.0-r2v`. Use POST /v1/video/generations, then GET /v1/videos/{id} for the listed route; a maker's upstream features do not automatically apply to this gateway endpoint. No context limit is asserted here because the exact upstream limit has not been verified for this catalog entry.

**First workload:** Render one short representative clip, then inspect motion, consistency and the billed duration. Published duration range: 3–15 seconds.

**Before production:** Video generation is asynchronous and billed by generated seconds. Poll the task result; keep failed or refused jobs separate in your cost accounting.

## Public model usage evidence

No public, exact-variant usage figure has been verified for this KeepRouter model id. Missing data is not zero usage; family-level or maker-wide traffic is not presented as this model's traffic.

## Published examples and cases

No exact-model customer case has been verified for this entry. The workload above is an evaluation recipe, not a claim of a public deployment.

## Source and verification boundary

[Official HappyHorse 1.0 Reference-to-Video documentation](https://www.alibabacloud.com/help/en/model-studio/video-generate-edit-model). KeepRouter's live catalog is authoritative for the customer price and enabled endpoint shown here; the maker remains authoritative for upstream model capabilities and limits.

## Pricing and implementation guides

- [Calculate your API workload cost](https://keeprouter.com/tools/api-cost-calculator)
- [KeepRouter API keys: move from free to paid models](https://keeprouter.com/blog/keeprouter-api-key-free-to-paid)

## Related models

- [HappyHorse 1.0 Reference-to-Video (1080p)](https://keeprouter.com/models/happyhorse-1.0-r2v-1080p.md) by Alibaba — $0.2400 per second of video
- [HappyHorse 1.0 Image-to-Video (1080p)](https://keeprouter.com/models/happyhorse-1.0-i2v-1080p.md) by Alibaba — $0.2400 per second of video
- [HappyHorse 1.0 Text-to-Video](https://keeprouter.com/models/happyhorse-1.0-t2v.md) by Alibaba — $0.1400 per second of video
- [HappyHorse 1.0 Image-to-Video](https://keeprouter.com/models/happyhorse-1.0-i2v.md) by Alibaba — $0.1400 per second of video
- [HappyHorse 1.0 Text-to-Video (1080p)](https://keeprouter.com/models/happyhorse-1.0-t2v-1080p.md) by Alibaba — $0.2400 per second of video
- [Wan 2.7 Video Edit (1080p)](https://keeprouter.com/models/wan2.7-videoedit-1080p.md) by Alibaba — $0.1434 per second of video

## More

- [All models & pricing](https://keeprouter.com/models.md)
- [Quickstart](https://keeprouter.com/docs/quickstart.md)
- [Get an API key](https://keeprouter.com/login?returnTo=%2Fconsole%2Fkeys%3Fmodel%3Dhappyhorse-1.0-r2v)

_Catalog facts and prices last changed 2026-10-03._
_Page content reviewed 2026-09-28._