OpenAPI 参考

Modelink API · 视频

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

版本 1.0.0

查询任务状态

GET

/queue/fal-ai/vidu/requests/{request_id}/status

根据request_id查询视频任务的状态

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

在 Authorization 请求头中传入 API Key 或访问令牌，格式：Bearer {token}。

Bearer 格式：JWT

路径参数

Name
request_id
Type
string, 必填
Description
操作参数。

请求体

暂无请求体

请求

GET/queue/fal-ai/vidu/requests/{request_id}/status

curl https://api.qnaigc.com/queue/fal-ai/vidu/requests/{request_id}/status \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json'

响应

object & object

响应.

响应体属性

allOf[0]object
- statusenum, 必填
  任务状态。注意：任务失败时后端也返回 COMPLETED，通过 detail 字段区分成功/失败。
  - IN_QUEUE
  - IN_PROGRESS
  - COMPLETED
  - FAILED
- request_idstring, 必填
  必填。
- response_urlstring<uri>, 必填
  必填。
- status_urlstring<uri>, 必填
  必填。
- cancel_urlstring
  取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。
- queue_positioninteger
  可选。
- logsobject[]
  - messagestring
    可选。
  - levelenum
    STDERR
    STDOUT
    ERROR
    INFO
    WARN
    DEBUG
  - sourcestring
    可选。
  - timestampstring<date-time>
    ISO 8601 格式。
- metricsobject
  - inference_timenumber<double>
    推理耗时（秒）。
- detailobject | null
  任务失败或进行中时的错误/状态详情；成功或排队时为 null。
  - oneOf[0]object
    locstring[], 必填
    错误位置。
    msgstring, 必填
    人类可读的错误描述。
    typestring, 必填
    机器可读的错误分类标识符。
    urlstring, 必填
    错误类型文档链接。
    ctx
    附加结构化上下文（可选）。
    input
    导致错误的输入（可选）。
  - oneOf[1]null
    可选。
- resultobject
  任务结果。图片类任务返回 images，视频类任务返回 video。
  - imagesobject[]
    图片结果列表（图片类任务）。
    urlstring, 必填
    图片下载链接（Kodo 签名 URL，自签发之日起 7 天内有效，请及时下载并转存）。
    content_typestring, 必填
    必填。
    file_namestring
    可选。
    file_sizeinteger<int64>
    可选。
    widthinteger
    可选。
    heightinteger
    可选。
  - videoobject
    urlstring, 必填
    视频下载链接（Kodo 签名 URL，自签发之日起 7 天内有效，请及时下载并转存）。
    content_typestring, 必填
    必填。
    durationnumber<double>
    视频时长（秒）。
    file_namestring
    可选。
    file_sizeinteger<int64>
    文件大小（字节）。
