OpenAPI 参考
Modelink API · 视频
Modelink 视频生成 API，涵盖 OpenAI 风格、Fal 队列、可灵、豆包 Seedance、Vidu、Veo 等多厂商的文生视频、图生视频与任务查询能力。Fal 格式接口使用 Authorization: Key {api_key}；其他接口使用 Bearer 鉴权。
版本 1.0.0
创建图生视频任务
创建图生视频任务，返回任务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
- voice_idstring
音色id，用来决定视频中的声音音色，为空时系统会自动推荐，可选枚举值参考列表：https://shengshu.feishu.cn/sheets/EgFvs6DShhiEBStmjzccr5gonOg
- is_recboolean
是否使用推荐提示词
- true：是，由系统自动推荐提示词，并使用提示词内容生成视频，推荐提示词数量=1
- false：否，根据输入的prompt生成视频
- seedinteger
随机种子 当默认不传或者传0时，会使用随机数替代 手动设置则使用设置的种子
- durationinteger
视频时长参数 viduq2-pro 默认为 5，可选：1、2、3、4、5、6、7、8、9、10
- resolutionstring
分辨率参数 viduq2-pro 默认为 5，可选：1、2、3、4、5、6、7、8、9、10
- movement_amplitudestring
运动幅度 默认 auto，可选值：auto、small、medium、large
- watermarkboolean
是否添加水印，可选。
请求
curl 'https://api.qnaigc.com/queue/fal-ai/vidu/q2/image-to-video/pro?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",
"watermark": true
}'响应
响应体属性
- 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
视频时长参数 viduq2-pro 1-8秒：默认 720p，可选：540p、720p、1080p
- resolutionstring
分辨率参数 viduq2-pro 1-8秒：默认 720p，可选：540p、720p、1080p
- movement_amplitudestring
运动幅度 默认 auto，可选值：auto、small、medium、large
请求
curl 'https://api.qnaigc.com/queue/fal-ai/vidu/q2/start-end-to-video/pro?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": ""
}创建参考生视频任务-非主体调用（视频生成）
创建参考生视频任务参考生视频分为音视频直出、视频直出功能，二者使用相同的接口地址与请求方式，请求体不同，参考下方示例。 参考生视频-音视频直出：您可以指定视频中的主体用台词对话，直接生成完整的音视频； 参考生视频-视频直出：为视频的场景配置对应背景音乐，不含台词。 返回任务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 个字符
- reference_image_urlsstring[], 必填
图像参考支持上传1～7张图片，模型将以此参数中传入的图片中的主题为参考生成具备主体一致的视频。 注1： viduq2、viduq1、vidu2.0模型支持上传1～7张图片 注2：使用viduq2-pro模型时，如果不上传视频，则支持上传1-7张图，如果上传视频则支持1-4张图 注3：支持传入图片 Base64 编码或图片URL（确保可访问） 注4：图片支持 png、jpeg、jpg、webp格式 注5：图片像素不能小于 128*128，且比例需要小于1:4或者4:1，且大小不超过50M。 注6：请注意，http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，例如：data:image/png;base64,{base64_encode}
- reference_video_urlsstring[], 必填
视频参考支持上传1～2个视频，模型将以此参数中传入的视频作为参考，生成具备主体一致的视频。
- seedinteger
随机种子 当默认不传或者传0时，会使用随机数替代 手动设置则使用设置的种子
- durationinteger
视频时长参数 viduq2：默认5秒，可选：1-10
- resolutionstring
分辨率参数 viduq2 （1-10秒）：默认 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/q2/reference-to-video/pro?fal_webhook={fal_webhook}' \
--request POST \
--header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"prompt": "@Figure 1 Character Reference@Refer to the special effects, movements, and camera work of Video 1.",
"reference_image_urls": [
"https://storage.googleapis.com/falserverless/model_tests/video_models/vidu-image-3123041388101890.png"
],
"reference_video_urls": [
"https://storage.googleapis.com/falserverless/model_tests/video_models/vidu-video-3123002003131623.mp4"
],
"duration": 4,
"resolution": "720p",
"aspect_ratio": "16:9",
"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)