OpenAPI 参考
Modelink API · 视频
Modelink 视频生成 API，涵盖 OpenAI 风格、Fal 队列、可灵、豆包 Seedance、Vidu、Veo 等多厂商的文生视频、图生视频与任务查询能力。Fal 格式接口使用 Authorization: Key {api_key}；其他接口使用 Bearer 鉴权。
版本 1.0.0
创建参考生视频任务
使用 Vidu Q3 Turbo 模型创建参考生视频任务。
API 路径带 /turbo 后缀，服务端内部模型 ID 为 viduq3-turbo。
支持 1 到 7 张参考图片，不支持 reference_video_urls。
认证方式
Fal 格式接口鉴权方式：Authorization: Key {api_key}。
查询参数
- 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
540p720p1080p
16:99:161:14:33:4
- seedinteger
随机种子；不传或传 0 时由系统自动生成。
autosmallmediumlarge
- bgmboolean | null
是否添加背景音乐；不传表示未指定。
- audioboolean | null
是否音视频直出；不传表示未指定。
请求
curl 'https://api.qnaigc.com/queue/fal-ai/vidu/q3/reference-to-video/turbo?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"
]
}'响应
任务提交成功，返回排队状态和查询地址
响应体属性
- statusstring, 必填
任务状态，创建成功后通常为
IN_QUEUE。 - request_idstring, 必填
视频任务唯一 ID，用于查询状态和结果。
- response_urlstring<uri>, 必填
查询任务最终结果的 URL。
- status_urlstring<uri>, 必填
查询任务状态的 URL。
- cancel_urlstring
取消任务的 URL（暂不支持）。
- queue_positioninteger
队列位置（入队时为 0）。
- messagestring可选。
STDERRSTDOUTERRORINFOWARNDEBUG
- 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"
}创建图生视频任务
创建图生视频任务，返回任务ID和查询任务状态及结果的URL
认证方式
Fal 格式接口鉴权方式：Authorization: Key {api_key}。
查询参数
- Name
- fal_webhook
- Type
- string<uri>
- Description
可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。
请求头
- Name
- Content-Type
- Type
- string
- Description
- 操作参数。
请求体
请求体属性
- promptstring
文本提示词 生成视频的文本描述。 注：字符长度不能超过 2000 个字符
- image_urlstring, 必填
首帧图像 模型将以此参数中传入的图片为首帧画面来生成视频。 注1：支持传入图片 Base64 编码或图片URL（确保可访问）； 注2：只支持输入 1 张图； 注3：图片支持 png、jpeg、jpg、webp格式； 注4：图片比例需要小于 1:4 或者 4:1 ； 注5：图片大小不超过 50 MB； 注6：请注意，http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，例如： data:image/png;base64,{base64_encode}
- audioboolean
是否使用音视频直出能力，默认为false，枚举值为：
- false：不需要音视频直出，输出静音视频
- true：需要音视频直出，输出带台词以及背景音的视频 注1：该参数为true时，voice_id参数才生效 注2：该参数为true时，仅q3模型支持错峰 注3：当model 为q3 时，该参数默认值为true
- is_recboolean
是否使用推荐提示词
- true：是，由系统自动推荐提示词，并使用提示词内容生成视频，推荐提示词数量=1
- false：否，根据输入的prompt生成视频
- seedinteger
随机种子 当默认不传或者传0时，会使用随机数替代 手动设置则使用设置的种子
- durationinteger
视频时长参数 viduq3-turbo 默认为 5，可选：1 - 16
- resolutionstring
分辨率参数 viduq3-turbo 1-16秒：默认 720p，可选：540p、720p、1080p
- movement_amplitudestring
运动幅度 默认 auto，可选值：auto、small、medium、large
请求
curl 'https://api.qnaigc.com/queue/fal-ai/vidu/q3/image-to-video/turbo?fal_webhook={fal_webhook}' \
--request POST \
--header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"prompt": "这个人在跑马拉松",
"image_url": "https://aitoken-public.qnaigc.com/example/generate-video/running-man.jpg",
"seed": 2,
"duration": 4,
"resolution": "720p",
"movement_amplitude": "auto"
}'响应
响应体属性
- statusstring, 必填
视频任务状态
- request_idstring, 必填
视频任务唯一 ID
- response_urlstring, 必填
查询任务结果的URL
- status_urlstring, 必填
查询任务状态的URL
- cancel_urlstring, 必填
取消任务的URL（暂未支持）
响应
{
"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": ""
}创建文生视频任务
创建文生视频任务，返回任务ID和查询任务状态及结果的URL
认证方式
Fal 格式接口鉴权方式：Authorization: Key {api_key}。
查询参数
- Name
- fal_webhook
- Type
- string<uri>
- Description
可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。
请求头
- Name
- Content-Type
- Type
- string
- Description
- 操作参数。
请求体
请求体属性
- promptstring, 必填
文本提示词 生成视频的文本描述。 注：字符长度不能超过 2000 个字符
- stylestring
风格 默认 general，可选值：general、anime general：通用风格，可以通过提示词来控制风格 anime：动漫风格，仅在动漫风格表现突出，可以通过不同的动漫风格提示词来控制 注：使用q2模型时该参数不生效
- seedinteger
随机种子 当默认不传或者传0时，会使用随机数替代 手动设置则使用设置的种子
- durationinteger
视频时长参数 viduq3-turbo 默认为 5，可选：1 - 16
- resolutionstring
分辨率参数 viduq3-turbo 1-16秒：默认 720p，可选：540p、720p、1080p
- aspect_ratiostring
比例 默认 16:9，可选值：16:9、9:16、3:4、4:3、1:1 注：3:4、4:3仅支持q2模型
- movement_amplitudestring
运动幅度 默认 auto，可选值：auto、small、medium、large
- bgmboolean
是否为生成的视频添加背景音乐。 默认：false，可选值 true 、false 传 true 时系统将从预设 BGM 库中自动挑选合适的音乐并添加；不传或为 false 则不添加 BGM。 BGM不限制时长，系统根据视频时长自动适配
请求
curl 'https://api.qnaigc.com/queue/fal-ai/vidu/q3/text-to-video/turbo?fal_webhook={fal_webhook}' \
--request POST \
--header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"prompt": "一只可爱的橘猫在阳光下追逐蝴蝶，慢镜头，电影质感，温暖的光线",
"seed": 1,
"duration": 5,
"resolution": "1080p",
"movement_amplitude": "auto"
}'响应
响应体属性
- statusstring, 必填
视频任务状态
- request_idstring, 必填
视频任务唯一 ID
- response_urlstring, 必填
查询任务结果的URL
- status_urlstring, 必填
查询任务状态的URL
- cancel_urlstring, 必填
取消任务的URL（暂未支持）
响应
{
"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": ""
}创建首尾帧生视频任务
创建首尾帧生视频任务，返回任务ID和查询任务状态及结果的URL
认证方式
Fal 格式接口鉴权方式：Authorization: Key {api_key}。
查询参数
- Name
- fal_webhook
- Type
- string<uri>
- Description
可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。
请求头
- Name
- Content-Type
- Type
- string
- Description
- 操作参数。
请求体
请求体属性
- promptstring
文本提示词 生成视频的文本描述。 注：字符长度不能超过 2000 个字符
- start_image_urlstring, 必填
首帧图像 模型将以此参数中传入的图片为首帧画面来生成视频。 注1：支持传入图片 Base64 编码或图片URL（确保可访问）； 注2：只支持输入 1 张图； 注3：图片支持 png、jpeg、jpg、webp格式； 注4：图片比例需要小于 1:4 或者 4:1 ； 注5：图片大小不超过 50 MB； 注6：请注意，http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，例如： data:image/png;base64,{base64_encode}
- end_image_urlstring, 必填
尾帧图像 模型将以此参数中传入的图片为尾帧画面来生成视频。要求同上
- is_recboolean
是否使用推荐提示词
- true：是，由系统自动推荐提示词，并使用提示词内容生成视频，推荐提示词数量=1
- false：否，根据输入的prompt生成视频
- seedinteger
随机种子 当默认不传或者传0时，会使用随机数替代 手动设置则使用设置的种子
- durationinteger
视频时长参数 viduq3-turbo 默认为 5，可选：1 - 16
- resolutionstring
分辨率参数 viduq3-turbo 1-16秒：默认 720p，可选：540p、720p、1080p
- movement_amplitudestring
运动幅度 默认 auto，可选值：auto、small、medium、large
请求
curl 'https://api.qnaigc.com/queue/fal-ai/vidu/q3/start-end-to-video/turbo?fal_webhook={fal_webhook}' \
--request POST \
--header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Dragon lands on a rock",
"start_image_url": "https://v3.fal.media/files/zebra/sgsdKvPigPhJ1S7Hl5bWc_first_frame_q1.png",
"end_image_url": "https://v3.fal.media/files/kangaroo/CASBu_OmOnZ8IafirarFL_last_frame_q1.png",
"seed": 2,
"duration": 4,
"resolution": "720p",
"movement_amplitude": "auto"
}'响应
响应体属性
- statusstring, 必填
视频任务状态
- request_idstring, 必填
视频任务唯一 ID
- response_urlstring, 必填
查询任务结果的URL
- status_urlstring, 必填
查询任务状态的URL
- cancel_urlstring, 必填
取消任务的URL（暂未支持）
响应
{
"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": ""
}'%3e%3cpath%20d='M44.867217,0.0054376148%20C130.715579,1.00591567%20200,70.9091172%20200,156.994562%20L199.986321,155.127494%20C199.384888,180.009127%20179.026368,199.994562%20154,199.994562%20L46,199.994562%20C20.5949015,199.994562%200,179.399661%200,153.994562%20L0,45.9945624%20C0,21.0975659%2019.7793434,0.820282524%2044.4815926,0.0191499894%20Z'%20fill='%2300D492'%3e%3c/path%3e%3cpath%20d='M123.867217,0.0054376148%20C209.715579,1.00591567%20279,70.9091172%20279,156.994562%20L278.986321,155.127494%20C278.384888,180.009127%20258.026368,199.994562%20233,199.994562%20L125,199.994562%20C99.5949015,199.994562%2079,179.399661%2079,153.994562%20L79,45.9945624%20C79,21.0975659%2098.7793434,0.820282524%20123.481593,0.0191499894%20Z'%20id='clarify-right'%20fill-opacity='0.6'%20fill='%2300F6C9'%20transform='translate(179,%20100)%20rotate(-90)%20translate(-179,%20-100)'%3e%3c/path%3e%3cpath%20d='M199.979267,154.416906%20L199.984438,155.157125%20L199.962366,155.872459%20C198.977251,180.406837%20178.776104,199.994562%20154,199.994562%20L124.372438,199.994125%20L124.249053,199.994081%20C99.6939678,199.603921%2079.8122712,179.973634%2079.01915,155.518407%20L79.0054376,155.132783%20C79.5830823,105.566626%20103.129768,61.5221348%20139.498462,33.1463428%20C175.69419,61.3871018%20199.186123,105.143863%20199.979267,154.416906%20Z'%20id='形状结合'%20fill='%2300F692'%3e%3c/path%3e%3c/g%3e%3c/g%3e%3c/svg%3e)