创建参考生视频任务-主体调用（支持音视频功能）

国内端点

https://api.qnaigc.com

POST

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

创建参考生视频任务参考生视频分为音视频直出、视频直出功能，二者使用相同的接口地址与请求方式，请求体不同，参考下方示例。
参考生视频-音视频直出：您可以指定视频中的主体用台词对话，直接生成完整的音视频；
参考生视频-视频直出：为视频的场景配置对应背景音乐，不含台词；
返回任务ID和查询任务状态及结果的URL

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json必填

示例

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.qnaigc.com/queue/fal-ai/vidu/q2/reference-to-video' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "The @devil is looking at the @apple on the @beach and walking around @beach.",
    "subjects": [
        {
            "id": "devil",
            "images": [
                "https://storage.googleapis.com/falserverless/web-examples/vidu/new-examples/reference1.png"
            ],
            "voice_id": ""
        },
        {
            "id": "apple",
            "images": [
                "https://storage.googleapis.com/falserverless/web-examples/vidu/new-examples/reference1.png"
            ],
            "voice_id": ""
        },
        {
            "id": "beach",
            "images": [
                "https://storage.googleapis.com/falserverless/web-examples/vidu/new-examples/reference1.png"
            ],
            "voice_id": ""
        }
    ],
    "seed": 2,
    "duration": 5,
    "resolution": "720p",
    "movement_amplitude": "auto"
}'

响应示例

{
        "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": ""
}

修改于 2026-03-30 03:31:31

创建参考生视频任务-非主体调用（视频生成

查询任务状态