MiniMax H3 API

768p 文生视频。

价格
分辨率	文本、图片或视频
768p	文本、图片或视频18 积分/秒 ($0.09/秒)

含视频输入时，输入和输出的秒数都计费。

完整价格 ↓

生成结果会显示在这里

价格

价格自 2026-11-09 起生效

档位	价格
768p	18 积分/秒 ($0.09/秒)4–15 秒
768p（含视频输入） 768p-video	18 积分/秒 ($0.09/秒)^{注 11}4–15 秒

费率同时适用于输入和输出的秒数。

1 积分 ≈ $0.005。按标准充值包计算；较大的充值包含赠送积分，实际单价更低。

交付与计费

成品: 成品文件列在任务结果中，每个文件有素材 ID 和类型。
下载: 文件保存 7 天，通过短期签名链接下载，可随时删除。
计费: 任务受理时冻结积分，交付后扣费。生成失败，或 24 小时内未交付，冻结的积分会全部释放。
通知: 按任务 ID 轮询，或使用签名 Webhook，并按 event_id 去重。

如何计费？

按输出秒数计费。

API 参考

任务只创建一次，之后按 ID 查询。完整脚本（含上传和下载） · API 文档

请求示例

API=https://api.vizoapi.com/v1
AUTH="Authorization: Bearer $VIZO_API_KEY"

# Create the task once and keep its ID.
ID=$(curl -fsS $API/generations -H "$AUTH" -H "Content-Type: application/json" \
  -d '{
  "model": "minimax-h3",
  "input": {
    "content": [
      {
        "type": "text",
        "text": "雨夜霓虹街道的缓慢推镜"
      }
    ],
    "resolution": "768P",
    "ratio": "16:9",
    "duration": 6
  },
  "metadata": {
    "client_reference": "my-unique-reference-1"
  }
}' | jq -r .id)

# Poll until the task closes, then read its status and result.
until curl -fsS $API/generations/$ID -H "$AUTH" | jq -e '.closed_at != null' > /dev/null; do sleep 5; done
curl -fsS $API/generations/$ID -H "$AUTH" | jq '{status, result}'

全部字段

在 input 中发送这些字段。表中没有的字段会被拒绝，返回 HTTP 422 invalid_input。

content holds exactly one text item.
Every image, video and audio item in content names its role.
Frames (first_frame, last_frame, at most one each) cannot be combined with reference images, videos or audio.
Input without images, videos or audio needs a ratio other than adaptive; input with frames always uses adaptive.
resolution is case-sensitive: send 768P.

请求参数
字段	说明
`content`array of objects必填	Exactly one text item. Frames (first_frame, last_frame, at most 1 each) cannot be combined with references. Up to 5 images, 3 videos (2 to 15 seconds each, 15 in total) and 3 audios (15 seconds in total). 至少 1 项 · 最多 16 项
`content[].type`string必填	Item kind. 可选值`textimage_urlvideo_urlaudio_url`
`type` 为 `text` 的项
`content[].text`string必填	Prompt text, up to 7000 characters. 最多 7000 个字符
`type` 为 `image_url` 的项
`content[].role`string可选	Image roles: first_frame, last_frame, reference_image. Video: reference_video. Audio: reference_audio.
`content[].image_url`object必填
`content[].image_url.url`string必填	An https URL or an uploaded asset id (ast_...). 最多 4000 个字符 · 格式`^(https://\|ast_)`
`type` 为 `video_url` 的项
`content[].role`string可选	Image roles: first_frame, last_frame, reference_image. Video: reference_video. Audio: reference_audio.
`content[].video_url`object必填
`content[].video_url.url`string必填	An https URL or an uploaded asset id (ast_...). 最多 4000 个字符 · 格式`^(https://\|ast_)`
`type` 为 `audio_url` 的项
`content[].role`string可选	Image roles: first_frame, last_frame, reference_image. Video: reference_video. Audio: reference_audio.
`content[].audio_url`object必填
`content[].audio_url.url`string必填	An https URL or an uploaded asset id (ast_...). 最多 4000 个字符 · 格式`^(https://\|ast_)`
`resolution`string必填	Output resolution. Only 768P. 固定值 `768P`
`duration`integer必填	Output length in seconds, 4 to 15. 最小 4 · 最大 15
`ratio`string可选	Output aspect ratio. Text-only input needs a value other than adaptive; input with frames always uses adaptive. 可选值`adaptive21:916:94:31:13:49:16` 默认值 `adaptive`
`aigc_watermark`boolean可选	Add a visible watermark. Defaults to false; the tier price is unchanged. 默认值 `false`

完整请求与响应示例

完整的创建请求、202 响应，以及任务成功后的状态。此输入选择 768p 档位，每秒 18 积分。6 秒共冻结 108.000 积分。

请求

{
  "model": "minimax-h3",
  "input": {
    "content": [
      {
        "type": "text",
        "text": "A paper boat drifting on a pond at dawn, slow dolly in"
      }
    ],
    "resolution": "768P",
    "ratio": "16:9",
    "duration": 6
  },
  "metadata": {
    "client_reference": "my-unique-reference-1"
  }
}

202 已受理

{
  "id": "gen_01JD8Z5QW3XR",
  "model": "minimax-h3",
  "source": "api",
  "created_at": "2026-11-08T09:00:00Z",
  "customer_resolution_deadline": "2026-11-09T09:00:00Z",
  "late_result_available": false,
  "metadata": {
    "client_reference": "my-unique-reference-1"
  },
  "status": "processing",
  "execution_status": "processing",
  "delivery_status": "pending",
  "billing_status": "pending",
  "version": 1,
  "price": {
    "unit": "credit",
    "estimated": "108.000",
    "reserved": "0.000",
    "charged": "0.000",
    "refunded": "0.000"
  },
  "allowed_actions": [],
  "closed_at": null,
  "error": null,
  "result": null
}

200 已成功

{
  "id": "gen_01JD8Z5QW3XR",
  "model": "minimax-h3",
  "source": "api",
  "created_at": "2026-11-08T09:00:00Z",
  "customer_resolution_deadline": "2026-11-09T09:00:00Z",
  "late_result_available": false,
  "metadata": {
    "client_reference": "my-unique-reference-1"
  },
  "status": "succeeded",
  "execution_status": "succeeded",
  "delivery_status": "ready",
  "billing_status": "settled",
  "version": 4,
  "price": {
    "unit": "credit",
    "estimated": "108.000",
    "reserved": "0.000",
    "charged": "108.000",
    "refunded": "0.000"
  },
  "allowed_actions": [],
  "closed_at": "2026-11-08T09:01:31Z",
  "error": null,
  "result": {
    "asset_id": "ast_01JD8Z9M2C4V",
    "outputs": [
      {
        "index": 0,
        "asset_id": "ast_01JD8Z9M2C4V",
        "content_type": "video/mp4"
      }
    ]
  }
}

MiniMax H3 完整 API 参考

价格

交付与计费

API 参考

同类模型