Morphogen

简体中文

English

简体中文

English

Appearance

图生首尾帧视频 ​

概览 ​

  • 接口：图生首尾帧视频（Start/End Frame → Video）
  • 说明：通过指定起始帧与结束帧，结合文本描述生成短视频，模型以首帧为尺寸参考进行生成。
  • 模型：MiniMax-Hailuo-02（注意：首尾帧生成功能不支持 512P 分辨率）

认证 ​

  • 使用 Bearer Token（在请求头 Authorization: Bearer <token> 中传入）。

请求参数 ​

  • 请求 Content-Type：application/json

  • 请求体字段：

    • model (string, 必填)

      • 模型名称：MiniMax-Hailuo-02。

    • prompt (string)

      • 视频文本描述，最多 2000 字符。支持在 prompt 中使用 [指令] 语法进行运镜控制（见下文运镜指令说明）。

    • prompt_optimizer (boolean, 可选, 默认 true)

      • 是否自动优化 prompt，设为 false 可获得更精确控制。

    • fast_pretreatment (boolean, 可选, 默认 false)

      • 是否缩短 prompt 优化耗时，仅对 MiniMax-Hailuo-02 生效。

    • duration (integer, 必填)

      • 视频时长（秒），可选值与模型/分辨率相关：

        模型768P1080P
        MiniMax-Hailuo-026或106

    • resolution (string, 必填)

      • 视频分辨率（注意 P 为大写），可用值见上表。

    • first_frame_image (string, 必填)

      • 起始帧图片，支持公网 URL 或 Base64 编码的 Data URL。图片要求：JPG/JPEG/PNG/WebP，体积 < 20MB，短边 > 300px，长宽比在 2:5 到 5:2 之间。生成视频尺寸遵循首帧图片。

    • last_frame_image (string, 必填)

      • 结束帧图片，支持公网 URL 或 Base64 编码的 Data URL。若首帧与尾帧尺寸不一致，模型会参考首帧对尾帧进行裁剪。

    • callback_url (string, 可选)

      • 回调地址：配置后服务端会验证并在任务状态变更时推送状态，推送数据结构与查询接口响应体一致。状态包括：processing / success / failed。

运镜指令（简要） ​

  • 支持指令示例：[左移]、[右移]、[左摇]、[右摇]、[推进]、[拉远]、[上升]、[下降]、[上摇]、[下摇]、[变焦推近]、[变焦拉远]、[晃动]、[跟随]、[固定]。
  • 使用规则：同组 [] 内多个指令同时生效，建议不超过 3 个；按出现顺序依次生效；也支持自然语言描述，但标准指令更可控。

请求示例 ​

bash
curl -X POST "https://api.gpt.ge/task/minimax/v1/video_generation" \
  -H "Authorization: Bearer $YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-Hailuo-02",
    "prompt": "一个小女孩从小成长到大的变化",
    "duration": 6,
    "resolution": "1080P",
    "first_frame_image": "https://filecdn.minimax.chat/public/fe9d04da-f60e-444d-a2e0-18ae743add33.jpeg",
    "last_frame_image": "https://filecdn.minimax.chat/public/97b7cd08-764e-4b8b-a7bf-87a0bd898575.jpeg"
  }'

请求体示例（JSON）：

json
{
  "model": "MiniMax-Hailuo-02",
  "prompt": "一个小女孩从小成长到大的变化",
  "duration": 6,
  "resolution": "1080P",
  "first_frame_image": "https://filecdn.minimax.chat/public/fe9d04da-f60e-444d-a2e0-18ae743add33.jpeg",
  "last_frame_image": "https://filecdn.minimax.chat/public/97b7cd08-764e-4b8b-a7bf-87a0bd898575.jpeg"
}

成功响应示例 ​

json
{
  "task_id": "106916112212032",
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

返回字段说明 ​

  • task_id (string)：任务 ID，用于查询任务状态与结果。
  • base_resp (object)：基础返回信息，包含 status_code (integer) 与 status_msg (string)。

说明 ​

  • 请注意必填字段，缺失可能导致模型名称识别失败。
  • 首尾帧功能以首帧为主导尺寸，上传图片请遵守格式与大小限制。