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/text-to-video

创建文生视频任务，返回任务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 个字符

  • stylestring

    风格 默认 general，可选值：general、anime general：通用风格，可以通过提示词来控制风格 anime：动漫风格，仅在动漫风格表现突出，可以通过不同的动漫风格提示词来控制 注：使用q2模型时该参数不生效

  • seedinteger

    随机种子 当默认不传或者传0时，会使用随机数替代 手动设置则使用设置的种子

  • durationinteger

    视频时长参数 默认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不限制时长，系统根据视频时长自动适配

请求

POST/queue/fal-ai/vidu/q2/text-to-video
curl 'https://api.qnaigc.com/queue/fal-ai/vidu/q2/text-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": "一只可爱的橘猫在阳光下追逐蝴蝶，慢镜头，电影质感，温暖的光线",
  "seed": 1,
  "duration": 5,
  "resolution": "1080p",
  "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/reference-to-video

创建参考生视频任务参考生视频分为音视频直出、视频直出功能，二者使用相同的接口地址与请求方式，请求体不同，参考下方示例。 参考生视频-音视频直出：您可以指定视频中的主体用台词对话，直接生成完整的音视频； 参考生视频-视频直出：为视频的场景配置对应背景音乐，不含台词； 返回任务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, 必填

    文本提示词 生成视频的文本描述。 注1：字符长度不能超过 2000 个字符 注2：使用sujects主体参数时，可以通过@主体id 来表示主体内容，例如："@1 和 @2 在一起吃火锅，并且旁白音说火锅大家都爱吃。"

    • idstring, 必填

      主体id，后续生成时可以通过@主体id的方式使用

    • imagesstring[], 必填

      该主体对应的图片url，每个主体最多支持3张图片 注1：支持传入图片 Base64 编码或图片URL（确保可访问） 注2：图片支持 png、jpeg、jpg、webp格式 注3：图片像素不能小于 128*128，且比例需要小于1:4或者4:1，且大小不超过50M。 注4：请注意，http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，例如： data:image/png;base64,{base64_encode}

    • voice_idstring, 必填

      音色ID用来决定视频中的声音音色，为空时系统会自动推荐，可选枚举值参考列表：新音色列表 或者您可以使用声音复刻API来复刻任意音色，voice_id可以互通

  • seedinteger

    随机种子 当默认不传或者传0时，会使用随机数替代 手动设置则使用设置的种子

  • audioboolean

    是否使用音视频直出能力，可选值 true、false true：使用音视频直出能力。 false：不使用音视频直出能力。 使用subjects参数调用音视频直出能力时选用

  • durationinteger

    视频时长参数 viduq2：默认5秒，可选：1-10

  • resolutionstring

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

  • movement_amplitudestring

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

  • aspect_ratiostring

    比例 默认 16:9，可选值：16:9、9:16、3:4、4:3、1:1 注：3:4、4:3仅支持q2模型

  • bgmboolean

    是否为生成的视频添加背景音乐。 默认：false，可选值 true 、false 传 true 时系统将从预设 BGM 库中自动挑选合适的音乐并添加；不传或为 false 则不添加 BGM。 BGM不限制时长，系统根据视频时长自动适配

请求

POST/queue/fal-ai/vidu/q2/reference-to-video
curl 'https://api.qnaigc.com/queue/fal-ai/vidu/q2/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": "The @devil is looking at the @apple on the @beach and walking around @beach.",
  "subjects": [
    {
      "id": "devil",
      "images": [
        "https://storage.googleapis.com/falserverless/web-examples/vidu/new-examples/reference1.png"
      ],
      "voice_id": ""
    },
    {
      "id": "apple",
      "images": [
        "https://storage.googleapis.com/falserverless/web-examples/vidu/new-examples/reference1.png"
      ],
      "voice_id": ""
    },
    {
      "id": "beach",
      "images": [
        "https://storage.googleapis.com/falserverless/web-examples/vidu/new-examples/reference1.png"
      ],
      "voice_id": ""
    }
  ],
  "seed": 2,
  "duration": 5,
  "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