海螺hailuo 视频模型 图生视频 API接口文档

概念介绍

海螺视频模型（Hailuo）是基于图像生成视频的AI模型，支持将静态图片转换为动态视频。通过输入参考图片和文本提示词，模型能够生成具有魔法效果、动态变化的短视频内容。

接口地址

POST https://www.dmxapi.cn/v1/video_generation

模型名称

MiniMax-Hailuo-02

请求参数

参数名	类型	必填	说明
model	string	是	模型名称：MiniMax-Hailuo-02
prompt	string	是	文本提示词，描述期望的视频效果
image	string	是	参考图片的URL地址
duration	int	否	视频时长（秒），支持6或10，默认6
resolution	string	否	视频分辨率，支持1080P或790P，默认1080P

请求头

• Authorization: Bearer ****** # 替换为您的API密钥
• Content-Type: application/json

示例代码

import json
import requests

# API配置
url = "https://www.dmxapi.cn/v1/video_generation"
api_key = "sk-**********************************"  # 替换 DMXAPI 令牌key

# 请求参数
payload = json.dumps({
    "model": "MiniMax-Hailuo-02",
    "prompt": "让书本打开，书里飞出有魔法的感觉",  # 视频效果描述
    "image": "https://dmxapi.cn/img/doc1.png",    # 参考图片URL
    "duration": 6,                                # 视频时长6秒
    "resolution": "1080P"                         # 1080P分辨率
})

# 请求头设置
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}

# 发送POST请求
response = requests.post(url, headers=headers, data=payload)

# 输出响应结果
print(response.text)

返回结果

成功调用后返回任务ID，用于后续查询生成结果：

{
  "task_id": "312219779297387",
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

注意事项

1. API密钥需要保密，不要泄露
2. 图片URL需要可公开访问
3. 视频生成需要一定时间，可通过task_id查询生成状态
4. 支持的分辨率：1080P（1920×1080）或790P（1344×790）
5. 支持的时长：6秒或10秒