OpenAPI 参考

Modelink API · 视频

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

版本 1.0.0

创建文生视频任务

POST

/queue/minimax/h3/text-to-video

提交文本提示词生成 MiniMax H3 视频。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

Name
fal_webhook
Type
string<uri>
Description
可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

promptstring, 必填
文本提示词，必填，去除首尾空格后长度不超过 7000 字符。
durationinteger
生成视频时长（秒）。取值范围 5–15；默认 5。
default: 5; minimum: 5; maximum: 15
- 2K
- 768P
- 21:9
- 16:9
- 4:3
- 1:1
- 3:4
- 9:16
callback_urlstring<uri>
可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址；也可通过查询参数 fal_webhook 指定。详见 FAL 格式 Webhook。

请求

POST/queue/minimax/h3/text-to-video

curl 'https://api.qnaigc.com/queue/minimax/h3/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": "A white kitten chases a butterfly across a sunlit garden. Gentle camera tracking, natural movement, soft afternoon light filtering through the leaves.",
  "duration": 5,
  "resolution": "2K",
  "aspect_ratio": "16:9"
}'

响应

object

任务已入队（status 为 IN_QUEUE）

响应体属性

- 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，自签发之日起 7 天内有效，请及时下载并转存）。
  - content_typestring, 必填
    必填。
  - durationnumber<double>
    视频时长（秒）。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    文件大小（字节）。
- - total_secondsinteger
    总秒数（通常为输入秒与输出秒之和）。
  - input_secondsinteger
    参考视频输入时长（秒）；无参考视频时为 0 或省略。
  - output_secondsinteger
    生成视频输出时长（秒），为主要计费依据之一。
  - input_image_countinteger
    参考图片数量；用于超额参考图分项计费（通常前 5 张不额外计费）。

响应

{
  "status": "IN_QUEUE",
  "request_id": "string",
  "response_url": "string",
  "status_url": "string",
  "cancel_url": "string",
  "queue_position": 42,
  "logs": [
    {
      "message": "string",
      "level": "STDERR",
      "source": "string",
      "timestamp": "string"
    }
  ],
  "metrics": {
    "inference_time": 42
  }
}

创建图生/首尾帧视频任务

POST

/queue/minimax/h3/image-to-video

基于首帧图片（及可选尾帧）与文本提示词生成 MiniMax H3 视频。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

Name
fal_webhook
Type
string<uri>
Description
可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

promptstring, 必填
文本提示词，必填，去除首尾空格后长度不超过 7000 字符。
image_urlstring, 必填
首帧图像公网 HTTP(S) URL，必填。输出画幅跟随该图。
end_image_urlstring
可选尾帧图像公网 HTTP(S) URL，用于首尾帧过渡生成。
durationinteger
生成视频时长（秒）。取值范围 5–15；默认 5。
default: 5; minimum: 5; maximum: 15
- 2K
- 768P
callback_urlstring<uri>
可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址；也可通过查询参数 fal_webhook 指定。详见 FAL 格式 Webhook。

请求

POST/queue/minimax/h3/image-to-video

curl 'https://api.qnaigc.com/queue/minimax/h3/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": "The camera slowly pulls back from the scene, revealing the full landscape as clouds drift overhead and light shifts across the terrain.",
  "image_url": "https://storage.googleapis.com/falserverless/example_inputs/hailuo23/pro_i2v_in.jpg",
  "duration": 5,
  "resolution": "2K"
}'

响应

object

任务已入队（status 为 IN_QUEUE）

响应体属性

- 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，自签发之日起 7 天内有效，请及时下载并转存）。
  - content_typestring, 必填
    必填。
  - durationnumber<double>
    视频时长（秒）。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    文件大小（字节）。
- - total_secondsinteger
    总秒数（通常为输入秒与输出秒之和）。
  - input_secondsinteger
    参考视频输入时长（秒）；无参考视频时为 0 或省略。
  - output_secondsinteger
    生成视频输出时长（秒），为主要计费依据之一。
  - input_image_countinteger
    参考图片数量；用于超额参考图分项计费（通常前 5 张不额外计费）。

响应

{
  "status": "IN_QUEUE",
  "request_id": "string",
  "response_url": "string",
  "status_url": "string",
  "cancel_url": "string",
  "queue_position": 42,
  "logs": [
    {
      "message": "string",
      "level": "STDERR",
      "source": "string",
      "timestamp": "string"
    }
  ],
  "metrics": {
    "inference_time": 42
  }
}

创建多模态参考生视频任务

POST

/queue/minimax/h3/reference-to-video

基于多模态参考素材（图片 / 视频 / 音频）与文本提示词生成 MiniMax H3 视频。

认证方式

FalApiKeyAuthAPI 密钥

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

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

Name
fal_webhook
Type
string<uri>
Description
可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

promptstring, 必填
文本提示词，必填，去除首尾空格后长度不超过 7000 字符。按模态与列表顺序引用参考素材，例如 Image 1、Image 2、Video 1、Audio 1。
durationinteger
生成视频时长（秒）。取值范围 5–15；默认 5。
default: 5; minimum: 5; maximum: 15
- 2K
- 768P
- adaptive
- 21:9
- 16:9
- 4:3
- 1:1
- 3:4
- 9:16
reference_image_urlsstring[]
主体/风格参考图 URL 列表，在 prompt 中按 Image 1、Image 2… 引用。最多 9 张；与参考视频、音频合计不超过 12 个文件。
reference_video_urlsstring[]
动作/参考视频 URL 列表，在 prompt 中按 Video 1… 引用。最多 3 段；单段 2–15 秒，合计不超过 15 秒；与图、音频合计不超过 12 个文件。
reference_audio_urlsstring[]
参考音频 URL 列表，在 prompt 中按 Audio 1… 引用。最多 3 段；单段 2–15 秒，合计不超过 15 秒。不能只传音频，须同时提供至少一张参考图或一段参考视频；与图、视频合计不超过 12 个文件。
callback_urlstring<uri>
可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址；也可通过查询参数 fal_webhook 指定。详见 FAL 格式 Webhook。

请求

POST/queue/minimax/h3/reference-to-video

curl 'https://api.qnaigc.com/queue/minimax/h3/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": "Image 1 is the female protagonist. Image 2 is her small dog. Keep the woman and dog consistent with their respective reference images while they walk together through a sunlit garden.",
  "duration": 5,
  "resolution": "2K",
  "aspect_ratio": "adaptive",
  "reference_image_urls": [
    "https://storage.googleapis.com/falserverless/example_inputs/hailuo23/pro_i2v_in.jpg"
  ]
}'

响应

object

任务已入队（status 为 IN_QUEUE）

响应体属性

- 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，自签发之日起 7 天内有效，请及时下载并转存）。
  - content_typestring, 必填
    必填。
  - durationnumber<double>
    视频时长（秒）。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    文件大小（字节）。
- - total_secondsinteger
    总秒数（通常为输入秒与输出秒之和）。
  - input_secondsinteger
    参考视频输入时长（秒）；无参考视频时为 0 或省略。
  - output_secondsinteger
    生成视频输出时长（秒），为主要计费依据之一。
  - input_image_countinteger
    参考图片数量；用于超额参考图分项计费（通常前 5 张不额外计费）。

响应

{
  "status": "IN_QUEUE",
  "request_id": "string",
  "response_url": "string",
  "status_url": "string",
  "cancel_url": "string",
  "queue_position": 42,
  "logs": [
    {
      "message": "string",
      "level": "STDERR",
      "source": "string",
      "timestamp": "string"
    }
  ],
  "metrics": {
    "inference_time": 42
  }
}