打开链接? 目标地址
继续前往
开发文档

Seedance、Wan 3.0 与 MiniMax H3 视频接入

部分可用。主站已列出多个 Seedance 型号;本页的 Wan 3.0、MiniMax H3 和 Seedance 统一视频任务格式供上线前接入准备使用。

根据文生视频、混合素材或首尾帧的需求选模型,再用任务 ID 跟踪成片。

选模型与素材

系列 输入方式 选型要点
Seedance 2.0 文本及型号支持的图片、视频、音频 seedance2.0-fast-720p 的主站说明列出 4–15 秒;其他后缀应单独核对
Seedance 2.5 文本或混合素材 seedance2.5-720p 的主站说明列出 4–30 秒,最多 30 图、10 音频、10 视频
Wan 3.0 文本、图生视频或指定类型的参考素材 -3、-4、-dh、-dj 的输入和时长各异;例如 wan3.0-dj-720p 的参考配置为图和音频
MiniMax H3 文本、普通参考图或首尾帧 规划型号 minimax-h3,5–15 秒;普通参考和首尾帧为两种模式

已列出的 Seedance 调用入口

在 UiUiAPI 主站公开模型目录中,以上两个 Seedance 型号标注的接口类型为 Chat Completions。下面是该入口的文本请求;返回内容按实际通道解析。

curl -sS --fail-with-body 'https://api.uiuihao.com/v1/chat/completions' \
  -H "Authorization: Bearer $UIUI_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary '{
  "model": "seedance2.5-720p",
  "messages": [
    {
      "role": "user",
      "content": "拍摄海边灯塔,镜头从礁石缓缓移向塔顶。"
    }
  ]
}'

统一视频任务(待相应通道开放)

提交任务

先在终端设置环境变量 UIUI_API_KEY。以下示例使用主站的 JSON 接口。含 example.com 的素材地址需要换成服务器能读取的 HTTPS 文件地址。

curl -sS --fail-with-body 'https://api.uiuihao.com/v1/videos' \
  -H "Authorization: Bearer $UIUI_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary '{
  "model": "wan3.0-720p-3",
  "prompt": "参考主体外观,沿河岸平移镜头。",
  "seconds": 10,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "images": [
    "https://example.com/ref.jpg"
  ],
  "videos": [
    "https://example.com/source.mp4"
  ],
  "audios": [
    "https://example.com/rhythm.mp3"
  ]
}'

Seedance 多素材与本地上传

任务通道开放后,Seedance 可按型号使用 images、videos、audios;同一文件只填一个字段。上传本地文件用 multipart,同名字段可重复。

curl -sS --fail-with-body 'https://api.uiuihao.com/v1/videos' \
  -H "Authorization: Bearer $UIUI_API_KEY" \
  -F 'model=seedance2.0-fast-720p' -F 'prompt=沿着画面中的河岸推进' \
  -F 'seconds=6' -F 'resolution=720p' -F 'images=@river.jpg'

MiniMax H3 首尾帧

将下列 JSON 用于同一个提交入口。用普通参考模式时,改传 reference_images(最多 5 张);音频参考放入 audio_references(最多 3 段,须同时提供普通参考图)。H3 的预期输出包含音轨。

{
  "model": "minimax-h3",
  "prompt": "从晨雾中的桥面过渡到晴空下的桥面。",
  "seconds": 8,
  "start_frame": "https://example.com/ref.jpg",
  "end_frame": "https://example.com/last.jpg",
  "resolution": "1440P"
}

查询进度与保存视频

从提交响应读取 id 或 task_id。在终端设置 TASK_ID 为返回的原值,再查询状态。

curl -sS --fail-with-body "https://api.uiuihao.com/v1/videos/$TASK_ID" \
  -H "Authorization: Bearer $UIUI_API_KEY"

排队或生成中时隔几秒再查询;收到 429 时按 Retry-After 延长间隔。遇到 failed / FAILURE 时停止轮询并查看错误。成功状态如 completed / SUCCESS 出现后,可用同一任务 ID 保存成片。

curl -fSL "https://api.uiuihao.com/v1/videos/$TASK_ID/content" \
  -H "Authorization: Bearer $UIUI_API_KEY" -o output.mp4

若返回临时成片链接,及时保存。向外部存储下载时无需附带 UiUiAPI 密钥。超时先查任务记录,避免重复生成。

H3 普通参考和混合输入

以下请求体适用于 H3 普通图片参考模式;如使用首尾帧,去掉这里的两组参考素材。Wan 3.0 的混合参考使用 images、videos、audios,支持数量随具体后缀变化。

{
  "model": "minimax-h3",
  "prompt": "让闹钟的指针随音乐节拍转动。",
  "seconds": 8,
  "resolution": "1440P",
  "reference_images": [
    "https://example.com/clock.jpg"
  ],
  "audio_references": [
    "https://example.com/tick.mp3"
  ],
  "audio": true
}