OpenAPI 参考

Modelink API · 视频

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

版本 1.0.0

创建 MiniMax H3 Max 文生视频任务

POST

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

提交文本提示词生成 MiniMax H3 Max 视频。默认生成 5 秒、768P 视频；支持 5–15 秒和 480P/768P 两档分辨率。

认证方式

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 地址。

请求头

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

请求体

请求体属性

promptstring, 必填
文本提示词，去除首尾空格后不能为空。
durationinteger
生成视频时长（秒），支持 5–15 秒。
default: 5; minimum: 5; maximum: 15
resolutionenum
输出分辨率，支持 480P 和 768P。
default: 768P
- 480P
- 768P
aspect_ratioenum
文生视频画幅比例，默认 16:9。
default: 16:9
- 21:9
- 16:9
- 4:3
- 1:1
- 3:4
- 9:16
callback_urlstring<uri>
可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。

请求

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

curl 'https://api.qnaigc.com/queue/minimax/h3-max/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 cinematic shot of waves breaking against a rocky coast at sunrise.",
  "duration": 5,
  "resolution": "768P",
  "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
  }
}

创建 MiniMax H3 Max 图生视频任务