海螺视频生成示例

以下示例展示如何使用海螺（Hailuo）视频生成模型通过 OpenAI 兼容接口生成高质量的视频内容。海螺视频生成分为三个步骤：

创建视频生成任务 - 提交生成请求，获得任务ID
查询任务状态 - 定期检查任务进度
下载生成的视频 - 任务完成后下载视频文件

支持的参数

通用参数

model: 使用的模型名称
prompt: 视频描述文本（必需，最大2000字符，支持中英文）
seconds (string, 可选): 生成视频的时长，单位为秒
- 重要: seconds直接影响费用，请在调用前确认模型价格
- MiniMax-Hailuo-2.3: 可选值为”6”、“10”，默认值为”6”
- MiniMax-Hailuo-02: 可选值为”6”、“10”，默认值为”6”
- 示例值：“6”
content.text (string, 可选): 视频描述文本，用于指导视频生成的内容和风格
- 使用说明: 在使用 content 数组格式时，通过 text 类型的 content 元素来传递视频描述
- 支持语言: 中文和英文
- 内容要求: 描述应该详细、具体，有助于模型理解所需生成的视频内容
- 与 prompt 的关系: 二选一即可
- 运镜控制: 支持[指令]语法进行运镜控制，如[推进]、[拉远]、[旋转]等
- 示例值：“一只可爱的小猫在花园里玩耍，阳光明媚，画面温馨[推进特写]”
content.image_url.url (string, 可选): 输入图像的公网可访问的HTTP/HTTPS链接或Base64编码
- 重要: 链接不能包含中文等非ASCII字符，否则需要进行编码后再传入
- 本地文件: 可通过上传文件获取临时URL，或使用Base64编码
- 格式: JPG、JPEG、PNG、BMP、WEBP
- 尺寸: 图像的宽度和高度都在合理范围内，建议宽高比与视频分辨率匹配
- 文件大小: 建议不超过10MB
- 示例值：https://example.com/input_image.jpg

扩展参数

prompt_optimizer (boolean, 可选): 是否自动优化prompt，使用大模型对输入prompt进行智能优化
- true: 默认值，开启智能优化，能显著提升生成质量
- false: 不开启智能优化，使用原始prompt
- 示例值：true
fast_pretreatment (boolean, 可选): 是否缩短prompt_optimizer的优化耗时
- false: 默认值，使用标准优化流程，质量更佳
- true: 快速优化模式，减少耗时但可能影响优化效果
- 注意: 仅对MiniMax-Hailuo-2.3和MiniMax-Hailuo-02生效
- 示例值：false
aigc_watermark (boolean, 可选): 是否在生成的视频中添加AI生成水印标识
- false: 默认值，不添加水印
- true: 添加水印，水印通常位于视频角落
- 示例值：false

文生视频模型介绍

以下是海螺文生视频支持的各个模型及其规格说明：

模型名称	模型简介	输出视频规格
MiniMax-Hailuo-2.3 🌟推荐	海螺2.3旗舰版最新一代视频生成模型，画质和动态效果显著提升	• 视频时长：6秒、10秒 • 固定规格：25fps、MP4 (H.264编码)
MiniMax-Hailuo-02 🌟推荐	海螺2.0专业版成熟稳定的视频生成模型，综合性能优秀	• 视频时长：6秒、10秒 • 固定规格：25fps、MP4 (H.264编码)

步骤1：创建视频生成任务

curl --request POST \
  --url https://model-api.skyengine.com.cn/v1/videos \
  --header 'Authorization: Bearer <API-KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-Hailuo-2.3",
    "prompt": "在未来科技城市的高楼天台上，一位身穿发光服装的女孩正在练习太极拳，城市的霓虹灯光在夜幕中闪烁，远处可见飞行汽车穿梭[缓慢推进][俯拍视角]",
    "seconds": "6",
    "prompt_optimizer": true,
    "fast_pretreatment": false,
    "aigc_watermark": false
  }'

响应示例

{
  "id": "hailuo-task-eff1443c-ccab-4676-aad3-xxxxxx",
  "object": "video.generation", 
  "created_at": 1762776961,
  "model": "MiniMax-Hailuo-2.3",
  "status": "in_progress"
}

步骤2：查询任务状态

