hailuo

Generates videos from text prompts or images using the Hailuo AI API via Pixazo.

Updated May 2, 2026
One-click install
npx skills add https://github.com/Pixazo-AI/skills --skill hailuo-pixazo-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hailuo
Source: https://github.com/Pixazo-AI/skills/tree/main/skills/hailuo
Command: npx skills add https://github.com/Pixazo-AI/skills --skill hailuo-pixazo-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests.

What problem does it solve? Creating video content programmatically requires managing API authentication, choosing the right endpoint, and handling asynchronous polling. This Skill guides an AI agent through the entire Hailuo AI video generation workflow via the Pixazo API gateway, so users can produce videos with a single natural-language request. ## Core Features & Use Cases - Text-to-Video Generation: Submit a text prompt to Hailuo v2.3 and receive a generated video clip. - Image-to-Video Generation: Animate a first-frame image into a video with configurable duration, resolution, and prompt optimization. - Async Polling & Error Handling: Automatically poll the task status endpoint until the video is ready, with clear user-facing messages for 401, 402, 429, and 5xx errors. - Use Case: A content creator asks their coding agent to "make a 6-second video of a man walking into a winter cave with a polar bear" — the agent saves the API key once, submits the request, polls for completion, and returns the video URL. ## Quick Start Ask your agent to generate a short video from a text prompt or an image using Hailuo, and paste your Pixazo API key when prompted.

Frequently Asked Questions about hailuo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a video from text with Hailuo AI?▼

Send a POST request to https://gateway.pixazo.ai/minimax-hailuo-ai/v1/generate with your prompt and Pixazo API key in the Ocp-Apim-Subscription-Key header. The response returns a task_id that you poll until the video URL is ready.

How to animate an image into a video using the Hailuo API?▼

Use the imageToVideo endpoint with a first_frame_image URL, a prompt describing the motion, and parameters like duration (e.g. 6 seconds) and resolution (e.g. 768P). The API animates the still image into a video clip.

Where do I get a Pixazo API key for Hailuo video generation?▼

Sign in at https://api-console.pixazo.ai/api_keys, click "Create new key", and copy it. The key can be saved to ~/.pixazo/api-key or set as the PIXAZO_API_KEY environment variable so you only enter it once.

Why is my Hailuo video request returning a 401 or 402 error?▼

A 401 means the API key is missing or invalid, so generate a fresh key at the Pixazo console. A 402 means your account is out of credits, which you can top up at the Pixazo dashboard.

How long does Hailuo video generation take to complete?▼

Video generation is asynchronous; after submitting you poll the result endpoint every 5-10 seconds. A typical cap is around 10 minutes for video tasks before the status shows completed and returns the output URL.