VARIANT · MiniMax / Hailuo

hailuo-02-text-to-video-standard API

MiniMax / Hailuo

Use hailuo-02-text-to-video-standard from the Hailuo 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/hailuo/text_to_video \
  -H "Authorization: Bearer $RUNAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "hailuo-02-text-to-video-standard",
  "prompt": "Generate a 5-second clip of a glass marble rolling across a wooden desk and falling off the edge."
}'
import { HailuoClient } from "@runapi.ai/hailuo";

const client = new HailuoClient();
const result = await client.textToVideo.run({
    model: "hailuo-02-text-to-video-standard",
    prompt: "Generate a 5-second clip of a glass marble rolling across a wooden desk and falling off the edge.",
});
<?php

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

use RunApi\Hailuo\HailuoClient;

$client = new HailuoClient();
$result = $client->textToVideo->run([
        'model' => 'hailuo-02-text-to-video-standard',
        'prompt' => 'Generate a 5-second clip of a glass marble rolling across a wooden desk and falling off the edge.',
]);
require "runapi/hailuo"

client = RunApi::Hailuo::Client.new
result = client.text_to_video.run(
    model: "hailuo-02-text-to-video-standard",
    prompt: "Generate a 5-second clip of a glass marble rolling across a wooden desk and falling off the edge."
)
npx skills add runapi-ai/hailuo -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/hailuo v1
Switch variant
OVERVIEW

hailuo-02-text-to-video-standard targets the sweet spot of quality and cost within the Hailuo 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 Hailuo 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
Text to video
$0.30-$0.50 / video
Duration seconds: 6 $0.30
Duration seconds: 10 $0.50
SPEC SHEET

Technical details

Model ID hailuo-02-text-to-video-standard
Provider MiniMax
Modality video
Task type asynchronous
Billing unit call
API endpoint /api/v1/hailuo/text_to_video
Commercial license Yes — included via API
Status Operational
SKILLS

Model skill — hailuo-02-text-to-video-standard

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/hailuo -g
Installs docs, schemas, pricing context, and setup notes into your developer workspace.
Or use this setup request in your coding tool:
Install the Hailuo skill for this app:

1. Add runapi-ai/hailuo 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 hailuo-02-text-to-video-standard with a model skill

01

Install

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

02

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.

03

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.

04

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 hailuo-02-text-to-video-standard

VS HAILUO-02-IMAGE-TO-VIDEO-PRO

768p text-to-video; ~50% cheaper than Pro

1080p image-anchored video; image sets first frame

VS HAILUO-02-IMAGE-TO-VIDEO-STANDARD

768p text-to-video; ~50% cheaper than Pro

768p image-anchored video; budget tier

VS HAILUO-02-TEXT-TO-VIDEO-PRO

768p text-to-video; ~50% cheaper than Pro

1080p native text-to-video output

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 hailuo-02-text-to-video-standard

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.

START NOW

Start building with Hailuo.