Skip to main content
POST
/
v3
/
async
/
vidu-q2-turbo-startend2video
VIDU Q2 Turbo Start-End Frame to Video
curl --request POST \
  --url https://api.myrouter.ai/v3/async/vidu-q2-turbo-startend2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "bgm": true,
  "seed": 123,
  "images": [
    {}
  ],
  "is_rec": true,
  "prompt": "<string>",
  "wm_url": "<string>",
  "payload": "<string>",
  "duration": 123,
  "off_peak": true,
  "meta_data": "<string>",
  "watermark": true,
  "resolution": "<string>",
  "wm_position": 123,
  "movement_amplitude": "<string>"
}
'
{
  "task_id": "<string>",
  "provider_request_id": "<string>"
}
Quickly generate coherent videos from start and end frame images. Supports three resolutions: 540p, 720p, and 1080p. The Turbo version balances generation speed and video quality.
This is an async API that only returns the task_id of the async task. Use the task_id to call the Get Async Task Result API to retrieve the generated result.

​
Request Headers

​
Content-Type
string
required
Enum: application/json
​
Authorization
string
required
Bearer authentication format: Bearer {{API Key}}.

​
Request Body

​
bgm
boolean
default:false
Whether to add background music to the generated video. true: the system will automatically select and add suitable music from the preset BGM library; false: no BGM is added. BGM duration is not limited; the system automatically adapts to the video length.
​
seed
integer
Random seed. When not provided or set to 0, a random number is used; when manually set, the specified seed is used.
​
images
array
required
Image array. The first image is treated as the start frame, and the second as the end frame. The model uses these images to generate the video. Exactly 2 images are supported. Note 1: The resolutions of the start and end frame images must be similar (start frame resolution / end frame resolution must be between 0.8 and 1.25). Note 2: Supports Base64-encoded images or image URLs (must be accessible). Note 3: Supported formats: png, jpeg, jpg, webp. Note 4: Maximum file size: 50MB. Note 5: Base64 encoding must include the appropriate content type string, e.g.: data:image/png;base64,Array length: 2 - 2
​
is_rec
boolean
default:false
Whether to use recommended prompts. true: the system automatically recommends a prompt and uses it to generate the video (costs an additional 10 credits per task); false: generate the video based on the provided prompt.
​
prompt
string
Text prompt describing the video to generate. Note 1: Maximum 2000 characters. Note 2: If the is_rec recommended prompt parameter is enabled, the model will ignore the prompt provided here.Length limit: 0 - 2000
​
wm_url
string
Watermark content, specified as an image URL. When not provided, the default watermark is used: “AI Generated”.
​
payload
string
Pass-through parameter, not processed in any way, used only for data transmission. Up to 1048576 characters.Length limit: 0 - 1048576
​
duration
integer
default:5
Video duration (seconds), supports 1-8 seconds.Possible values: 1, 2, 3, 4, 5, 6, 7, 8
​
off_peak
boolean
default:false
Off-peak mode. true: generate video during off-peak hours (lower credit cost, processed within 48 hours); false: generate video immediately. Note: tasks submitted in off-peak mode that are not completed will be automatically cancelled and credits refunded; you can also manually cancel off-peak tasks.
​
meta_data
string
Metadata identifier, a JSON-format string, pass-through field. You can customize the format or use the example format. When this parameter is empty, the default metadata identifier generated by Vidu is used.
​
watermark
boolean
default:false
Whether to add a watermark. Default: no watermark. You can use the watermarked_url parameter to retrieve the watermarked video.
​
resolution
string
default:"720p"
Output video resolution. Default: 720p.Possible values: 540p, 720p, 1080p
​
wm_position
integer
default:3
Watermark position, indicating where the watermark appears on the video. 1: top-left; 2: top-right; 3: bottom-right (default); 4: bottom-left.Possible values: 1, 2, 3, 4
​
movement_amplitude
string
default:"auto"
Movement amplitude, controlling the intensity of object motion in the video.Possible values: auto, small, medium, large

​
Response

​
task_id
string
required
Use the task_id to call the Get Async Task Result API to retrieve the generated output.
​
provider_request_id
string
Provider request ID (optional)