GPT-5.4 和 GPT-5.4 Mini 已下线 · 请切换至其他可用模型
全部模型
MiniMax · 媒体 API

MiniMax H3 API

MiniMax H3 是 MiniMax 在 OmniaKey 上的视频线路:一个模型名同时覆盖文生视频、首尾帧生视频和参考生视频,输出 768P 或 2K。

模型 ID
minimax-h3
提供商
MiniMax
类型
AI 视频
每输出一秒
$0.15–$0.30
最近核验
2026-09-16

01

适用场景

需要固定的起止画面,或由参考图、参考视频驱动运镜时选 MiniMax H3:768P 每秒 $0.15,2K 每秒 $0.30。只传参考音频会被拒绝,必须同时带上图片或视频参考。

02

能力范围

文生视频

minimax-h3

根据文字提示词生成一段短视频。

图生视频

minimax-h3

把静态图片动起来,生成一段短视频。

参考视频

minimax-h3

用参考视频片段约束生成结果。

03

接入方式

媒体模型采用异步任务:创建任务、轮询到完成,再下载签名后的资源地址。

创建、轮询、下载
# 1. Create the job. 202 Accepted; the body carries the task id,
#    the pre-charged price, and a poll_url. Reuse one Idempotency-Key
#    across retries so a timeout never starts a second paid job.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: minimax-h3-001" \
  -d '{
    "model": "minimax-h3",
    "type": "video",
    "operation": "text_to_video",
    "input": {"prompt": "a paper boat on a quiet lake at sunset"},
    "parameters": {"duration": 6, "resolution": "720p"}
  }'

# 2. The same model id and the same poll loop serve the other operations:
#      image_to_video         media[] type "first_frame"
#      reference_to_video     media[] type "reference_image"
#    Reference media travel alongside the prompt:
#    {"prompt": "...", "media": [{"type": "first_frame", "url": "https://example.com/first-frame.png"}]}
#    A public HTTPS URL or a base64 data URI both work.

# 3. Poll GET /v1/media/tasks/{id} until status is
#    succeeded | failed | canceled. Progress carries percent and stage.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks/TASK_ID \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"

# 4. Download assets[0].url before expires_at, or poll again for a
#    fresh signed URL. Failed and canceled jobs are refunded.
curl -sS -o out.mp4 "$(jq -r '.assets[0].url' result.json)"

04

价格

视频任务按实际输出的秒数计费,不按 Token 计费;失败或取消的任务会自动退款。

每输出一秒

$0.15–$0.30每秒

768P
$0.15每秒
2K
$0.30每秒

常见问题

如何在 OmniaKey 上调用 MiniMax H3?

向 /v1/media/tasks 发送 POST,带上模型 ID、type 设为 "video"、operation 设为 "text_to_video";若用首帧图生视频,改为 "image_to_video",并把首帧放入 input.media[](type 设为 "first_frame")。重试时复用同一个 Idempotency-Key,超时就不会再生成第二笔付费任务。

MiniMax H3 如何收费?

MiniMax H3 按生成视频的时长计费:$0.15–$0.30 每秒。创建时会按请求时长从预付余额中预扣,失败或取消的任务会自动退款。

为什么接口返回任务 ID 而不是视频?

视频渲染大约需要一分钟到几分钟,OmniaKey 因此把所有视频路由统一为同一套异步流程。轮询 GET /v1/media/tasks/{id},直到状态变为 succeeded,再读取签名后的资源地址。

MiniMax H3 API — 异步视频生成 · OmniaKey