MiniMax 视频生成技能

功能概览

工作流程

1. 提交任务 → 获取 task_id
2. 轮询状态 → 显示进度 (Preparing → Queueing → Processing → Success/Fail)
3. 自动下载 → 保存到本地（URL有效期短，需立即保存）

快速开始

文生视频

import requests
import os

API_KEY = os.getenv("MINIMAX_API_KEY")

response = requests.post(
    "https://api.minimaxi.com/v1/video_generation",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    },
    json={
        "model": "MiniMax-Hailuo-2.3",
        "prompt": "一只猫在草地上玩耍 [左摇,上升]",
        "duration": 6,
        "resolution": "1080P"
    }
)

task_id = response.json()["task_id"]

# 查询状态
status_resp = requests.get(
    f"https://api.minimaxi.com/v1/query/video_generation?task_id={task_id}",
    headers={"Authorization": f"Bearer {API_KEY}"}
)
status = status_resp.json()["status"]

# 下载视频
if status == "Success":
    file_id = status_resp.json()["file_id"]
    
    # 获取下载链接（有效期1小时，需立即下载）
    file_resp = requests.get(
        f"https://api.minimaxi.com/v1/files/retrieve?file_id={file_id}",
        headers={"Authorization": f"Bearer {API_KEY}"}
    )
    download_url = file_resp.json()["file"]["download_url"]
    
    # 保存到本地
    save_dir = "~/.openclaw/workspace/assets/videos"
    os.makedirs(save_dir, exist_ok=True)
    save_path = os.path.join(save_dir, f"video_{task_id}.mp4")
    
    video_resp = requests.get(download_url, timeout=120)
    with open(save_path, 'wb') as f:
        f.write(video_resp.content)

图生视频

import base64

with open("start_image.jpg", "rb") as f:
    img_base64 = base64.b64encode(f.read()).decode()

response = requests.post(
    "https://api.minimaxi.com/v1/video_generation",
    headers={"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"},
    json={
        "model": "MiniMax-Hailuo-2.3",
        "first_frame_image": f"data:image/jpeg;base64,{img_base64}",
        "prompt": "人物转身离开 [右移]",
        "duration": 6,
        "resolution": "1080P"
    }
)

首尾帧生成视频

response = requests.post(
    "https://api.minimaxi.com/v1/video_generation",
    headers={"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"},
    json={
        "model": "MiniMax-Hailuo-02",
        "first_frame_image": "https://example.com/start.jpg",
        "last_frame_image": "https://example.com/end.jpg",
        "prompt": "小女孩成长",
        "duration": 6,
        "resolution": "1080P"
    }
)

支持的模型

文生视频模型

图生视频模型

运镜指令

支持 15 种运镜指令，可在 prompt 中使用 [指令] 语法：

使用规则

• 组合运镜：同一组 [] 内多个指令同时生效，如 [左摇,上升]，建议不超过 3 个
• 顺序运镜：前后出现的指令依次生效，如 ...[推进], 然后...[拉远]

输入图片要求

任务状态

输出目录

生成的视频保存在：~/.openclaw/workspace/assets/videos/

注意：下载链接有效期仅 1 小时，生成后立即保存到本地。

错误码

脚本工具

• scripts/generate_video.py - 文生视频 + 图生视频（自动保存本地，显示进度）

命令行用法

# 文生视频
python generate_video.py "一只猫在草地上玩耍" --model MiniMax-Hailuo-2.3 --duration 6 --resolution 1080P

# 图生视频
python generate_video.py "人物转身" --model MiniMax-Hailuo-2.3 --first-image path/to/image.jpg

# 首尾帧生成
python generate_video.py "小女孩成长" --model MiniMax-Hailuo-02 --first-image start.jpg --last-image end.jpg

# 查询任务状态
python generate_video.py --query --task-id 123456789

API 参考

详细文档见 references/video-api.md。