OpenAPI 参考

Modelink API · 视频

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

版本 1.0.0

查询状态

GET

/queue/fal-ai/veo3.1/requests/{request_id}/status

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

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

查询参数

Name
logs
Type
number
Description
操作参数。

请求体

暂无请求体

请求

GET/queue/fal-ai/veo3.1/requests/{request_id}/status

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

响应

object

The request status.

响应体属性

- IN_QUEUE
- IN_PROGRESS
- COMPLETED
- FAILED
request_idstring, 必填
The request id.
response_urlstring
The response url.
status_urlstring
The status url.
cancel_urlstring
The cancel url.
logsobject | null
The logs.
additionalProperties: true
metricsobject
The metrics.
additionalProperties: true
queue_positioninteger
The queue position.
- - urlstring, 必填
    图片下载链接（Kodo 签名 URL）。
    content_typestring, 必填
    必填。
    file_namestring
    可选。
    file_sizeinteger<int64>
    可选。
    widthinteger
    可选。
    heightinteger
    可选。
  - urlstring, 必填
    视频下载链接（有效期有限，建议尽快下载）。
    content_typestring, 必填
    必填。
    durationnumber<double>
    视频时长（秒）。
    file_namestring
    可选。
    file_sizeinteger<int64>
    文件大小（字节）。
- oneOf[1]null
  可选。
- - locstring[]
    错误位置。
  - msgstring
    人类可读的错误描述。
  - typestring
    机器可读的错误分类标识符。
  - urlstring
    错误类型文档链接。
  - ctx
    附加结构化上下文（可选）。
  - input
    导致错误的输入（可选）。
- oneOf[1]null
  可选。

响应

{
  "status": "IN_QUEUE",
  "request_id": "string",
  "response_url": "string",
  "status_url": "string",
  "cancel_url": "string",
  "logs": {},
  "metrics": {},
  "queue_position": 42
}

获取结果

GET

/queue/fal-ai/veo3.1/requests/{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/veo3.1/requests/{request_id}

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

响应

object

Result of the request.

响应体属性

- urlstring, 必填
  图片下载链接（Kodo 签名 URL）。
- content_typestring, 必填
  必填。
- file_namestring
  可选。
- file_sizeinteger<int64>
  可选。
- widthinteger
  可选。
- heightinteger
  可选。
- urlstring, 必填
  视频下载链接（有效期有限，建议尽快下载）。
- content_typestring, 必填
  必填。
- durationnumber<double>
  视频时长（秒）。
- file_namestring
  可选。
- file_sizeinteger<int64>
  文件大小（字节）。

object

任务尚未完成（进行中），或 request_id 无效。

响应体属性

- IN_QUEUE
- IN_PROGRESS
- COMPLETED
- FAILED
request_idstring, 必填
必填。
response_urlstring<uri>, 必填
必填。
status_urlstring<uri>, 必填
必填。
cancel_urlstring
取消任务的 URL（fal queue 协议恒返回，当前取消功能未开放，返回空串）。
queue_positioninteger
可选。
- messagestring
  可选。
- - STDERR
  - STDOUT
  - ERROR
  - INFO
  - WARN
  - DEBUG
- sourcestring
  可选。
- timestampstring<date-time>
  ISO 8601 格式。
- inference_timenumber<double>
  推理耗时（秒）。
- - locstring[]
    错误位置。
  - msgstring
    人类可读的错误描述。
  - typestring
    机器可读的错误分类标识符。
  - urlstring
    错误类型文档链接。
  - ctx
    附加结构化上下文（可选）。
  - input
    导致错误的输入（可选）。
- oneOf[1]null
  可选。
- - urlstring, 必填
    图片下载链接（Kodo 签名 URL）。
  - content_typestring, 必填
    必填。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    可选。
  - widthinteger
    可选。
  - heightinteger
    可选。
- - urlstring, 必填
    视频下载链接（有效期有限，建议尽快下载）。
  - content_typestring, 必填
    必填。
  - durationnumber<double>
    视频时长（秒）。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    文件大小（字节）。

响应

{
  "images": [
    {
      "url": "string",
      "content_type": "string",
      "file_name": "string",
      "file_size": 42,
      "width": 42,
      "height": 42
    }
  ],
  "video": {
    "url": "string",
    "content_type": "string",
    "duration": 42,
    "file_name": "string",
    "file_size": 42
  }
}