Files
Kunthawat Greethong 7edf5bc4d0 feat: Import 35+ skills, merge duplicates, add openclaw installer
Major updates:
- Added 35+ new skills from awesome-opencode-skills and antigravity repos
- Merged SEO skills into seo-master
- Merged architecture skills into architecture
- Merged security skills into security-auditor and security-coder
- Merged testing skills into testing-master and testing-patterns
- Merged pentesting skills into pentesting
- Renamed website-creator to thai-frontend-dev
- Replaced skill-creator with github version
- Removed Chutes references (use MiniMax API instead)
- Added install-openclaw-skills.sh for cross-platform installation
- Updated .env.example with MiniMax API credentials
2026-03-26 11:37:39 +07:00

4.8 KiB
Raw Permalink Blame History

MiniMax Video Generation API Documentation

API Endpoints

Endpoint Method Description
/v1/video_generation POST Create video generation task (all 4 modes)
/v1/query/video_generation GET Query task status
/v1/files/retrieve GET Get video download URL
/v1/video_template_generation POST Create template-based video task
/v1/query/video_template_generation GET Query template task status

Base URL: https://api.minimaxi.com Auth: Authorization: Bearer {MINIMAX_API_KEY}


Video Generation Models

Text-to-Video (T2V) Models

Model Resolution Duration Notes
MiniMax-Hailuo-2.3 768P (default), 1080P 6s (1080P), 6/10s (768P) Recommended, latest
MiniMax-Hailuo-2.3-Fast 768P (default), 1080P 6s (1080P), 6/10s (768P) Fast variant
MiniMax-Hailuo-02 512P, 768P (default), 1080P 6s (1080P), 6/10s (512P/768P) Previous gen
T2V-01-Director 720P 6s Director control
T2V-01 720P 6s Base model

Image-to-Video (I2V) Models

Model Resolution Duration Notes
MiniMax-Hailuo-2.3 768P, 1080P 6s Recommended
MiniMax-Hailuo-2.3-Fast 768P, 1080P 6s Fast variant
MiniMax-Hailuo-02 512P, 768P, 1080P 6/10s Previous gen
I2V-01-Director 720P 6s Director control
I2V-01-live 720P 6s Live photo style
I2V-01 720P 6s Base model

Start-End Frame Model

Model Notes
MiniMax-Hailuo-02 Only model supporting start-end frame

Subject Reference Model

Model Notes
S2V-01 Face consistency across video

Request Parameters

Common Parameters (All Modes)

Parameter Type Required Default Description
model string Yes - Model name
prompt string Depends - Video description, max 2000 chars
duration int No 6 Video length in seconds
resolution string No 768P/720P Video resolution
prompt_optimizer bool No true Auto-optimize prompt
fast_pretreatment bool No false Shorten optimizer duration
callback_url string No - Webhook URL
aigc_watermark bool No false Add watermark

Image-to-Video Parameters

Parameter Type Required Description
first_frame_image string Yes Starting frame (URL or base64 data URL)

Image requirements: JPG/JPEG/PNG/WebP, < 20MB, short side > 300px, aspect ratio 2:55:2.

Start-End Frame Parameters

Parameter Type Required Description
first_frame_image string Yes Starting frame
last_frame_image string Yes Ending frame

Subject Reference Parameters

Parameter Type Required Description
subject_reference array Yes Array of subject objects

Each object has type and image (array of image URLs):

[{ "type": "character", "image": ["<image_url>"] }]

Camera Instructions

Supported in [指令] syntax for Hailuo-2.3, Hailuo-02, and Director models:

Category Instructions
Pan [左移], [右移]
Rotation [左摇], [右摇]
Push/Pull [推进], [拉远]
Elevation [上升], [下降]
Tilt [上摇], [下摇]
Zoom [变焦推近], [变焦拉远]
Other [晃动], [跟随], [固定]

Combine for simultaneous: [左摇,上升] (max 3). Sequential: ...[推进], then ...[拉远]


Response

Query status: Preparing, Queueing, Processing, Success, Fail

Error codes: 0 (success), 1002 (rate limited), 1004 (auth failed), 1008 (insufficient balance), 1026 (sensitive content), 2013 (invalid params), 2049 (invalid API key)


Video Templates

Template ID Input Description
Diving 392753057216684038 Image Diving motion
Rings 393881433990066176 Image Gymnastics rings
Survival 393769180141805569 Image + Text Outdoor survival
Labubu 394246956137422856 Image Labubu character
McDonald's Delivery 393879757702918151 Image Pet courier
Tibetan Portrait 393766210733957121 Image Cultural portrait
Female Model Ads 393866076583718914 Image Female fashion
Male Model Ads 393876118804459526 Image Male fashion
Winter Romance 393857704283172856 Image Snowy portrait
Four Seasons 398574688191234048 Image Seasonal portrait
Helpless Moments 394125185182695432 Text only Comedic animation