SD-2.0-MZ1:按秒计费视频
本页只适用于 SD-2.0-MZ1,使用“seedance低价渠道,质量自测”分组。它与 Mini/Fast 的规格和收费方式不同:固定 720p、5–15 秒整数、按请求的输出秒数计费。核对日期:2026-10-29。
最小文生视频
POST /v1/videos,JSON 请求。下载 sd-text.json:
{
"model": "SD-2.0-MZ1",
"prompt": "清晨湖面上的蓝色纸船缓缓漂动,柔和光线,镜头平稳推进",
"seconds": "5",
"resolution": "720p",
"ratio": "16:9",
"generate_audio": true
}
curl --fail-with-body --max-time 120 \
https://openpix.cc/v1/videos \
-H "Authorization: Bearer $MXB_API_KEY" \
-H 'Content-Type: application/json' \
--data-binary @sd-text.json
返回的任务 ID 按视频任务与下载处理。默认开启生成音频;如果不需要音轨,可在下载后由自己的应用进行静音处理,不能在这个型号的请求里填写 generate_audio:false。
完整参数
| 字段 | 类型 / 必填 | 默认与合法值 | 说明 |
|---|---|---|---|
| model | string / 是 | SD-2.0-MZ1 |
必须有对应分组权限 |
| prompt | string / 与 content.text 二选一 | 1–12000 个 Unicode 字符 | 不允许空白提示词 |
| seconds | string 或 integer / 建议显式写 | 默认 5,范围 5–15 | 必须为整数;不接受 4 秒、16 秒 |
| duration | integer 或数字字符串 / 可选 | seconds 的别名 | 建议只使用 seconds |
| resolution | string / 建议显式写 | 720p |
不支持 480p、1080p、2K、4K |
| ratio | string / 可选 | 默认 16:9 |
16:9、9:16、1:1、4:3、3:4、21:9、adaptive |
| images | string[] / 可选 | 最多 9 张 | 每项为有效 HTTPS 图片地址 |
| audio_urls | string[] / 可选 | 最多 3 段 | 有音频参考时至少需要一张参考图片 |
| metadata.content | array / 可选 | 最多 13 项 | 一个 text 与最多 12 个图片/音频项 |
| generate_audio | boolean / 可选 | 省略或 true |
不支持关闭,不能填 false |
| watermark | boolean / 可选 | 省略或 false |
不能填 true;此字段不构成输出无任何可见标记的保证 |
| size | string / 可选 | 720p 或下表尺寸 | 会同时约束比例,不能与 ratio 冲突 |
metadata 仅可使用 duration、resolution、ratio、content、generate_audio、watermark。不支持的字段会被拒绝;不要复制 Mini/Fast 的 seed、return_last_frame、omni_reference_task_type。
比例与 size
优先填写 resolution:"720p" 和 ratio。如工具只能传 size,可采用以下参数对应关系;它们是请求比例映射,不承诺最终文件逐像素不变。
| 比例 | size |
|---|---|
| 16:9 | 1280x720 |
| 9:16 | 720x1280 |
| 1:1 | 720x720 |
| 4:3 | 960x720 |
| 3:4 | 720x960 |
| 21:9 | 1680x720 |
使用 adaptive 时建议提供参考图片,使画面比例有明确参考。需要确定输出方向时直接传固定比例。
图片与音频参考
简写适合常见组合:
{
"model": "SD-2.0-MZ1",
"prompt": "保持参考图中的人物与场景,按照音频的节奏自然运动",
"seconds": "5",
"resolution": "720p",
"ratio": "16:9",
"images": ["https://media.example.com/character.png"],
"audio_urls": ["https://media.example.com/voice.wav"]
}
示例 media.example.com 是保留示例域名,必须替换成自己可公开访问的真实素材。图片最多 9 张、音频最多 3 段;音频不能单独提交。
也可用 metadata.content:
{
"model": "SD-2.0-MZ1",
"seconds": "5",
"resolution": "720p",
"ratio": "16:9",
"metadata": {
"content": [
{"type": "text", "text": "以参考图片为主体,根据音频节奏制作短片"},
{"type": "image_url", "image_url": {"url": "https://media.example.com/character.png"}, "role": "reference_image"},
{"type": "audio_url", "audio_url": {"url": "https://media.example.com/voice.wav"}, "role": "reference_audio"}
]
}
}
两种写法二选一。使用 content 后不要同时传 images、image、input_reference 或 audio_urls;已有 text 项时也不要再传顶层 prompt。
明确不支持的组合
| 请求 | 处理建议 |
|---|---|
| 参考视频 video_url | 此型号不支持;查看 Mini/Fast 或 H3 |
| first_frame / last_frame | 此型号没有首尾帧模式;普通参考图片不是关键帧约束 |
| 仅音频参考 | 至少同时提供一张图片 |
| generate_audio:false | 省略该字段或使用 true |
| watermark:true | 省略该字段或使用 false |
| 4 秒或 1080p | 改为 5–15 秒、720p |
| 上传本地二进制文件或 Data URL | 先取得可公开读取的 HTTPS 素材地址 |
不支持的参数有时会在可用模型筛选阶段体现为“无可用模型/服务”,不能只等某个固定 HTTP 400 文本;先核对本页参数和 Key 分组。
费用计算
核对时该分组基础价为 ¤0.16 / 输出秒数,当前倍率为 1:
| 请求 seconds | 示例费用 |
|---|---|
| 5 | ¤0.80 |
| 10 | ¤1.60 |
| 15 | ¤2.40 |
按请求中的名义秒数计算,不按最终 MP4 容器中多出的零点几秒重新增加费用。不能把 Mini/Fast 的视频 Token 单价套到本型号。实际适用报价与账户倍率以模型广场和账单为准。
保存任务 ID 后持续查询同一个任务;等待时间超过客户端截止时间不表示任务已失败,也不应触发自动重新提交。