OpenAPI 参考

Modelink API · 视频

Modelink 视频生成 API，涵盖 OpenAI 风格、Fal 队列、可灵、豆包 Seedance、Vidu、Veo 等多厂商的文生视频、图生视频与任务查询能力。Fal 格式接口使用 Authorization: Key {api_key}；其他接口使用 Bearer 鉴权。

版本 1.0.0

创建参考生视频任务

POST

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

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

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

认证方式

FalApiKeyAuthAPI 密钥

Fal 格式接口鉴权方式：Authorization: Key {api_key}。

header 参数：Authorization

BearerAuthBEARER

在 Authorization 请求头中传入 API Key 或访问令牌，格式：Bearer {token}。

Bearer 格式：JWT

查询参数

Name
fal_webhook
Type
string<uri>
Description
可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

promptstring, 必填
视频生成提示词，Vidu Q3 系列最长 2000 字符。
reference_image_urlsstring[], 必填
参考图片 URL 列表，支持 HTTP(S) 图片 URL 或 data:image/* Base64 图片。 Vidu Q3 / Q3 Turbo 参考生视频支持 1 到 7 张参考图片。
durationinteger
视频时长，单位秒；未传时默认 5 秒，取值范围为 3 到 16。
default: 5; minimum: 3; maximum: 16
- 540p
- 720p
- 1080p
- 16:9
- 9:16
- 1:1
- 4:3
- 3:4
seedinteger
随机种子；不传或传 0 时由系统自动生成。
- auto
- small
- medium
- large
bgmboolean | null
是否添加背景音乐；不传表示未指定。
audioboolean | null
是否音视频直出；不传表示未指定。

请求

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

curl 'https://api.qnaigc.com/queue/fal-ai/vidu/q3/reference-to-video?fal_webhook={fal_webhook}' \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --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"
  ]
}'

响应

object

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

响应体属性

statusstring, 必填
任务状态，创建成功后通常为 IN_QUEUE。
request_idstring, 必填
视频任务唯一 ID，用于查询状态和结果。
response_urlstring<uri>, 必填
查询任务最终结果的 URL。
status_urlstring<uri>, 必填
查询任务状态的 URL。
cancel_urlstring
取消任务的 URL（暂不支持）。
queue_positioninteger
队列位置（入队时为 0）。
- messagestring
  可选。
- - STDERR
  - STDOUT
  - ERROR
  - INFO
  - WARN
  - DEBUG
- sourcestring
  可选。
- timestampstring<date-time>
  ISO 8601 格式。

响应

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