Skip to main content
POST
Seedance 2.5 视频生成
提交后,使用返回的 id 查询视频任务,完成后下载视频。

Authorizations

Authorization
string
header
required

技元 API 密钥

Body

application/json
model
string
required

模型调用名

Allowed value: "gxc-doubao-seedance-2-5-260628"
Minimum string length: 1
Pattern: \S
prompt
string
required

非空且不能仅包含空白字符的视频描述

Minimum string length: 1
Pattern: \S
seconds
integer

输出视频时长,单位为秒

Required range: 4 <= x <= 30
resolution
enum<string>
default:720p

输出视频分辨率

Available options:
720p,
1080p
aspect_ratio
enum<string>

画面比例

Available options:
16:9,
9:16,
1:1,
21:9,
4:3,
3:4
image_references
string<uri>[]

参考图片 URL

Maximum array length: 30

生成期间持续可访问的 HTTP(S) URL

Pattern: ^https?://
video_references
string<uri>[]

参考视频 URL

Maximum array length: 10

生成期间持续可访问的 HTTP(S) URL

Pattern: ^https?://
audio_references
string<uri>[]

参考音频 URL

Maximum array length: 10

生成期间持续可访问的 HTTP(S) URL

Pattern: ^https?://
matadata
object

视频生成选项

Response

200 - application/json

视频任务对象

标准视频任务对象。保存 id,用于查询任务和下载视频。

id
string
required

网关公开任务 ID,用于后续查询和下载

object
string
required
Allowed value: "video"
model
string
required

客户端请求的模型名称

status
enum<string>
required
Available options:
queued,
in_progress,
completed,
failed,
unknown
progress
integer
required

宿主将内部进度字符串转换为整数,解析失败时为 0

created_at
integer
required

任务创建时间,Unix 秒级时间戳

completed_at
integer

完成时间,Unix 秒级时间戳;创建响应中未完成时省略