DMXAPI

Appearance

DMXAPI MiniMax-Hailuo-02 首尾帧生成视频 API 使用文档 ​

MiniMax-Hailuo-02 首尾帧生成视频 API 支持上传首帧和尾帧两张图片，结合文本描述自动生成平滑过渡的视频。模型支持 15 种运镜指令（如左右摇、推拉、升降、变焦等），可通过 [指令] 语法实现精确的镜头控制，支持组合运镜与顺序运镜。输出视频支持 768P 和 1080P 两种分辨率，最长可生成 10 秒视频。

WARNING

请妥善保管您的 API Key！严禁将密钥泄露给他人、硬编码到代码中或提交到公开的代码仓库。

接口地址 ​

功能请求方式URL
提交任务POSThttps://www.dmxapi.cn/v1/responses
查询任务POSThttps://www.dmxapi.cn/v1/responses
下载视频POSThttps://www.dmxapi.cn/v1/responses

支持的模型 ​

模型名称说明
MiniMax-Hailuo-02首尾帧生成视频，提交任务
MiniMax-Hailuo-query查询视频生成任务状态
MiniMax-Hailuo-get获取生成视频的下载链接

首尾帧生成视频示例代码 ​

python
import requests
import json

# ═══════════════════════════════════════════════════════════════
# 步骤1: 配置 API 连接信息
# ═══════════════════════════════════════════════════════════════

# DMXAPI 服务端点地址
url = "https://www.dmxapi.cn/v1/responses"

# DMXAPI 密钥 (请替换为您自己的密钥)
# 获取方式: 登录 DMXAPI 官网 -> 个人中心 -> API 密钥管理
api_key = "sk-******************************************"

# ═══════════════════════════════════════════════════════════════
# 步骤2: 配置请求头
# ═══════════════════════════════════════════════════════════════

headers = {
    "Content-Type": "application/json",      # 指定请求体为 JSON 格式
    "Authorization": f"{api_key}",            # token 认证方式
}

# ═══════════════════════════════════════════════════════════════
# 步骤3: 配置请求参数
# ═══════════════════════════════════════════════════════════════

payload = {
    # 【input】(string, 可选) 视频的文本描述，最大 2000 字符
    # 支持使用 "[指令]" 语法进行运镜控制
    # 支持 15 种运镜指令:
    #   左右移: [左移], [右移]
    #   左右摇: [左摇], [右摇]
    #   推拉: [推进], [拉远]
    #   升降: [上升], [下降]
    #   上下摇: [上摇], [下摇]
    #   变焦: [变焦推近], [变焦拉远]
    #   其他: [晃动], [跟随], [固定]
    # 组合运镜: 同一组 [] 内多个指令同时生效，如 [左摇,上升]，建议不超过 3 个
    # 顺序运镜: prompt 中前后出现的指令依次生效
    "input": "A little girl grow up.",

    # 【first_frame_image】(string, 可选) 将指定图片作为视频的起始帧
    # 支持公网 URL 或 Base64 编码的 Data URL (data:image/jpeg;base64,...)
    # 图片要求: 格式 JPG/JPEG/PNG/WebP，体积小于 20MB
    # 尺寸: 短边像素大于 300px，长宽比在 2:5 和 5:2 之间
    # 生成视频尺寸遵循首帧图片
    "first_frame_image": "https://filecdn.minimax.chat/public/fe9d04da-f60e-444d-a2e0-18ae743add33.jpeg",

    # 【last_frame_image】(string, 必填) 将指定图片作为视频的结束帧
    # 支持公网 URL 或 Base64 编码的 Data URL (data:image/jpeg;base64,...)
    # 图片要求: 格式 JPG/JPEG/PNG/WebP，体积小于 20MB
    # 尺寸: 短边像素大于 300px，长宽比在 2:5 和 5:2 之间
    # 当首帧和尾帧图片尺寸不一致时，模型将参考首帧对尾帧图片进行裁剪
    "last_frame_image": "https://filecdn.minimax.chat/public/97b7cd08-764e-4b8b-a7bf-87a0bd898575.jpeg",

    # 【model】(enum<string>, 必填) 模型名称
    # 可选值: "MiniMax-Hailuo-02"
    # 注意: 首尾帧生成功能不支持 512P 分辨率
    "model": "MiniMax-Hailuo-02",

    # 【prompt_optimizer】(boolean, 可选) 是否自动优化 prompt
    # 默认值为 true，设为 false 可进行更精确的控制
    "prompt_optimizer": False,

    # 【duration】(integer, 可选) 视频时长（秒）
    # 默认值为 6
    # 768P 分辨率: 可选 6 或 10
    # 1080P 分辨率: 仅支持 6
    "duration": 6,

    # 【aigc_watermark】(boolean, 可选) 是否在生成的视频中添加水印
    # 默认值为 false
    "aigc_watermark": False,

    # 【resolution】(enum<string>, 可选) 视频分辨率
    # 可选值: "768P"(默认) / "1080P"
    # 6 秒视频: 支持 768P 和 1080P
    # 10 秒视频: 仅支持 768P
    "resolution": "1080P"
}

# ═══════════════════════════════════════════════════════════════
# 步骤4: 发送请求并输出结果
# ═══════════════════════════════════════════════════════════════

# 发送 POST 请求到 API 服务器
response = requests.post(url, headers=headers, json=payload)

# 格式化输出 JSON 响应
# - indent=2: 缩进 2 空格，便于阅读
# - ensure_ascii=False: 正确显示中文字符
print(json.dumps(response.json(), indent=2, ensure_ascii=False))

