OpenAPI 参考

Modelink API · 视频

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

请求头

Name
X-Qiniu-Video-API-Format
Type
enum
Description
可选。默认会将生成视频转存到平台存储后再返回 URL，以保证结果在较长时间内可访问；转存会增加下载、上传和存储处理时间。设为 origin 时，直接返回供应商原始视频 URL，跳过转存，整体耗时会明显降低。原始 URL 的有效期由供应商控制，通常短于转存 URL。若需要更稳定、有效期更长的地址，请使用默认转存模式。唯一支持的非空值为 origin，其他值返回 HTTP 400。该请求头仅在创建任务时读取，查询时无需重复传入。

请求体

请求体属性

promptstring, 必填
文本提示词，必填，去除首尾空格后长度不超过 7000 字符。
durationinteger
生成视频时长（秒）。取值范围 4–15；默认 5。
default: 5; minimum: 4; maximum: 15
resolutionenum
输出分辨率。支持 2K、768P；默认 2K。计费档位由请求分辨率决定。
default: 2K
- 2K
- 768P
aspect_ratioenum
画幅比例。文生视频支持 21:9、16:9、4:3、1:1、3:4、9:16；默认 16:9（不含 adaptive）。
default: 16:9
- 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）

响应体属性

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
MiniMax H3/H3 Max 任务结果，含生成视频与用量。
- videoobject
  - urlstring, 必填
    视频下载链接（Kodo 签名 URL，自签发之日起 7 天内有效，请及时下载并转存）。
  - content_typestring, 必填
    必填。
  - durationnumber<double>
    视频时长（秒）。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    文件大小（字节）。
- usageobject
  MiniMax H3/H3 Max 异步视频用量（扁平字段位于结果 usage 下）。仅 MiniMax 任务返回；其他视频模型通常省略 usage。H3 按输出秒数、输入视频秒数与超额参考图分项计费；H3 Max 仅按输出视频秒数计费。档位由创建时请求的 resolution 决定。不同视频用量结构的对账方法见 Usage 字段与计费对账。
  - 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 视频。image_url 与 end_image_url 至少提供一个；仅提供 end_image_url 时按尾帧模式生成，同时提供两者时按首尾帧模式生成。

认证方式

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。

请求头

Name
X-Qiniu-Video-API-Format
Type
enum
Description
可选。默认会将生成视频转存到平台存储后再返回 URL，以保证结果在较长时间内可访问；转存会增加下载、上传和存储处理时间。设为 origin 时，直接返回供应商原始视频 URL，跳过转存，整体耗时会明显降低。原始 URL 的有效期由供应商控制，通常短于转存 URL。若需要更稳定、有效期更长的地址，请使用默认转存模式。唯一支持的非空值为 origin，其他值返回 HTTP 400。该请求头仅在创建任务时读取，查询时无需重复传入。

请求体

请求体属性

promptstring, 必填
文本提示词，必填，去除首尾空格后长度不超过 7000 字符。
image_urlstring
可选首帧图像公网 HTTP(S) URL。与 end_image_url 至少提供一个；同时提供两者时按首尾帧模式生成。
end_image_urlstring
可选尾帧图像公网 HTTP(S) URL。仅提供该字段时按尾帧模式生成，同时提供 image_url 时用于首尾帧过渡生成。
durationinteger
生成视频时长（秒）。取值范围 4–15；默认 5。
default: 5; minimum: 4; maximum: 15
resolutionenum
输出分辨率。支持 2K、768P；默认 2K。
default: 2K
- 2K
- 768P
callback_urlstring<uri>
可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址；也可通过查询参数 fal_webhook 指定。详见 FAL 格式 Webhook。
anyOf[0]
提供 image_url 作为首帧图片；也可以同时提供 end_image_url 生成首尾帧视频。
anyOf[1]
提供 end_image_url 作为尾帧图片；仅提供该字段时生成尾帧模式视频。

请求

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）

响应体属性

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
MiniMax H3/H3 Max 任务结果，含生成视频与用量。
- videoobject
  - urlstring, 必填
    视频下载链接（Kodo 签名 URL，自签发之日起 7 天内有效，请及时下载并转存）。
  - content_typestring, 必填
    必填。
  - durationnumber<double>
    视频时长（秒）。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    文件大小（字节）。
- usageobject
  MiniMax H3/H3 Max 异步视频用量（扁平字段位于结果 usage 下）。仅 MiniMax 任务返回；其他视频模型通常省略 usage。H3 按输出秒数、输入视频秒数与超额参考图分项计费；H3 Max 仅按输出视频秒数计费。档位由创建时请求的 resolution 决定。不同视频用量结构的对账方法见 Usage 字段与计费对账。
  - 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 视频。参考图片、视频、音频分别最多 9、3、3 个，不设合计数量上限；至少提供图片或视频，不能只提供音频。

认证方式

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。

请求头

Name
X-Qiniu-Video-API-Format
Type
enum
Description
可选。默认会将生成视频转存到平台存储后再返回 URL，以保证结果在较长时间内可访问；转存会增加下载、上传和存储处理时间。设为 origin 时，直接返回供应商原始视频 URL，跳过转存，整体耗时会明显降低。原始 URL 的有效期由供应商控制，通常短于转存 URL。若需要更稳定、有效期更长的地址，请使用默认转存模式。唯一支持的非空值为 origin，其他值返回 HTTP 400。该请求头仅在创建任务时读取，查询时无需重复传入。

请求体

请求体属性

promptstring, 必填
文本提示词，必填，去除首尾空格后长度不超过 7000 字符。按模态与列表顺序引用参考素材，例如 Image 1、Image 2、Video 1、Audio 1。
durationinteger
生成视频时长（秒）。取值范围 4–15；默认 5。
default: 5; minimum: 4; maximum: 15
resolutionenum
输出分辨率。支持 2K、768P；默认 2K。
default: 2K
- 2K
- 768P
aspect_ratioenum
画幅比例。支持 adaptive、21:9、16:9、4:3、1:1、3:4、9:16；默认 adaptive。
default: adaptive
- adaptive
- 21:9
- 16:9
- 4:3
- 1:1
- 3:4
- 9:16
reference_image_urlsstring[]
主体/风格参考图 URL 列表，在 prompt 中按 Image 1、Image 2… 引用。最多 9 张。
reference_video_urlsstring[]
动作/参考视频 URL 列表，在 prompt 中按 Video 1… 引用。最多 3 段；单段 2–15 秒，合计不超过 15 秒。
reference_audio_urlsstring[]
参考音频 URL 列表，在 prompt 中按 Audio 1… 引用。最多 3 段；单段 2–15 秒，合计不超过 15 秒。不能只传音频，须同时提供至少一张参考图或一段参考视频。
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）

响应体属性

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
MiniMax H3/H3 Max 任务结果，含生成视频与用量。
- videoobject
  - urlstring, 必填
    视频下载链接（Kodo 签名 URL，自签发之日起 7 天内有效，请及时下载并转存）。
  - content_typestring, 必填
    必填。
  - durationnumber<double>
    视频时长（秒）。
  - file_namestring
    可选。
  - file_sizeinteger<int64>
    文件大小（字节）。
- usageobject
  MiniMax H3/H3 Max 异步视频用量（扁平字段位于结果 usage 下）。仅 MiniMax 任务返回；其他视频模型通常省略 usage。H3 按输出秒数、输入视频秒数与超额参考图分项计费；H3 Max 仅按输出视频秒数计费。档位由创建时请求的 resolution 决定。不同视频用量结构的对账方法见 Usage 字段与计费对账。
  - 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
  }
}