Skip to main content
POST
Create Vertex video task with project path
Use this path when the client includes a project and location. Authenticate with an AIOHub API key; the example publisher is bytedance, and model is the full Seedance model name.

Example request

The response includes the fields below. Save the full name, including the model path and operations/, rather than only its final ID segment.
Save the full name, then poll with the project path.

Inputs and parameters

Omitted controls default to 5 seconds, 720p, adaptive aspect ratio and audio enabled. First/last frames and reference images are separate input modes; do not combine them in the same instances[0]. Example image object:
See Video models and pricing for model limits. Arbitrary gs:// inputs, video extension and the full Veo parameter set are not supported. Use Ark / Seedance for reference audio, reference video or video editing.

Authorizations

Authorization
string
header
required

API key (sk-xxx)

Path Parameters

project
string
required

Project identifier in the client's path.

Example:

"my-project"

location
string
required

Location identifier in the client's path.

Example:

"us-central1"

publisher
string
required

Model publisher; Seedance examples use bytedance.

Example:

"bytedance"

model
string
required

Full Seedance model name.

Example:

"doubao-seedance-2-5-260628"

Body

application/json

This schema covers Seedance. lastFrame requires image; reference images cannot be combined with first/last frames. Video extension, masks, seed, negativePrompt and other unlisted controls are unsupported.

instances
object[]
required

Send exactly one instance. Text generation requires prompt; use image for a first frame.

Required array length: 1 element
parameters
object

Response

Task accepted.

name
string
required

Full operation name. Save the returned value for polling.

done
boolean
required

False means pending. True means finished, possibly with a failure; check error.

response
object
error
object