Create reference video generation task - non-subject invocation (video generation)

POST

/queue/fal-ai/vidu/q2/reference-to-video/pro

Create reference to video task. Reference to video includes video with audio output and video output functions. Both use the same interface address and request method, with different request bodies. Refer to examples below.
Reference to video - Video with audio output: You can specify subjects in the video to speak dialogue, directly generating complete video with audio;
Reference to video - Video output: Configure corresponding background music for video scenes, without dialogue.
Returns task ID and URLs to query task status and results

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Header Params

Body Params application/jsonRequired

Example

{
    "prompt": "@Figure 1 Character Reference@Refer to the special effects, movements, and camera work of Video 1.",
    "reference_image_urls": [
        "https://storage.googleapis.com/falserverless/model_tests/video_models/vidu-image-3123041388101890.png"
    ],
    "reference_video_urls": [
        "https://storage.googleapis.com/falserverless/model_tests/video_models/vidu-video-3123002003131623.mp4"
    ],
    "duration": 4,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "movement_amplitude": "auto"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api-xmodel.nexconn.ai/queue/fal-ai/vidu/q2/reference-to-video/pro' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "@Figure 1 Character Reference@Refer to the special effects, movements, and camera work of Video 1.",
    "reference_image_urls": [
        "https://storage.googleapis.com/falserverless/model_tests/video_models/vidu-image-3123041388101890.png"
    ],
    "reference_video_urls": [
        "https://storage.googleapis.com/falserverless/model_tests/video_models/vidu-video-3123002003131623.mp4"
    ],
    "duration": 4,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "movement_amplitude": "auto"
}'

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
        "status": "IN_QUEUE",
    "request_id": "qvideo-root-1770718628185826174",
    "response_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174",
    "status_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770718628185826174/status",
    "cancel_url": ""
}

Modified at 2026-04-24 10:39:56

Create First and Last Frame to Video Task

Query task status