Skip to main content
POST
查询 Vertex 视频任务(项目路径)
查询时使用创建任务时的 project、location、publisher 和 model,并原样传回完整 operationName。

查询与状态判断

把 <OPERATION_NAME> 替换为创建响应的完整 name,每 10 到 15 秒查询一次:
done: true 只表示任务结束,不代表成功。

读取成功结果

成功响应的关键字段:
response.videos[0].gcsUri 是 AIOHub 的 HTTPS 地址,不是 gs:// 对象。用 HTTP 客户端下载,无需配置 Google Cloud Storage。 任务成功后,按 下载视频 保存文件。

失败与重试

查询断线后用原 name 继续查询,不要重新调用 predictLongRunning。收到 400 时先修正字段;任务结束后若有 error,不要读取成功结果字段。视频文件保留 72 小时,任务记录保留 7 天。 收到 429 或临时不可用错误时,等待后重试查询,不要重新创建任务。查询不到任务时,确认任务标识和 API 令牌所属账号。

授权

Authorization
string
header
必填

API key (sk-xxx)

路径参数

project
string
必填

客户端路径中的项目标识。

示例:

"my-project"

location
string
必填

客户端路径中的区域标识。

示例:

"us-central1"

publisher
string
必填

模型发布者,Seedance 示例使用 bytedance。

示例:

"bytedance"

model
string
必填

完整 Seedance 模型名。

示例:

"doubao-seedance-2-5-260628"

请求体

application/json
operationName
string
必填

创建响应中的完整 name,原样传入。

响应

当前任务状态;生成失败也可能返回 HTTP 200。

name
string
必填

完整 operation name。保存原值用于后续查询。

done
boolean
必填

false 表示等待;true 表示已结束,但可能是失败,须检查 error。

response
object
error
object