# 查询任务状态
curl -X GET "https://model-api.skyengine.com.cn/v1/videos/hailuo-task-eff1443c-ccab-4676-aad3-xxxxxx" \
  --header 'Authorization: Bearer <API-KEY>'

状态响应示例

待处理:

{
  "id": "hailuo-task-eff1443c-ccab-4676-aad3-xxxxxx",
  "object": "video.generation",
  "model": "MiniMax-Hailuo-2.3",
  "status": "pending"
}

处理中:

{
  "id": "hailuo-task-eff1443c-ccab-4676-aad3-xxxxxx",
  "object": "video.generation",
  "model": "MiniMax-Hailuo-2.3", 
  "status": "in_progress"
}

已完成:

{
  "id": "hailuo-task-eff1443c-ccab-4676-aad3-xxxxxx",
  "object": "video.generation",
  "model": "MiniMax-Hailuo-2.3",
  "status": "completed",
  "completed_at": 1762777061,
  "url": "https://file.minimaxi.com/video/xxx.mp4?token=xxx"
}

步骤3：下载生成的视频

# 下载视频文件
curl -X GET "https://model-api.skyengine.com.cn/v1/videos/hailuo-task-eff1443c-ccab-4676-aad3-xxxxxx/content" \
  --header 'Authorization: Bearer <API-KEY>' \
  --output hailuo_video.mp4

图生视频-首帧示例

海螺支持基于图片生成视频（首帧生成），以下是图生视频-首帧的示例：

curl --request POST \
  --url https://model-api.skyengine.com.cn/v1/videos \
  --header 'Authorization: Bearer <API-KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-Hailuo-2.3",
    "content": [
      {
        "type": "text",
        "text": "基于这张图片，让画面中的人物开始优雅地舞蹈，背景中的樱花花瓣随着微风轻柔飘舞，营造出诗意浪漫的氛围[缓慢旋转][梦幻滤镜]"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://cdn.hailuoai.com/prod/2024-09-18-16/user/multi_chat_file/9c0b5c14-ee88-4a5b-b503-4f626f018639.jpeg"
        },
        "role": "first_frame"
      }
    ],
    "seconds": "6",
    "prompt_optimizer": true,
    "aigc_watermark": false
  }'

# 使用 Base64 编码图片的示例
curl --request POST \
  --url https://model-api.skyengine.com.cn/v1/videos \
  --header 'Authorization: Bearer <API-KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-Hailuo-2.3",
    "content": [
      {
        "type": "text",
        "text": "根据图片内容生成动态视频，保持画面风格一致"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8/5+hHgAHggJ/PchI7wAAAABJRU5ErkJggg=="
        },
        "role": "first_frame"
      }
    ],
    "prompt_optimizer": false
  }'

图生视频-首尾帧示例

注意: MiniMax-Hailuo-2.3 不支持首尾帧模式，请使用 MiniMax-Hailuo-02 模型。海螺支持基于首帧和尾帧图片生成视频，以下是首尾帧生成视频的示例：

curl --request POST \
  --url https://model-api.skyengine.com.cn/v1/videos \
  --header 'Authorization: Bearer <API-KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-Hailuo-02",
    "content": [
      {
        "type": "text",
        "text": "A little girl grow up."
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://filecdn.minimax.chat/public/fe9d04da-f60e-444d-a2e0-18ae743add33.jpeg"
        },
        "role": "first_frame"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://filecdn.minimax.chat/public/97b7cd08-764e-4b8b-a7bf-87a0bd898575.jpeg"
        },
        "role": "last_frame"
      }
    ],
    "seconds": "6",
    "prompt_optimizer": true,
    "fast_pretreatment": false
  }'

运镜控制语法

海螺视频生成支持在prompt中使用[指令]语法进行运镜控制，常用指令包括：

镜头运动

[推进] - 镜头向前推进
[拉远] - 镜头向后拉远
[左移] - 镜头向左平移
[右移] - 镜头向右平移
[上升] - 镜头向上运动
[下降] - 镜头向下运动
[旋转] - 镜头旋转运动
[环绕] - 镜头环绕主体

镜头角度

[俯拍] - 从上往下拍摄
[仰拍] - 从下往上拍摄
[侧面] - 侧面角度拍摄
[正面] - 正面角度拍摄

镜头景别