allOf[1]object
- resultobject & object | object & object & object
  - anyOf[0]object & object
    Vidu 视频任务结果。始终包含 video。
    allOf[0]object
    任务结果。图片类任务返回 images，视频类任务返回 video。
    imagesobject[]
    图片结果列表（图片类任务）。
    urlstring, 必填
    图片下载链接（Kodo 签名 URL，自签发之日起 7 天内有效，请及时下载并转存）。
    content_typestring, 必填
    必填。
    file_namestring
    可选。
    file_sizeinteger<int64>
    可选。
    widthinteger
    可选。
    heightinteger
    可选。
    videoobject
    urlstring, 必填
    视频下载链接（Kodo 签名 URL，自签发之日起 7 天内有效，请及时下载并转存）。
    content_typestring, 必填
    必填。
    durationnumber<double>
    视频时长（秒）。
    file_namestring
    可选。
    file_sizeinteger<int64>
    文件大小（字节）。
    allOf[1]object
    可选。
  - anyOf[1]object & object & object
    Vidu Q4 Preview 视频任务结果。包含 video，并可能返回 cover_image 和供应商实际使用的 seed。
    allOf[0]object & object
    Vidu 视频任务结果。始终包含 video。
    allOf[0]object
    任务结果。图片类任务返回 images，视频类任务返回 video。
    imagesobject[]
    图片结果列表（图片类任务）。
    urlstring, 必填
    图片下载链接（Kodo 签名 URL，自签发之日起 7 天内有效，请及时下载并转存）。
    content_typestring, 必填
    必填。
    file_namestring
    可选。
    file_sizeinteger<int64>
    可选。
    widthinteger
    可选。
    heightinteger
    可选。
    videoobject
    urlstring, 必填
    视频下载链接（Kodo 签名 URL，自签发之日起 7 天内有效，请及时下载并转存）。
    content_typestring, 必填
    必填。
    durationnumber<double>
    视频时长（秒）。
    file_namestring
    可选。
    file_sizeinteger<int64>
    文件大小（字节）。
    allOf[1]object
    可选。
    allOf[1]object
    cover_imageobject
    Vidu Q4 Preview 视频封面。
    allOf[0]object
    单张图片结果。
    urlstring, 必填
    图片下载链接（Kodo 签名 URL，自签发之日起 7 天内有效，请及时下载并转存）。
    content_typestring, 必填
    必填。
    file_namestring
    可选。
    file_sizeinteger<int64>
    可选。
    widthinteger
    可选。
    heightinteger
    可选。
    seedinteger<int64>
    Vidu Q4 Preview 供应商实际使用的随机种子。仅在供应商返回该值时出现，可能与请求中传入的值不同。

object

任务进行中（IN_QUEUE / IN_PROGRESS）。

响应体属性

statusenum, 必填
任务状态。注意：任务失败时后端也返回 COMPLETED，通过 detail 字段区分成功/失败。
- IN_QUEUE
- IN_PROGRESS
- COMPLETED
- FAILED
request_idstring, 必填
必填。
response_urlstring<uri>, 必填
必填。
status_urlstring<uri>, 必填
必填。
cancel_urlstring
取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。
queue_positioninteger
可选。
logsobject[]
- messagestring
  可选。
- levelenum
  - STDERR
  - STDOUT
  - ERROR
  - INFO
  - WARN
  - DEBUG
- sourcestring
  可选。
- timestampstring<date-time>
  ISO 8601 格式。
metricsobject
- inference_timenumber<double>
  推理耗时（秒）。
detailobject | null
任务失败或进行中时的错误/状态详情；成功或排队时为 null。
- oneOf[0]object
  - locstring[], 必填
    错误位置。
  - msgstring, 必填
    人类可读的错误描述。
  - typestring, 必填
    机器可读的错误分类标识符。
  - urlstring, 必填
    错误类型文档链接。
  - ctx
    附加结构化上下文（可选）。
  - input
    导致错误的输入（可选）。
- oneOf[1]null
  可选。
resultobject
任务结果。图片类任务返回 images，视频类任务返回 video。
- imagesobject[]
  图片结果列表（图片类任务）。
  - urlstring, 必填
    图片下载链接（Kodo 签名 URL，自签发之日起 7 天内有效，请及时下载并转存）。
  - content_typestring, 必填
    必填。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    可选。
  - widthinteger
    可选。
  - heightinteger
    可选。
- videoobject
  - urlstring, 必填
    视频下载链接（Kodo 签名 URL，自签发之日起 7 天内有效，请及时下载并转存）。
  - content_typestring, 必填
    必填。
  - durationnumber<double>
    视频时长（秒）。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    文件大小（字节）。

响应

{
  "status": "COMPLETED",
  "request_id": "qvideo-root-1770720203757316283",
  "response_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770720203757316283",
  "status_url": "https://api.qnaigc.com/queue/fal-ai/vidu/requests/qvideo-root-1770720203757316283/status",
  "cancel_url": "",
  "metrics": {
    "inference_time": 2252
  },
  "result": {
    "video": {
      "url": "https://cdn.example.com/output/video.mp4",
      "content_type": "video/mp4",
      "duration": 5
    }
  }
}

查询任务结果

GET

/queue/fal-ai/vidu/requests/{request_id}

根据request_id查询视频任务的结果

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

在 Authorization 请求头中传入 API Key 或访问令牌，格式：Bearer {token}。

