• 简体中文
  • MiniMax 格式(MiniMax-H3)

    MiniMax-H3(站内在售的 MiniMax 视频模型,模型名以模型广场为准)复用通用任务格式的端点,支持文生视频 / 图生视频 / 视频生视频三种模式(流程总览见创建视频生成任务)。查询流程与获取视频生成任务状态一致。

    端点

    创建与查询分别复用通用任务格式端点:POST /v1/video/generations、GET /v1/video/generations/{task_id}。

    请求体

    通用字段(prompt、metadata 合并规则等)见创建视频生成任务;下表为 MiniMax-H3 渠道实测的必填项与取值:

    参数位置类型说明
    model顶层stringMiniMax-H3,从模型广场「复制」获取
    prompt顶层string必填。文生视频写画面描述;图生 / 视频生视频写目标动作与风格
    duration顶层integer否。时长(秒),上游校验 4 ~ 15 的整数,缺省 5
    images顶层string[]图生视频必填。参考图(首帧)URL,见下方「素材 URL 约束」
    metadata.resolutionmetadatastring必填。分辨率档位:768p / 2K。⚠️ 不支持 720p / 1080p,不传时按 720p 校验直接报错
    metadata.ratiometadatastring文生视频必填(报错 ratio is required for text-to-video and cannot be adaptive),实测 16:9 可用;图生 / 视频生可省略
    metadata.video_urlsmetadatastring[]视频生视频必填。源视频 mp4 直链,见下方「素材 URL 约束」
    NOTE

    以上校验均在提交时同步返回、不产生扣费,按报错补齐参数重试即可。

    素材 URL 约束(图生 / 视频生视频)

    参考图与源视频必须是公网可直达的直链,优先用自有站点或境内 CDN / OSS。两类常见失败:境外图床被上游拦截(media url unreachable,错误码 2013);URL 失效报 media not found (HTTP 404)。失败任务不扣费,fail_reason 会带上游原始错误信息。

    请求示例

    cURL
    Python
    Node.js
    # 场景 1:文生视频(resolution + ratio 必填)
    curl -X POST https://api-model.shuntianchuang.cn/v1/video/generations \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer sk-你的令牌" \
      -d '{
        "model": "MiniMax-H3",
        "prompt": "一只橘猫在草地上追蝴蝶,电影感镜头,缓慢推近",
        "duration": 5,
        "metadata": { "resolution": "768p", "ratio": "16:9" }
      }'
    # 场景 2:图生视频(images 传首帧图,ratio 可省略)
    curl -X POST https://api-model.shuntianchuang.cn/v1/video/generations \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer sk-你的令牌" \
      -d '{
        "model": "MiniMax-H3",
        "prompt": "让画面中的主体缓缓运动起来,镜头轻微推进,电影感光影",
        "images": ["https://example.com/first-frame.jpg"],
        "metadata": { "resolution": "768p" }
      }'
    # 场景 3:视频生视频(metadata.video_urls 传源视频)
    curl -X POST https://api-model.shuntianchuang.cn/v1/video/generations \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer sk-你的令牌" \
      -d '{
        "model": "MiniMax-H3",
        "prompt": "把这段视频转换为水彩画风格,保持原有动作",
        "metadata": {
          "resolution": "768p",
          "video_urls": ["https://example.com/source.mp4"]
        }
      }'

    响应体

    提交成功返回统一任务对象,记住 task_id 用于查询。

    响应示例

    {
      "id": "task_xxxxxxxx",
      "task_id": "task_xxxxxxxx",
      "object": "video.generation",
      "model": "MiniMax-H3",
      "status": "queued",
      "progress": 0,
      "created_at": 1790651214
    }

    查询与下载

    查询用统一任务端点 GET /v1/video/generations/{task_id},响应结构与轮询示例见获取视频生成任务状态。本渠道补充:

    • 结果:SUCCESS 后 data.result_url 为本站代理下载链;data.data.output.video_url 为上游 OSS 签名直链,约 24 小时后失效,请及时转存
    • 镜像字段:data.data 回传上游任务信息——size("768P")、seconds("5")、数字型 progress、completed_at
    • 失败:FAILURE + data.fail_reason 带上游错误信息;失败任务不扣费

    响应示例(成功终态,节选):

    {
      "code": "success",
      "message": "",
      "data": {
        "task_id": "task_xxxxxxxx",
        "status": "SUCCESS",
        "progress": "100%",
        "result_url": "https://api-model.shuntianchuang.cn/v1/videos/task_xxxxxxxx/content",
        "fail_reason": "",
        "data": {
          "id": "task_yyyyyyyy",
          "size": "768P",
          "error": null,
          "model": "MiniMax-H3",
          "object": "video.generation",
          "output": {
            "video_url": "https://…aliyuncs.com/…/output_aigc.mp4?Expires=…"
          },
          "status": "completed",
          "seconds": "5",
          "progress": 100,
          "created_at": 1790651213,
          "completed_at": 1790651314
        }
      }
    }
    WARNING

    2K 档位取自上游报错提示、未实测出片;更高分辨率 / 时长的计费单价以模型广场为准。