[远景] - 远距离拍摄
[全景] - 展现完整场景
[中景] - 中等距离拍摄
[近景] - 较近距离拍摄
[特写] - 特写镜头
[微距] - 微距特写

视觉效果

[慢镜头] - 慢动作效果
[快镜头] - 快动作效果
[梦幻滤镜] - 梦幻视觉效果
[电影感] - 电影级视觉效果
[温暖色调] - 温暖色彩风格
[冷色调] - 冷色彩风格

使用示例

"一只小猫在花园里玩耍[推进特写]，阳光透过树叶洒在地面上[俯拍角度]，微风轻拂花瓣[慢镜头]"

完整工作流示例

import time
import requests

def complete_hailuo_video_workflow(prompt, **kwargs):
    """
    海螺视频生成完整工作流
    
    Args:
        prompt: 视频描述
        **kwargs: 其他参数
    
    Returns:
        视频文件路径
    """
    print("🎬 开始海螺视频生成流程...")
    
    # 步骤1: 创建任务
    print("📝 创建视频生成任务...")
    task_result = create_hailuo_video(prompt, **kwargs)
    if not task_result:
        print("❌ 任务创建失败")
        return None
    
    task_id = task_result['id']
    print(f"✅ 任务创建成功，ID: {task_id}")
    
    # 步骤2: 等待完成
    print("⏳ 等待视频生成完成...")
    max_attempts = 60  # 最多等待10分钟
    attempt = 0
    
    while attempt < max_attempts:
        status_result = check_hailuo_video_status(task_id)
        if not status_result:
            print("❌ 状态查询失败")
            return None
        
        status = status_result.get('status')
        print(f"📊 当前状态: {status}")
        
        if status == 'completed':
            print("🎉 视频生成完成!")
            break
        elif status == 'failed':
            print("❌ 视频生成失败")
            error = status_result.get('error', {})
            print(f"错误信息: {error.get('message', '未知错误')}")
            return None
        
        # 等待10秒后再次查询
        time.sleep(10)
        attempt += 1
    
    if attempt >= max_attempts:
        print("⏰ 等待超时")
        return None
    
    # 步骤3: 下载视频
    print("📥 下载视频文件...")
    output_path = f"hailuo_video_{int(time.time())}.mp4"
    success = download_hailuo_video(task_id, output_path)
    
    if success:
        print(f"✅ 视频下载成功: {output_path}")
        return output_path
    else:
        print("❌ 视频下载失败")
        return None

# 使用示例
video_path = complete_hailuo_video_workflow(
    prompt="在森林深处的小溪边，一只优雅的白鹿正在静静饮水，阳光透过树叶形成斑驳的光影，蝴蝶在花丛中飞舞[缓慢推进][梦幻滤镜]",
    model="MiniMax-Hailuo-2.3",
    seconds="6",
    prompt_optimizer=True,
    aigc_watermark=False
)

if video_path:
    print(f"🎊 海螺视频生成完整流程成功完成！视频保存在: {video_path}")

注意事项

模型选择: 推荐使用 MiniMax-Hailuo-2.3 获得最佳效果
Prompt优化: 开启 prompt_optimizer 能显著提升生成质量
运镜控制: 合理使用[指令]语法可以获得更精确的视觉效果
主体参考: S2V-01模型的主体参考功能仅支持人物面部
费用控制: 时长直接影响费用，请根据需求合理设置
文件格式: 生成的视频为MP4格式，H.264编码，25fps

API端点参考

使用示例

​海螺视频生成示例

​支持的参数

​通用参数

​扩展参数

​文生视频模型介绍

​步骤1：创建视频生成任务

​响应示例

​步骤2：查询任务状态

​状态响应示例

​步骤3：下载生成的视频

​图生视频-首帧示例

​图生视频-首尾帧示例

​运镜控制语法

​镜头运动

​镜头角度

​镜头景别

​视觉效果

​使用示例

​完整工作流示例

​注意事项

海螺视频生成示例

支持的参数

通用参数

扩展参数

文生视频模型介绍

步骤1：创建视频生成任务

响应示例

步骤2：查询任务状态

状态响应示例

步骤3：下载生成的视频

图生视频-首帧示例

图生视频-首尾帧示例

运镜控制语法

镜头运动

镜头角度

镜头景别

视觉效果

使用示例

完整工作流示例

注意事项