Docs

Hailuo H3 API developer guide

Hailuo H3 is currently "Available". This guide provides model IDs, price snapshots, and copyable examples for integration. Hailuo H3 model page

Overview

Vendor: MiniMax
Type: Video
Number of tiers: 1
Endpoint tags: video-task

Available tiers and pricing

The model in requests must use the model IDs in the table below, case-sensitive.

Tier	Model ID	Input	Output	Context
Hailuo H3	`hailuo-3`	$0.083600–$0.272800 / 秒	总价由输出时长、参考媒体时长和所选档位共同计算	—

Prices are build-time snapshots; refer to the pricing page and console for the latest prices.

Base URL and authentication

Base URL is https://api.rokoapi.com/v1. All requests must include Authorization: Bearer $OPENAI_API_KEY.

Console

Quickstart

curl https://api.rokoapi.com/v1/videos/tasks \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "hailuo-3",
  "prompt": "A cinematic product shot with natural camera movement",
  "generation_type": "text",
  "duration": 4,
  "quality": "768p",
  "aspect_ratio": "16:9"
}'

Common parameters

Parameter	Description
`model`	Use the public model IDs from the table above.
`prompt` / `messages`	Input prompt, conversation messages, or generation instructions; format depends on the endpoint.
`quality` / `duration` / `image_urls`	Generation models can accept size, quality, duration, aspect ratio, or reference asset URLs based on model capabilities.

After a successful async generation task submission, a task ID is returned. Poll GET /v1/tasks/{task_id} until the status becomes completed or failed.

Notes

Use only the model IDs listed on this page; unprovisioned or retired names will return a model unavailable error.
If you encounter a 403 error, check your account balance, key group, and model access permissions.
Multimodal, tool calling, caching, and streaming capabilities depend on the upstream model and channel configuration; refer to actual responses.