cURL - Reference-to-video
Blend subjects from up to 7 reference images into one video, with prompt control and subject consistency.
Billing depends on the resolution tier, duration, and whether audio is generated. Check the model pricing before calling.
For common error codes, see Error messages.
- Model:
pixverse/pixverse-v6-r2v. - Reference images: pass 1 to 7 images in
input.mediawithtypeset toimage_url. Each image must be a publicly accessible JPG, PNG, or WEBP file up to 20 MB. - Subject references: set
ref_namefor each image and reference it in the prompt with@ref_name, followed by a space. Eachref_namemust be unique within the request. - Audio: set
audiototrueto generate background music or sound effects that match the video.
Workflow
- Submit a task with this endpoint and save the returned
task_id. - Poll Retrieve task result every 15 seconds until
task_statusisSUCCEEDEDorFAILED.
Billing
Billing depends on the resolution tier, duration, and whether audio is generated. Check the model pricing before calling.
Errors
For common error codes, see Error messages.Authorizations
string
header
required
DashScope API Key. Get one from the QwenCloud console.
Header Parameters
enum<string>
required
Must be set to enable. HTTP requests support asynchronous mode only. Omitting this header returns the error "current user api does not support synchronous calls".
enable