OpenAPI 参考

Modelink API · 视频

Modelink 视频生成 API，涵盖 OpenAI 风格、Fal 队列、可灵、豆包 Seedance、Vidu、Veo 等多厂商的文生视频、图生视频与任务查询能力。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

响应.

响应体属性

- IN_QUEUE
- IN_PROGRESS
- COMPLETED
- FAILED
request_idstring, 必填
必填。
response_urlstring, 必填
必填。
status_urlstring, 必填
必填。
cancel_urlstring, 必填
必填。
- inference_timeinteger, 必填
  必填。
- - urlstring, 必填
    必填。
  - content_typestring, 必填
    必填。

响应

{
  "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://aitoken-video.qnaigc.com/root/qvideo-root-1770720203757316283/1.mp4?e=1771327255&token=IDB69r4gicDbMd9Fbmn9w2bWuEENg9i5_yasXqhp:ak0Qh973b2_JYshnkbvwG87rakI=",
      "content_type": "video/mp4"
    }
  }
}

查询任务结果

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

响应.

响应体属性

- urlstring, 必填
  必填。
- content_typestring, 必填
  必填。

object

响应.

响应体属性

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

响应

{
  "video": {
    "url": "https://aitoken-video.qnaigc.com/root/qvideo-root-1770708425639493000/1.mp4?e=1771314526&token=IDB69r4gicDbMd9Fbmn9w2bWuEENg9i5_yasXqhp:fw2OIbh4wSMbl5UA1VxIf-y-kP0=",
    "content_type": "video/mp4"
  }
}