Skip to main content
POST
/
v3
/
async
/
vidu-q2-reference2video
VIDU Q2 Reference Image to Video
curl --request POST \
  --url https://api.myrouter.ai/v3/async/vidu-q2-reference2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "bgm": true,
  "seed": 123,
  "audio": true,
  "prompt": "<string>",
  "duration": 123,
  "subjects": [
    {
      "id": "<string>",
      "images": [
        {}
      ],
      "voice_id": "<string>"
    }
  ],
  "watermark": true,
  "resolution": "<string>",
  "aspect_ratio": "<string>",
  "movement_amplitude": "<string>"
}
'
{
  "task_id": "<string>",
  "provider_request_id": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.myrouter.ai/llms.txt

Use this file to discover all available pages before exploring further.

Generate new videos from reference images. Supports 540p, 720p, and 1080p resolutions.
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.
​
seed
integer
Random seed for controlling the randomness of the generation result. The same seed produces similar results.
​
audio
boolean
default:false
Whether to generate audio.
​
prompt
string
required
Text prompt. You can use @1, @2, etc. as placeholders to reference subjects.
​
duration
integer
default:5
required
Video duration (in seconds). Supports 1-10 seconds.Possible values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
​
subjects
array
required
List of subjects. Each subject contains id, images, and voice_id.Array length: 1 - unlimited
​
watermark
boolean
default:false
Whether to add a watermark.
​
resolution
string
default:"720p"
Output video resolution. Default: 720p.Possible values: 540p, 720p, 1080p
​
aspect_ratio
string
Video aspect ratio, e.g., 16:9, 9:16, 1:1, etc.
​
movement_amplitude
string
Movement amplitude, controlling the intensity of object motion in the video.Possible values: auto, small, medium, high

​
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)