创建参考生视频任务

国内端点

https://openai.qiniu.com

POST

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

使用 Vidu Q3 标准模型创建参考生视频任务。

API 路径为裸路径 /q3/reference-to-video，服务端内部模型市场 ID 为 vidu/viduq3。
支持 1 到 7 张参考图片，不支持 reference_video_urls。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json必填

示例

返回响应

🟢200

application/json

任务提交成功，返回排队状态和查询地址

Bodyapplication/json

🟠400

请求示例

Shell

JavaScript

Java

Swift

curl --location 'https://openai.qiniu.com/queue/fal-ai/vidu/q3/reference-to-video' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "prompt": "A character walking through a beach catching an apple.",
    "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"
    ]
}'

响应示例

200 - 成功示例

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

修改于 2026-05-29 03:12:01

查询任务结果

查询任务状态