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
}