DMXAPI

Appearance

DMXAPI MiniMax-Hailuo-2.3 文生视频 API 使用文档 ​

MiniMax-Hailuo-2.3 是 MiniMax 海螺系列最新一代文生视频模型，支持通过纯文本描述生成高质量视频。模型支持 768P 和 1080P 两档分辨率，可生成 6 秒或 10 秒时长的视频，并内置 15 种专业运镜指令（左右移、左右摇、推拉、升降、上下摇、变焦、晃动、跟随、固定），通过 [指令] 语法即可实现精确的镜头控制。整个生成流程采用三步异步模式：提交任务获取 task_id → 轮询查询等待生成完成 → 获取下载链接下载视频。

接口地址 ​

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

支持的模型 ​

模型名称说明
MiniMax-Hailuo-2.3海螺最新一代文生视频模型，支持运镜指令，768P/1080P 分辨率

WARNING

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

文生视频 示例代码 ​

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】(enum<string>, 必填) 模型名称
    # 当前使用: "MiniMax-Hailuo-2.3"
    "model": "MiniMax-Hailuo-2.3",

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

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

    # 【fast_pretreatment】(boolean, 可选) 是否缩短 prompt_optimizer 的优化耗时
    # 默认值为 false，仅对 MiniMax-Hailuo-2.3 和 MiniMax-Hailuo-02 模型生效
    "fast_pretreatment": False,

    # 【duration】(integer, 可选) 视频时长（秒）
    # 默认值为 6，可用值与模型和分辨率相关:
    #   MiniMax-Hailuo-2.3 + 768P: 6 或 10
    #   MiniMax-Hailuo-2.3 + 1080P: 6
    "duration": 6,

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

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


# ═══════════════════════════════════════════════════════════════
# 步骤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": "418192546140443",
  "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": "418192546140443"
    }
}

# ═══════════════════════════════════════════════════════════════
# 步骤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-2.3），获得 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-2.3 文生视频

一个 Key 用全球大模型

Copyright © 2025 DMXAPI 版权所有