无限画布无限画布
GPU API工具箱 API 文档Proxy Base URL（画布内部）

MiniMax H3 视频生成

画布内部 Proxy API 的 MiniMax H3 原版与 DaSiWa 五模式完整调用合同

文档更新时间：2026年09月08日 12时59分44秒（UTC+8）

Base URL: https://ic.xshow.live/api/proxy/v1
Create: POST /videos
Authentication: Infinite Canvas 登录 Cookie
Create idempotency: X-IC-Operation-ID
Content-Type: multipart/form-data

这是 Infinite Canvas 画布和视频工作台内部接口。所有模式共用一个创建路径，通过 model 选择工作流；客户端不填写 Scheduler 路径，也不接触 GPU Token。即使 T2VA 没有图片，也必须使用 multipart。

原版 MiniMax H3

功能model图片输入图片含义
原版文生/首帧生视频minimax-h30–1 张0 张为文生视频，1 张为首帧
原版首尾帧minimax-h3-fl2v正好 2 张第 1 张首帧，第 2 张尾帧；应为同一角色
原版尾帧minimax-h3-l2v正好 1 张唯一图片作为尾帧
原版多参考minimax-h3-r2v1–4 张人物、场景、风格或物体参考

DaSiWa 五模式

功能模式model图片输入调度模式
文字生成视频minimax-h3-dasiwa-t2va0 张T2VA
首帧生成视频minimax-h3-dasiwa-i2va正好 1 张I2VA
首尾帧生成视频minimax-h3-dasiwa-fl2va正好 2 张FL2VA
尾帧生成视频minimax-h3-dasiwa-l2va正好 1 张L2VA
参考图生成视频minimax-h3-dasiwa-ref2va1–4 张REF2VA

DaSiWa 五项是五个公开模型 ID，但后端统一进入 DaSiWa 工作流并按模式执行。它们不是五条不同 URL。原版工作流继续保留，不会自动改写为 DaSiWa。

创建字段

字段必填规则
model是使用上表中的精确模型 ID
prompt是去除首尾空格后不可为空
input_reference[]按模式仅图片；顺序决定首帧、尾帧或参考图编号
seconds否整数 5–15，默认 5
resolution_name否480p 或 720p，默认 720p
ratio否16:9、9:16、1:1、4:3、3:4
fps否当前工作流固定输出 24fps；建议传 24
seed否整数 0–2147483647；省略时由服务端/工作流随机

参考图支持 JPG/JPEG、PNG、BMP、WEBP，单张最大 30MB。该模型族不接受视频、音频或 Wan3 typed 多媒体字段。

请求示例

请求准备

export BASE_URL="https://ic.xshow.live/api/proxy/v1"
# IC_SESSION 为当前平台登录会话值，请通过本机环境配置，不提交到代码或日志。
# 每次新生成创建一个 OPERATION_ID；同一次请求重试时保留该值。
export OPERATION_ID="$(uuidgen)"

下列每一段是独立创建示例。先配置 IC_SESSION，并将图片文件路径替换为真实文件。 不要手写 multipart Content-Type，curl 会自动生成 boundary。相同任务重试保留 OPERATION_ID 和全部输入；创建另一个任务前重新生成 OPERATION_ID。

DaSiWa T2VA（无图片）

curl -X POST "$BASE_URL/videos" \
  -H "Cookie: ic_session=$IC_SESSION" \
  -H "X-IC-Operation-ID: $OPERATION_ID" \
  -F "model=minimax-h3-dasiwa-t2va" \
  -F "prompt=固定竖屏镜头，角色自然挥手并说你好，保留真实环境声" \
  -F "seconds=5" -F "resolution_name=720p" -F "ratio=9:16" -F "fps=24"

DaSiWa I2VA（单张首帧）

