Modelink

OpenAPI 参考

Modelink API · 视频

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

版本 1.0.0

创建图生视频任务

POST
/queue/fal-ai/vidu/q2/image-to-video/turbo

创建图生视频任务，返回任务ID和查询任务状态及结果的URL

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

查询参数

  • 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-turbo 默认为 5，可选：1、2、3、4、5、6、7、8、9、10

  • resolutionstring

    分辨率参数，默认值依据模型和视频时长而定： viduq2-turbo 1-10秒：默认 720p，可选：540p、720p、1080p

  • movement_amplitudestring

    运动幅度 默认 auto，可选值：auto、small、medium、large

请求

POST/queue/fal-ai/vidu/q2/image-to-video/turbo
curl 'https://api.qnaigc.com/queue/fal-ai/vidu/q2/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"
}'

响应

object
响应.

响应体属性

  • statusstring, 必填

    视频任务状态

  • request_idstring, 必填

    视频任务唯一 ID

  • response_urlstring, 必填

    查询任务结果的URL

  • status_urlstring, 必填

    查询任务状态的URL

  • cancel_urlstring, 必填

    取消任务的URL（暂未支持）

响应

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

创建首尾帧生视频任务

POST
/queue/fal-ai/vidu/q2/start-end-to-video/turbo

创建首尾帧生视频任务，返回任务ID和查询任务状态及结果的URL

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

查询参数

  • 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-turbo 默认为 5，可选：1、2、3、4、5、6、7、8

  • resolutionstring

    viduq2-turbo 1-8秒：默认 720p，可选：540p、720p、1080p

  • movement_amplitudestring

    运动幅度 默认 auto，可选值：auto、small、medium、large

请求

POST/queue/fal-ai/vidu/q2/start-end-to-video/turbo
curl 'https://api.qnaigc.com/queue/fal-ai/vidu/q2/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"
}'

响应

object
响应.

响应体属性

  • statusstring, 必填

    视频任务状态

  • request_idstring, 必填

    视频任务唯一 ID

  • response_urlstring, 必填

    查询任务结果的URL

  • status_urlstring, 必填

    查询任务状态的URL

  • cancel_urlstring, 必填

    取消任务的URL（暂未支持）

响应

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

Last updated

© 2026 Modelink. All rights reserved.

构建来自Clarify