MiniMax 视频接口概览

使用 aiiqq.com 调用 H3、Context-IR、Max、Max Turbo 与视频再生成，选择正确的创建和查询格式。

MiniMax 视频任务均为异步处理：提交请求、保存公共任务 ID、查询终态，再读取视频地址或增强提示词。本系列按 aiiqq.com 已接入的接口说明调用方法，并参考 MiniMax 官方视频 V2 文档。

支持的模型与操作

aiiqq.com 模型名称	用途	创建路径	请求正文的 `model`
`minimax-h3`	生成 768P / 2K 视频	`/v2/video_generation`	`MiniMax-H3`
`minimax-h3-context-ir`	理解素材并增强提示词，输出文字	`/v2/h3_context_ir`	`MiniMax-H3`
`minimax-h3-regeneration`	将符合要求的 H3 768P 视频再生成为 2K	`/v2/video_regeneration`	`MiniMax-H3`
`minimax-h3-max`	生成 480P / 768P 视频	`/v1/video/generate`	`minimax-h3-max`
`minimax-h3-max-turbo`	平台格式视频生成	`/v1/video/generate`	`minimax-h3-max-turbo`

前三个名称用于模型权限和计费，原生请求正文均填写 MiniMax-H3，由创建路径区分操作。Max 与 Max Turbo 使用小写模型名和独立的平台格式。Turbo 的专属媒体和扩展参数能力以当前模型支持为准，不直接套用 Max 的全部能力。

地址与鉴权

export MODELSELL_BASE_URL="https://api.modelsell.com"
export MODELSELL_API_KEY="<your-modelsell-api-key>"

所有请求发送到 aiiqq.com，携带 Authorization: Bearer $MODELSELL_API_KEY；创建请求使用 Content-Type: application/json。请求超时建议至少 300 秒。使用自己的接入域名时，只替换 MODELSELL_BASE_URL。

选择接口格式

格式	创建	查询	成功结果
H3 原生格式	上表三个 `/v2` 路径	`GET /v2/query/video_generation/{task_id}`	`task.content.url` 或 `task.content.prompt`
Max / Turbo 平台格式	`POST /v1/video/generate`	`GET /v1/video/tasks/{task_id}`	`task.outputs`
统一视频格式	`POST /v1/videos`	`GET /v1/videos/{task_id}`	`video_url` / `metadata.url`

统一视频格式支持 H3、Max 和 Max Turbo 的生成任务，详见统一视频格式。Context-IR 与再生成使用各自的原生创建接口。

两套原生查询路径不能互换。创建返回的 task_… 是 ModelSell 公共 ID；不要替换为官方示例中的数字 ID、上游 ID 或回调中的 ID。原生查询、删除和源任务引用校验所属用户及创建令牌，并沿用原任务的渠道和供应商密钥。调用示例均使用创建任务时的 aiiqq.com API Key。

H3 原生视频生成

curl --max-time 300 "$MODELSELL_BASE_URL/v2/video_generation" \
  -H "Authorization: Bearer $MODELSELL_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "MiniMax-H3",
    "content": [{"type": "text", "text": "一只红色茶壶放在木桌上，晨光照进房间，镜头缓慢推进"}],
    "resolution": "768P",
    "duration": 4,
    "ratio": "16:9",
    "aigc_watermark": false
  }'

创建响应示例：

{"task_id": "task_example_h3_generation"}

使用返回的真实公共 ID 每 10–15 秒查询一次：

export TASK_ID="<returned-task-id>"
curl --max-time 300 "$MODELSELL_BASE_URL/v2/query/video_generation/$TASK_ID" \
  -H "Authorization: Bearer $MODELSELL_API_KEY"

提示词增强与再生成

向 POST /v2/h3_context_ir 发送 model: "MiniMax-H3"、content、duration 和适用的 ratio。成功后读取 task.content.prompt；它是增强提示词，不是视频文件。可将这段文字作为后续 H3 视频生成的文本输入。

再生成可引用同一令牌创建、最近 7 天内成功的 H3 视频生成任务：

{
  "model": "MiniMax-H3",
  "source_task_id": "task_example_successful_h3",
  "resolution": "2K"
}

该 JSON 发送到 POST /v2/video_regeneration。source_task_id 使用 aiiqq.com 返回的公共 ID；源任务须属于同一原生协议及原渠道密钥，不能引用 Max / Turbo 平台任务。通过统一格式生成、实际使用 H3 原生协议的成功 H3 任务也可作为来源。也可提供符合规格的 base_video，见请求参数与媒体输入。

状态与结果

格式	等待 / 处理中	成功	失败终态
H3 原生 `task.status`	`queued` / `running`	`succeeded`	`failed` / `cancelled`
平台 `task.status`	`pending` / `processing`	`completed`	`failed`
统一视频 `status`	`queued` / `in_progress`	`completed`	`failed`

成功的原生视频从 task.content.url 下载；Context-IR 从 task.content.prompt 读取文字。平台视频地址在 task.outputs，计量在 task.metadata.usage，不要假定 task.usage 一定有秒数。视频链接可能失效，请及时下载或转存。Python 示例提供有界轮询、失败处理和下载方法。

取消、删除与错误

H3 原生任务使用 DELETE /v2/video_generation/{task_id}：排队任务可取消；运行中任务会被拒绝；成功或失败任务可删除。取消后仍可查询取消状态，删除后公共 ID 失效。已完成的视频费用不会因删除结果而退还。

删除前会查询并结算已完成任务。409 若提示仍在结算，可先查询、稍后重试；若提示删除后无法读取最终用量，则进入 RECONCILING，保留预扣等待对账，此时不要反复删除或视作已退款。平台 Max / Turbo 本系列不提供取消、删除或任务列表接口。

已注册的 H3 原生端点返回 MiniMax 风格错误：

{
  "type": "error",
  "error": {"type": "bad_request_error", "message": "invalid params", "http_code": "400"},
  "request_id": "request_example"
}

根据 HTTP 状态及 error.message 排查，并保存 request_id。未知路由可能返回网关通用错误；平台格式保留平台错误结构。创建请求网络超时后，先保留诊断信息并确认是否已创建任务，避免盲目重复提交产生多份费用。

计费与支持范围

创建任务时预扣，成功后按实际用量结算，失败或取消按任务流程退款；查询不重复收费。

操作	最终计量
H3 / 再生成	`task.usage.total_seconds`；包含适用的输入视频秒数，参考图前 5 张免费
Context-IR	`task.usage.prompt_tokens` 与 `completion_tokens` 分别计费
Max	`task.metadata.usage.output_seconds`、`input_seconds` 分开计费，参考图前 2 张免费
Max Turbo	按当前模型目录的视频秒数规则计费

具体单价及分组价格见 ModelSell MiniMax H3 模型定价。

官方文档可能展示更多模型和服务。本系列当前不开放 Highspeed、Lite、/v2 格式 Max、原生任务列表及 MiniMax 文件 API；媒体使用公网 HTTP(S) URL，不使用 mm_file://。callback_url 由上游执行回调，可能携带上游任务 ID，客户端仍应保存并使用创建响应中的 aiiqq.com 公共 ID。