VARIANT · Alibaba / HappyHorse

happyhorse-image-to-video API

Alibaba / HappyHorse

Use happyhorse-image-to-video from the HappyHorse family via RunAPI. Per-call pricing, no subscription, and failed generations are never charged.

Operational · video · Commercial OK

runapi.ai

curl -X POST https://runapi.ai/api/v1/happyhorse/image_to_video \
  -H "Authorization: Bearer $RUNAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "happyhorse-image-to-video",
  "image_url": "https://cdn.runapi.ai/public/samples/image.jpg",
  "prompt": "Generate a 5-second 1080p cinematic clip of a paper horse galloping through a miniature cardboard city at night."
}'

import { HappyhorseClient } from "@runapi.ai/happyhorse";

const client = new HappyhorseClient();
const result = await client.imageToVideo.run({
    model: "happyhorse-image-to-video",
    image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
    prompt: "Generate a 5-second 1080p cinematic clip of a paper horse galloping through a miniature cardboard city at night.",
});

<?php

require __DIR__ . "/vendor/autoload.php";

use RunApi\Happyhorse\HappyhorseClient;

$client = new HappyhorseClient();
$result = $client->imageToVideo->run([
        'model' => 'happyhorse-image-to-video',
        'image_url' => 'https://cdn.runapi.ai/public/samples/image.jpg',
        'prompt' => 'Generate a 5-second 1080p cinematic clip of a paper horse galloping through a miniature cardboard city at night.',
]);

require "runapi/happyhorse"

client = RunApi::Happyhorse::Client.new
result = client.image_to_video.run(
    model: "happyhorse-image-to-video",
    image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
    prompt: "Generate a 5-second 1080p cinematic clip of a paper horse galloping through a miniature cardboard city at night."
)

npx skills add runapi-ai/happyhorse -g

# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp

# Codex
codex plugin install runapi-mcp@agents

# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor

@runapi.ai/happyhorse v1

Switch variant

happyhorse-character happyhorse-edit-video happyhorse-text-to-video

OVERVIEW

happyhorse-image-to-video targets the sweet spot of quality and cost within the HappyHorse family. It shares the same API key, request shape, and async task lifecycle as every other RunAPI model — switch to this variant by changing one model ID parameter. Install the HappyHorse skill to load docs, typed schemas, pricing notes, and setup steps into your coding workspace. Billing is metered per completed request in USD with no subscription or minimum spend, and failed generations are never charged.

Pay-per-call pricing in USD with no subscription
Failed generations are never charged
Streaming when supported by the model
Schema-validated parameters and tool calls
Switch variant by changing one model ID parameter
Unified billing across all models and providers

PRICING

Pricing

Failed generations are not charged

Image to video

$0.28-$0.48 / second

Output resolution: 720p $0.28

Output resolution: 1080p $0.48

SPEC SHEET

Technical details

Model ID	happyhorse-image-to-video
Provider	Alibaba
Modality	video
Task type	asynchronous
Billing unit	second
API endpoint	/api/v1/happyhorse/image_to_video
Commercial license	Yes — included via API
Catalog status	Operational

SKILLS

Model skill — happyhorse-image-to-video

Install the skill once, then use the variant ID from this page while building.

# Install the model skill for app development workflows
npx skills add runapi-ai/happyhorse -g

Installs docs, schemas, pricing context, and setup notes into your developer workspace.

Or use this setup request in your coding tool:

Install the HappyHorse skill for this app:

1. Add runapi-ai/happyhorse with the skills installer.
2. Load SKILL.md in this workspace.
3. Use its docs, schemas, pricing notes, and setup steps when adding model features.
4. Confirm the install path when done.

HOW IT WORKS

Use happyhorse-image-to-video with a model skill

Install

Install the model skill for the HappyHorse line. The skill loads docs, typed schemas, pricing notes, and setup steps into your coding workspace so your agent has the right context.

Configure

Set the model field to the full model ID shown on this page and configure your RunAPI API key as an environment variable. The same key works across all models and providers.

Call

Use the skill instructions while adding prompt, input, and callback handling to your application. RunAPI routes the request to the provider, manages the async lifecycle, and returns structured JSON.

Receive

Read the task response by polling the task ID, streaming when supported, or handling the webhook callback at your configured URL. Generated outputs are stored and retrievable by task ID.

DIFFERENCES

What's different about happyhorse-image-to-video

VS HAPPYHORSE-CHARACTER

3-15s image-to-video clips from one first-frame image

3-15s text-to-video clips guided by 1-9 ordered reference images

VS HAPPYHORSE-EDIT-VIDEO

3-15s image-to-video clips from one first-frame image

Prompted source-video edits with optional reference images

VS HAPPYHORSE-TEXT-TO-VIDEO

3-15s image-to-video clips from one first-frame image

3-15s text-to-video clips at 720p or 1080p

USE CASES

Best for

Ad & social content

Generate product launch clips and short-form ads from a text brief, cutting production from weeks to hours.

E-learning

Convert lesson scripts into animated explainer videos at scale without a camera or crew.

Creator workflows

Produce viral short-form content for social platforms directly from a prompt.

FAQ

Frequently asked questions about happyhorse-image-to-video

Is the model ID stable across versions?

Yes. RunAPI keeps the model ID stable and handles compatible version refreshes without changing your request shape. You do not need to update your code when the provider releases a new compatible version.

What's the rate limit on this variant?

Per-key rate limits scale with your usage tier. The pricing page shows current limits. If you need higher throughput, contact support to discuss tier upgrades.

Can I switch variants later?

Yes. Variant is a parameter in the request. Switch by changing the model ID — no code changes, no re-authentication, no separate billing setup. All variants share the same API key and request shape.

Does it stream?

Where streaming is available, RunAPI streams end-to-end. LLM models support token-level streaming. Media models use async task polling or webhook callbacks for result delivery.

Where do I report quality issues?

Open an issue on the public GitHub repo or email support at [email protected]. Include the task ID and model ID so the team can investigate the specific generation.

Do I need a separate provider account?

No. Your RunAPI API key is enough to access this variant and every other model in the catalog. You do not need accounts with the underlying provider.