curl -X POST "$BASE_URL/videos" \
  -H "Cookie: ic_session=$IC_SESSION" \
  -H "X-IC-Operation-ID: $OPERATION_ID" \
  -F "model=minimax-h3-dasiwa-i2va" \
  -F "prompt=保持人物身份、服装和场景，角色缓慢转身，固定镜头" \
  -F "input_reference[]=@first.png;type=image/png" \
  -F "seconds=5" -F "resolution_name=720p" -F "ratio=9:16" -F "seed=12345"

DaSiWa FL2VA（首帧和尾帧）

curl -X POST "$BASE_URL/videos" \
  -H "Cookie: ic_session=$IC_SESSION" \
  -H "X-IC-Operation-ID: $OPERATION_ID" \
  -F "model=minimax-h3-dasiwa-fl2va" \
  -F "prompt=从首帧自然过渡到尾帧，保持同一角色身份和场景连续" \
  -F "input_reference[]=@first.png;type=image/png" \
  -F "input_reference[]=@last.png;type=image/png" \
  -F "seconds=5" -F "resolution_name=720p" -F "ratio=9:16"

DaSiWa L2VA（单张尾帧）

curl --fail-with-body -X POST "$BASE_URL/videos" \
  -H "Cookie: ic_session=$IC_SESSION" \
  -H "X-IC-Operation-ID: $OPERATION_ID" \
  -F "model=minimax-h3-dasiwa-l2va" \
  -F "prompt=角色缓慢挥手，最后回到尾帧姿态，保持身份与场景一致" \
  -F "input_reference[]=@last.png;type=image/png" \
  -F "seconds=5" -F "resolution_name=720p" -F "ratio=9:16" \
  -F "fps=24" -F "seed=12345"

DaSiWa REF2VA（多参考图）

curl --fail-with-body -X POST "$BASE_URL/videos" \
  -H "Cookie: ic_session=$IC_SESSION" \
  -H "X-IC-Operation-ID: $OPERATION_ID" \
  -F "model=minimax-h3-dasiwa-ref2va" \
  -F "prompt=参考图一的人物和图二的场景，保持图三的光照风格，角色自然挥手" \
  -F "input_reference[]=@reference-1.png;type=image/png" \
  -F "input_reference[]=@reference-2.png;type=image/png" \
  -F "input_reference[]=@reference-3.png;type=image/png" \
  -F "seconds=5" -F "resolution_name=720p" -F "ratio=9:16" \
  -F "fps=24" -F "seed=12345"

原版文生视频（无图片）

curl --fail-with-body -X POST "$BASE_URL/videos" \
  -H "Cookie: ic_session=$IC_SESSION" \
  -H "X-IC-Operation-ID: $OPERATION_ID" \
  -F "model=minimax-h3" \
  -F "prompt=竖屏固定镜头，一位成年人在花园中自然挥手" \
  -F "seconds=5" -F "resolution_name=720p" -F "ratio=9:16" \
  -F "fps=24" -F "seed=12345"

原版首帧生视频（单张首帧）

curl --fail-with-body -X POST "$BASE_URL/videos" \
  -H "Cookie: ic_session=$IC_SESSION" \
  -H "X-IC-Operation-ID: $OPERATION_ID" \
  -F "model=minimax-h3" \
  -F "prompt=保持首帧人物、服装和背景，角色自然挥手" \
  -F "input_reference[]=@first.png;type=image/png" \
  -F "seconds=5" -F "resolution_name=720p" -F "ratio=9:16" \
  -F "fps=24" -F "seed=12345"

原版 FL2V（首尾帧）

curl --fail-with-body -X POST "$BASE_URL/videos" \
  -H "Cookie: ic_session=$IC_SESSION" \
  -H "X-IC-Operation-ID: $OPERATION_ID" \
  -F "model=minimax-h3-fl2v" \
  -F "prompt=同一角色从首帧平滑运动到尾帧，保持场景连续" \
  -F "input_reference[]=@first.png;type=image/png" \
  -F "input_reference[]=@last.png;type=image/png" \
  -F "seconds=5" -F "resolution_name=720p" -F "ratio=9:16" \
  -F "fps=24" -F "seed=12345"

