Skip to main content
POST
Vidu Q3 AD (Keyframe Short Play)

Authorizations

Authorization
string
header
required

API Key authentication. Format: Bearer YOUR_API_KEY.

Body

application/json

Vidu Q3 AD keyframe short-play request. Field names are passed through to Vidu as-is. Note the asset image field is image_uri, not image_url. Unlike Q3 Drama, this model does NOT support placement, quality, duration, or style.

script_name
string
required

Episode name (max 20 characters)

Required string length: 1 - 20
Example:

"City Sunrise"

script_content
string
required

Script content in traditional screenplay format (scene heading + characters + dialogue). English up to 5000 characters.

Required string length: 1 - 5000
Example:

"Scene 1 INT. LIVING ROOM - DAY\n@Protagonist stands by the window and smiles.\n@Protagonist: Today is a good day."

assets
object[]
required

Reference assets (1-14; 3-10 recommended). One asset maps to exactly one image.

Required array length: 1 - 14 elements
resolution
enum<string>
default:1080p

Output resolution (1080p only)

Available options:
1080p
Example:

"1080p"

aspect_ratio
enum<string>
default:9:16

Video aspect ratio

Available options:
16:9,
9:16
Example:

"9:16"

Response

Task submitted successfully

code
integer
required

Response code, 0 indicates success

Example:

0

message
string
required

Response message

Example:

"success"

data
object
required

Detailed data about the submitted asynchronous task.