Create reference to video task - Non-subject invocation (video generation

POST

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

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": "The little devil is looking at the apple on the beach and walking around it.",
    "reference_image_urls": [
        "https://storage.googleapis.com/falserverless/web-examples/vidu/new-examples/reference1.png",
        "https://storage.googleapis.com/falserverless/web-examples/vidu/new-examples/reference2.png",
        "https://storage.googleapis.com/falserverless/web-examples/vidu/new-examples/reference3.png"
    ],
    "seed": 2,
    "duration": 4,
    "resolution": "720p",
    "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' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "prompt": "The little devil is looking at the apple on the beach and walking around it.",
    "reference_image_urls": [
        "https://storage.googleapis.com/falserverless/web-examples/vidu/new-examples/reference1.png",
        "https://storage.googleapis.com/falserverless/web-examples/vidu/new-examples/reference2.png",
        "https://storage.googleapis.com/falserverless/web-examples/vidu/new-examples/reference3.png"
    ],
    "seed": 2,
    "duration": 4,
    "resolution": "720p",
    "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 text-to-video task

Create reference to video task - Subject invocation (supports video with audio function)