返回示例 ​

json
{
  "task_id": "418197520085420",
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  },
  "usage": {
    "total_tokens": 35000,
    "input_tokens": 0,
    "input_tokens_details": {
      "cached_tokens": 0
    },
    "output_tokens": 35000,
    "output_tokens_details": {
      "reasoning_tokens": 0
    }
  }
}

查询视频生成状态 示例代码 ​

python
import requests
import json

# ═══════════════════════════════════════════════════════════════
# 步骤1: 配置 API 连接信息
# ═══════════════════════════════════════════════════════════════

# DMXAPI 服务端点地址
url = "https://www.dmxapi.cn/v1/responses"

# DMXAPI 密钥 (请替换为您自己的密钥)
# 获取方式: 登录 DMXAPI 官网 -> 个人中心 -> API 密钥管理
api_key = "sk-******************************************"

# ═══════════════════════════════════════════════════════════════
# 步骤2: 配置请求头
# ═══════════════════════════════════════════════════════════════

headers = {
    "Content-Type": "application/json",      # 指定请求体为 JSON 格式
    "Authorization": f"{api_key}",            # token 认证方式
}

# ═══════════════════════════════════════════════════════════════
# 步骤3: 配置请求参数
# ═══════════════════════════════════════════════════════════════

payload = {
    # 【model】(string, 必填) 查询任务状态的模型标识
    # 固定值: "MiniMax-Hailuo-query"
    "model": "MiniMax-Hailuo-query",

    "input": {
        # 【task_id】(string, 必填) 提交任务时返回的任务 ID
        "task_id": "418197520085420"
    }
}

# ═══════════════════════════════════════════════════════════════
# 步骤4: 发送请求并输出结果
# ═══════════════════════════════════════════════════════════════

# 发送 POST 请求到 API 服务器
response = requests.post(url, headers=headers, json=payload)

# 格式化输出 JSON 响应
# - indent=2: 缩进 2 空格，便于阅读
# - ensure_ascii=False: 正确显示中文字符
print(json.dumps(response.json(), indent=2, ensure_ascii=False))

返回示例 ​

json
{
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  },
  "file_id": "418201399554182",
  "status": "Success",
  "task_id": "418197520085420",
  "usage": {
    "total_tokens": 0,
    "input_tokens": 0,
    "input_tokens_details": {
      "cached_tokens": 0
    },
    "output_tokens": 0,
    "output_tokens_details": {
      "reasoning_tokens": 0
    }
  },
  "video_height": 1080,
  "video_width": 1920
}

下载视频 示例代码 ​

python
import requests
import json

# ═══════════════════════════════════════════════════════════════
# 步骤1: 配置 API 连接信息
# ═══════════════════════════════════════════════════════════════

# DMXAPI 服务端点地址
url = "https://www.dmxapi.cn/v1/responses"

# DMXAPI 密钥 (请替换为您自己的密钥)
# 获取方式: 登录 DMXAPI 官网 -> 个人中心 -> API 密钥管理
api_key = "sk-******************************************"

# ═══════════════════════════════════════════════════════════════
# 步骤2: 配置请求头
# ═══════════════════════════════════════════════════════════════

headers = {
    "Content-Type": "application/json",      # 指定请求体为 JSON 格式
    "Authorization": f"{api_key}",            # token 认证方式
}

# ═══════════════════════════════════════════════════════════════
# 步骤3: 配置请求参数
# ═══════════════════════════════════════════════════════════════

payload = {
    # 【model】(string, 必填) 下载视频的模型标识
    # 固定值: "MiniMax-Hailuo-get"
    "model": "MiniMax-Hailuo-get",

    "input": {
        # 【file_id】(string, 必填) 查询任务时返回的文件 ID
        "file_id": "418201399554182"
    }
}

# ═══════════════════════════════════════════════════════════════
# 步骤4: 发送请求并输出结果
# ═══════════════════════════════════════════════════════════════

# 发送 POST 请求到 API 服务器
response = requests.post(url, headers=headers, json=payload)

# 格式化输出 JSON 响应
# - indent=2: 缩进 2 空格，便于阅读
# - ensure_ascii=False: 正确显示中文字符
print(json.dumps(response.json(), indent=2, ensure_ascii=False))

返回示例 ​

json
{
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  },
  "file": {
    "file_id": 418201399554182,
    "bytes": 0,
    "created_at": 1783658254,
    "filename": "output_aigc.mp4",
    "purpose": "video_generation",
    "download_url": "https://public-cdn-video-data-algeng.oss-cn-wulanchabu.aliyuncs.com/..."
  },
  "usage": {
    "total_tokens": 0,
    "input_tokens": 0,
    "input_tokens_details": {
      "cached_tokens": 0
    },
    "output_tokens": 0,
    "output_tokens_details": {
      "reasoning_tokens": 0
    }
  }
}

完整工作流程 ​

  1. 提交任务 → 调用 POST /v1/responses（model: MiniMax-Hailuo-02），上传首尾帧图片和文本描述，获得 task_id
  2. 轮询查询 → 定期调用 POST /v1/responses（model: MiniMax-Hailuo-query），传入 task_id，等待 status: "Success"，获得 file_id
  3. 下载视频 → 调用 POST /v1/responses（model: MiniMax-Hailuo-get），传入 file_id，获取 download_url 并下载视频文件

© 2026 DMXAPI MiniMax-Hailuo-02 首尾帧生成视频

一个 Key 用全球大模型

Copyright © 2025 DMXAPI 版权所有