Skip to main content

接口

异步接口 —— 返回 {id, status: "pending"};轮询 GET /v1/videos/generations/{id} 直到返回 success 或 failed。

参数

string
必填
描述所需视频的文本提示词。最多 5000 个字符。
"480p" | "720p" | "1080p"
默认值:"\"1080p\""
输出分辨率。标准版三档皆支持;快速版最高 720p。决定 每秒的计费费率。
"16:9" | "9:16" | "1:1" | "4:3" | "3:4" | "21:9"
默认值:"\"16:9\""
生成视频的宽高比。
请在 API 请求中显式传入 ratio,不要使用 aspect_ratio。上方默认值是模型 schema 的表单默认值,不应假定省略此字段时 API 会自动补齐。例如传入 "ratio": "16:9";也可选择上方列出的其他宽高比。
已在当前服务链路上观察到:480p 文生视频请求省略 ratio 时返回 Invalid parameter value: resolution,而相同请求显式传入 "ratio": "16:9" 后成功。这是已验证的兼容性问题,并不表示所有 Seedance 模型的上游 API 都要求显式传入宽高比。
integer
默认值:"5"
生成片段的时长(秒)。取值范围 [4, 15]。
boolean
默认值:"true"
生成与画面同步的原生音轨。默认开启,设为 false 可得到无声片段。
boolean
默认值:"false"
在右下角打上 AI 生成水印。
没有 seed 参数:上游不支持,因此每次调用都会生成新的版本。请求中包含 seed 会被拒绝。

示例

轮询直到进入终态: