Modelink

OpenAPI 参考

Modelink API · 视频

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

版本 1.0.0

创建 Q4 Preview 图生视频任务

POST
/queue/fal-ai/vidu/q4/image-to-video

使用 Vidu Q4 Preview 创建图生视频任务。请求体最大为 20 MB。任务创建后，使用 Vidu 公共任务查询接口获取状态和结果。任务完成时，结果除 video 外还可能包含 cover_image 和供应商实际使用的 seed。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

  • promptstring

    视频生成提示词，最多 5000 个字符。

  • image_urlstring, 必填

    首帧图片。支持可公开访问的 HTTP(S) URL 或 data:image/* Base64 图片。

  • durationinteger

    视频时长，单位为秒。未传时默认 5 秒，取值范围为 3 到 16。

    default: 5; minimum: 3; maximum: 16

  • seedinteger<int64>

    随机种子。不传时由系统随机生成；显式传入 0 也表示随机生成，任务结果中的 seed 返回供应商实际使用的值。

  • resolutionenum

    输出分辨率。未传时默认 720p。

    default: 720p

请求

POST/queue/fal-ai/vidu/q4/image-to-video
curl 'https://api.qnaigc.com/queue/fal-ai/vidu/q4/image-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 slow cinematic camera push with natural motion",
  "image_url": "https://cdn.example.com/input/reference.jpg",
  "duration": 5,
  "seed": 0,
  "resolution": "2K"
}'

响应

object

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

响应体属性

  • statusstring, 必填

    任务状态，创建成功后通常为 IN_QUEUE。

  • request_idstring, 必填

    视频任务唯一 ID，用于查询状态和结果。

  • response_urlstring<uri>, 必填

    查询任务最终结果的 URL。

  • status_urlstring<uri>, 必填

    查询任务状态的 URL。

  • cancel_urlstring

    取消任务的 URL（暂不支持）。

  • queue_positioninteger

    队列位置（入队时为 0）。

  • logsobject[]

    日志条目（入队时为空/ null）。

    • messagestring
      可选。
    • levelenum
    • sourcestring
      可选。
    • timestampstring<date-time>

      ISO 8601 格式。

响应

application/json
{
  "status": "IN_QUEUE",
  "request_id": "qvideo-user-1792045603184744590",
  "response_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-user-1792045603184744590",
  "status_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-user-1792045603184744590/status"
}

创建 Q4 Preview 参考生视频任务

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

使用 Vidu Q4 Preview 创建参考生视频任务。支持参考图片和参考音频，请求体最大为 20 MB。任务创建后，使用 Vidu 公共任务查询接口获取状态和结果。任务完成时，结果除 video 外还可能包含 cover_image 和供应商实际使用的 seed。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

查询参数

  • Name
    fal_webhook
    Type
    string<uri>
    Description

    可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

  • promptstring, 必填

    视频生成提示词。去除首尾空白后不能为空，最多 5000 个字符。

  • reference_image_urlsstring[], 必填

    参考图片列表，支持 1 到 12 张图片。每项可使用可公开访问的 HTTP(S) URL 或 data:image/* Base64 图片。

  • reference_audio_urlsstring[]

    可选的参考音频列表，最多 3 个。每项可使用可公开访问的 HTTP(S) URL，或带 audio/mpeg、audio/mp3、video/mp3 MIME 的 MP3 Base64 Data URI。

  • durationinteger

    视频时长，单位为秒。未传时默认 5 秒，取值范围为 3 到 16。

    default: 5; minimum: 3; maximum: 16

  • seedinteger<int64>

    随机种子。不传时由系统随机生成；显式传入 0 也表示随机生成，任务结果中的 seed 返回供应商实际使用的值。

  • aspect_ratioenum

    输出视频的宽高比。未传时默认 16:9。

    default: 16:9

  • resolutionenum

    输出分辨率。未传时默认 720p。

    default: 720p

  • audioboolean

    是否启用音视频直出。未传时默认 false；显式传入 false 会被保留。

    default: false

请求

POST/queue/fal-ai/vidu/q4/reference-to-video
curl 'https://api.qnaigc.com/queue/fal-ai/vidu/q4/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 subject speaks naturally with subtle movement and a stable camera",
  "reference_image_urls": [
    "https://cdn.example.com/input/reference.jpg"
  ],
  "reference_audio_urls": [
    "https://cdn.example.com/input/voice.mp3"
  ],
  "duration": 5,
  "seed": 0,
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "audio": true
}'

响应

object

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

响应体属性

  • statusstring, 必填

    任务状态，创建成功后通常为 IN_QUEUE。

  • request_idstring, 必填

    视频任务唯一 ID，用于查询状态和结果。

  • response_urlstring<uri>, 必填

    查询任务最终结果的 URL。

  • status_urlstring<uri>, 必填

    查询任务状态的 URL。

  • cancel_urlstring

    取消任务的 URL（暂不支持）。

  • queue_positioninteger

    队列位置（入队时为 0）。

  • logsobject[]

    日志条目（入队时为空/ null）。

    • messagestring
      可选。
    • levelenum
    • sourcestring
      可选。
    • timestampstring<date-time>

      ISO 8601 格式。

响应

application/json
{
  "status": "IN_QUEUE",
  "request_id": "qvideo-user-1792045603576142338",
  "response_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-user-1792045603576142338",
  "status_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-user-1792045603576142338/status"
}

Last updated

© 2026 Modelink. All rights reserved.

构建来自Clarify