跳转到主要内容
GET
查询 FLUX 3 Video 视频任务

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求头

x-debugger-mode
string
默认值:true

路径参数

id
string
必填

视频生成任务的唯一标识符。

响应

200 - application/json

查询视频任务。完成时返回对象形式的 data;其他状态不返回 data。

GET /v1/videos/{id} 的响应参数。data 为最终结果对象,仅在 status=completed 时返回;其他状态省略 data。

created
integer
必填

视频任务创建时间,Unix 时间戳,单位为秒。

必填范围: x >= 0
示例:

1789108566

id
string
必填

视频生成任务的唯一标识。

Minimum string length: 1
示例:

"9552de3d-171f-4cca-b492-7baa56523239"

model
string
必填

创建视频任务时使用的模型 ID。

Minimum string length: 1
示例:

"bytedance/seedance-2.0-mini"

prompt
string
必填

创建视频任务时提交的提示词。

示例:

"一只金毛犬在日落时分的海滩上奔跑,镜头平稳跟随,画面呈现自然细腻的电影质感"

status
enum<string>
必填

任务状态。pending 表示等待处理;queue 表示排队中;in_progress 表示生成或平台处理进行中;completed 表示视频和 OSS 资源均已处理完成;failed 表示失败;cancelled 表示已取消;expired 表示已过期。

可用选项:
pending,
queue,
in_progress,
completed,
failed,
cancelled,
expired
示例:

"in_progress"

usage
object
必填

视频任务的使用量信息。

data
object

最终结果对象,只有 status=completed 时存在。其他状态省略整个 data 字段,不返回数组或 null。

error
object

任务失败信息。通常仅在 status 为 failed 时返回。