原版 L2V（单张尾帧）

curl --fail-with-body -X POST "$BASE_URL/videos" \
  -H "Cookie: ic_session=$IC_SESSION" \
  -H "X-IC-Operation-ID: $OPERATION_ID" \
  -F "model=minimax-h3-l2v" \
  -F "prompt=角色缓慢转身，最终停留在尾帧姿态" \
  -F "input_reference[]=@last.png;type=image/png" \
  -F "seconds=5" -F "resolution_name=720p" -F "ratio=9:16" \
  -F "fps=24" -F "seed=12345"

原版 R2V（多参考图）

curl --fail-with-body -X POST "$BASE_URL/videos" \
  -H "Cookie: ic_session=$IC_SESSION" \
  -H "X-IC-Operation-ID: $OPERATION_ID" \
  -F "model=minimax-h3-r2v" \
  -F "prompt=参考图一的人物在图二场景中自然挥手，保持身份一致" \
  -F "input_reference[]=@reference-1.png;type=image/png" \
  -F "input_reference[]=@reference-2.png;type=image/png" \
  -F "seconds=5" -F "resolution_name=720p" -F "ratio=9:16" \
  -F "fps=24" -F "seed=12345"

REF2VA/R2V 示例分别展示三图和双图；两者均支持 1–4 张，重复同名图片字段并保留顺序。原版四个模型 ID 覆盖五种输入方式，其中 minimax-h3 通过有无首帧区分。

返回与任务生命周期

创建成功返回画布 Proxy 任务 ID：

{ "id": "TASK_ID", "status": "pending" }
# 将创建响应中的 id 填入，不要使用 operation ID 或 Scheduler 内部 ID
export TASK_ID="创建响应中的id"

# 查询；权威方法是 POST，并发送空 JSON
curl -X POST "$BASE_URL/videos/$TASK_ID" \
  -H "Cookie: ic_session=$IC_SESSION" \
  -H "Content-Type: application/json" -d '{}'

# 下载最终视频
curl -L "$BASE_URL/videos/$TASK_ID/content" \
  -H "Cookie: ic_session=$IC_SESSION" -o result.mp4

# 取消
curl -X POST "$BASE_URL/videos/$TASK_ID/cancel" \
  -H "Cookie: ic_session=$IC_SESSION"

任务状态为 pending、completed 或 failed。调用方应持续轮询，不要因浏览器短超时把仍在 GPU 队列中的任务判为失败。最终 content 只有在任务归属、积分结算和视频容器校验均通过后才返回。

常见输入错误

  • T2VA 上传图片：拒绝；改用 I2VA/FL2VA/L2VA/REF2VA。
  • I2VA 或 L2VA 不是 1 张图片：拒绝。
  • FL2VA 不是 2 张图片：拒绝；两张不同角色图片还可能产生身份融合。
  • REF2VA 少于 1 张或超过 4 张：拒绝，不会静默截断。
  • prompt 为空、时长超出 5–15 秒、分辨率或比例不受支持：返回 400 和具体错误信息。
  • 使用 Partner Bearer Key 请求该 Base URL：接口族错误；Proxy 只接受 Infinite Canvas 登录会话。

视频换人

视频换人组合 GPU API 的请求、阶段、轮询与错误说明

Partner API 总览

XCamShow 与 B 端服务器使用 API Key 调用的对外接口

On this page

原版 MiniMax H3DaSiWa 五模式创建字段请求示例请求准备DaSiWa T2VA（无图片）DaSiWa I2VA（单张首帧）DaSiWa FL2VA（首帧和尾帧）DaSiWa L2VA（单张尾帧）DaSiWa REF2VA（多参考图）原版文生视频（无图片）原版首帧生视频（单张首帧）原版 FL2V（首尾帧）原版 L2V（单张尾帧）原版 R2V（多参考图）返回与任务生命周期常见输入错误