Bearer 格式：JWT

路径参数

Name
request_id
Type
string, 必填
Description
操作参数。

请求体

暂无请求体

请求

GET/queue/fal-ai/vidu/requests/{request_id}

curl https://api.qnaigc.com/queue/fal-ai/vidu/requests/{request_id} \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json'

响应

object & object | object & object & object

响应.

响应体属性

anyOf[0]object & object
Vidu 视频任务结果。始终包含 video。
- allOf[0]object
  任务结果。图片类任务返回 images，视频类任务返回 video。
  - imagesobject[]
    图片结果列表（图片类任务）。
    urlstring, 必填
    图片下载链接（Kodo 签名 URL，自签发之日起 7 天内有效，请及时下载并转存）。
    content_typestring, 必填
    必填。
    file_namestring
    可选。
    file_sizeinteger<int64>
    可选。
    widthinteger
    可选。
    heightinteger
    可选。
  - videoobject
    urlstring, 必填
    视频下载链接（Kodo 签名 URL，自签发之日起 7 天内有效，请及时下载并转存）。
    content_typestring, 必填
    必填。
    durationnumber<double>
    视频时长（秒）。
    file_namestring
    可选。
    file_sizeinteger<int64>
    文件大小（字节）。
- allOf[1]object
  可选。
anyOf[1]object & object & object
Vidu Q4 Preview 视频任务结果。包含 video，并可能返回 cover_image 和供应商实际使用的 seed。
- allOf[0]object & object
  Vidu 视频任务结果。始终包含 video。
  - allOf[0]object
    任务结果。图片类任务返回 images，视频类任务返回 video。
    imagesobject[]
    图片结果列表（图片类任务）。
    urlstring, 必填
    图片下载链接（Kodo 签名 URL，自签发之日起 7 天内有效，请及时下载并转存）。
    content_typestring, 必填
    必填。
    file_namestring
    可选。
    file_sizeinteger<int64>
    可选。
    widthinteger
    可选。
    heightinteger
    可选。
    videoobject
    urlstring, 必填
    视频下载链接（Kodo 签名 URL，自签发之日起 7 天内有效，请及时下载并转存）。
    content_typestring, 必填
    必填。
    durationnumber<double>
    视频时长（秒）。
    file_namestring
    可选。
    file_sizeinteger<int64>
    文件大小（字节）。
  - allOf[1]object
    可选。
- allOf[1]object
  - cover_imageobject
    Vidu Q4 Preview 视频封面。
    allOf[0]object
    单张图片结果。
    urlstring, 必填
    图片下载链接（Kodo 签名 URL，自签发之日起 7 天内有效，请及时下载并转存）。
    content_typestring, 必填
    必填。
    file_namestring
    可选。
    file_sizeinteger<int64>
    可选。
    widthinteger
    可选。
    heightinteger
    可选。
  - seedinteger<int64>
    Vidu Q4 Preview 供应商实际使用的随机种子。仅在供应商返回该值时出现，可能与请求中传入的值不同。

object

响应.

响应体属性

statusstring, 必填
状态
request_idstring, 必填
必填。
response_urlstring, 必填
必填。
status_urlstring, 必填
必填。
cancel_urlstring, 必填
必填。
queue_positioninteger, 必填
必填。
logsobject[], 必填
- messagestring
  可选。
- levelenum
  - STDERR
  - STDOUT
  - ERROR
  - INFO
  - WARN
  - DEBUG
- sourcestring
  可选。
- timestampstring<date-time>
  ISO 8601 格式。
detailobject, 必填
- locstring[], 必填
  必填。
- msgstring, 必填
  必填。
- typestring, 必填
  必填。
- urlstring, 必填
  错误类型文档链接。

响应

{
  "video": {
    "url": "https://cdn.example.com/output/video.mp4",
    "content_type": "video/mp4",
    "duration": 5
  },
  "cover_image": {
    "url": "https://cdn.example.com/output/cover.jpg",
    "content_type": "image/jpeg"
  },
  "seed": 84104936
}