参考素材要求
参考素材放在请求体的 references 数组中。每一项包含类型、用途和公网 URL。
参考素材结构
{
"type": "image",
"role": "reference",
"source": "https://example.com/reference.jpg"
}字段说明
数量与组合限制
- 图片、视频、音频的数量和总数需符合模型能力
first_frame与last_frame仅适用于明确支持的模型，不可默认所有模型都支持- 视频与音频的组合可能受限，具体以模型能力表为准
URL 要求
- 格式：必须使用公网 HTTPS 链接，不支持直接传入 Base64 数据，也不支持以
data:开头的内嵌素材 - 访问性：服务端需能直接访问，无需登录或代理
- 有效性：URL 应保持稳定，避免短时签名在任务开始前失效
- 前置检查：验证阶段不会下载素材，实际取用时仍可因过期或拒绝访问而失败
完整示例
多个素材组合请求：
{
"model": "seedance2.0-Q-720p",
"prompt": "@图1 作为主角，在@视频1的场景中移动。",
"seconds": 5,
"aspect_ratio": "16:9",
"references": [
{
"type": "image",
"role": "reference",
"source": "https://example.com/character.jpg"
},
{
"type": "video",
"role": "reference",
"source": "https://example.com/background.mp4"
}
]
}重要提示
- 不要使用私网或需要认证的 URL
- URL 过期或无法访问不会在创建时立即报错，实际生成时才会失败
- 建议使用对象存储（如 OSS）的永久链接而非临时签名链接