Morphogen

简体中文

English

简体中文

English

Appearance

主体参考生视频 ​

概览 ​

  • 接口：主体参考生视频（Subject Reference → Video）
  • 说明：使用主体参考图（目前仅支持人物面部）结合文本描述生成视频片段。
  • 模型：S2V-01（仅当 model 为 S2V-01 时可用）

认证 ​

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

请求参数 ​

  • 请求 Content-Type：application/json

  • 请求体字段：

    • model (string, 必填)

      • 模型名称。可用值：S2V-01。

    • prompt (string)

      • 视频的文本描述，最大 2000 字符。

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

      • 是否自动优化 prompt，默认为 true。设为 false 可进行更精确的控制。

    • subject_reference (array, 必填)

      • 包含主体参考图的数组（目前仅支持单张图片）。

      • 数组项结构：

        • type (string, 必填)：主体类型，当前仅支持 character（人物面部）。
        • image (string, 必填)：图片 URL 或 Base64。

      • 图片要求：

        • 格式：JPG, JPEG, PNG, WebP
        • 体积：小于 20MB
        • 尺寸：短边像素大于 300px，长宽比在 2:5 和 5:2 之间

    • callback_url (string, 可选)

      • 接收任务状态更新通知的回调 URL。配置后，MiniMax 服务器会先向该 URL 发送一个包含 challenge 字段的验证请求，服务端需在 3 秒内原样返回该 challenge 以完成验证。验证成功后，任务状态变更时会向该 URL 推送最新状态，推送数据结构与查询接口响应体一致。状态包括：processing、success、failed。

请求示例 ​

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": "S2V-01",
    "prompt": "女生跑向镜头前，微笑着眨了眨眼睛。",
    "subject_reference": [
      {
        "type": "character",
        "image": "https://cdn.hailuoai.com/prod/2025-08-12-17/video_cover/1754990600020238321-411603868533342214-cover.jpg"
      }
    ]
  }'

请求体示例（JSON）：

json
{
  "model": "S2V-01",
  "prompt": "女生跑向镜头前，微笑着眨了眨眼睛。",
  "subject_reference": [
    {
      "type": "character",
      "image": "https://cdn.hailuoai.com/prod/2025-08-12-17/video_cover/1754990600020238321-411603868533342214-cover.jpg"
    }
  ]
}

成功响应示例 ​

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)。

说明 ​

  • 请注意参数必填字段，缺失可能导致模型名称识别失败。
  • subject_reference 目前仅支持单个主体（人物面部）。
  • 图片请遵守格式与大小限制以保证效果。