Vidu Q2 Turbo - Video Extension

Authentication

authorization string required

All APIs require authentication via Bearer Token.

Get API Key:

Visit API Key Management Page to get your API Key

Usage:

Add to request header:

Authorization: Bearer YOUR_API_KEY

Parameters

model string required

Model ID to use for the request

Value: viduq2_turbo_extend

---

video_creation_id string

Vidu video ID, one of video_url or video_creation_id is required

---

video_url string

Any video URL, one of video_url or video_creation_id is required

Note: Video duration must be at least 4 seconds and no more than 1 minute

---

images array

Reference image for extending to the end frame, the model will use the image passed in this parameter as the end frame to extend the video

Format Requirements:
Supports Base64 encoding or image URL (must be accessible)
Only supports input of 1 image
Supported formats: png, jpeg, jpg, webp
Image aspect ratio must be less than 1:4 or 4:1
Image size must not exceed 50MB
HTTP request POST body must not exceed 20MB, and encoding must include appropriate content type string. Example: data:image/png;base64,{base64_encode}

---

prompt string

Extension prompt to control the extended video content

---

resolution string

Video resolution

Options: 540p, 720p, 1080p

Default: 720p

---

duration integer

Extension duration in seconds

Options: 1 - 7

Default: 5

---

watermark boolean

Whether to add a watermark. When true, a watermark is added; when false, no watermark is added

Currently watermark content is fixed and AI-generated, by default no watermark is added

Options: true, false

Default: false

---

wm_url string

Watermark content, provided as a watermark image URL, this parameter is invalid if watermark is not added

When watermark is enabled but custom watermark URL is not provided, the default AI-generated watermark is used

---

wm_position string

Watermark position, this parameter is invalid if watermark is not added

Options: top_left (Top-left), top_right (Top-right), bottom_right (Bottom-right), bottom_left (Bottom-left)

Default: bottom_left

---

meta_data string

Metadata identifier, JSON format string, pass-through field

You can customize the format or use the example format. Example:

{
  "Label": "your_label",
  "ContentProducer": "yourcontentproducer",
  "ContentPropagator": "your_content_propagator",
  "ProduceID": "yourproductid",
  "PropagateID": "your_propagate_id",
  "ReservedCode1": "yourreservedcode1",
  "ReservedCode2": "your_reserved_code2"
}

When this parameter is empty, the default metadata identifier generated by vidu is used

---

payload string

Pass-through parameter, no processing required, only data transmission, maximum 1048576 characters

---

callback_url string

Callback URL

---

Polling

Since video generation takes time, you need to poll the task status after creation

The initial response returns the task ID and initial status. The actual generation results must be obtained through polling the task status endpoint

Response Format

error object

Error information. Only present when status is failed.

code string

Error code

message string

Detailed error message.

---

output array

Generation results. Only present when status is completed.

type string

Resource type

Value: video

url string

Generated video URL (processed and uploaded to CDN)

jobId string

Remote job ID

---

usage object

Usage statistics. Only present when status is completed.

model string

Model name used (viduq2-turbo)

duration integer

Extension duration (seconds)

resolution string

Video resolution

credits integer

Credits consumed

---

metadata object

Metadata information

---

Error Codes

Error Code	Description
008013001	Missing video parameter (video_creation_id or video_url at least need to provide one)
008013002	Video URL format invalid (must be HTTP or HTTPS URL)
008013003	Video creation ID format invalid (must be non-empty string)
008013004	Prompt length invalid (does not exceed 2000 characters)
008013005	Extension duration invalid (must be 1-7 seconds integer)
008013006	Resolution invalid (must be 540p, 720p or 1080p)
008013007	Reference image count invalid (only allow 1 reference image)
008013008	Image format invalid (must be URL or base64 encoding)
008013009	Image size invalid (does not exceed 50MB, base64 decoded does not exceed 10MB)
008013010	Payload length invalid (does not exceed 1048576 characters)
008013011	Callback URL format invalid (must start with http:// or https://)
008013095	Internal generation error
008013096	Result parsing error
008013097	HTTP error response
008013098	Status check error
008013099	Task creation error