動画生成 API と MiniMax H3 を追加しました
動画生成 API（/v1/videos）と、その第一弾モデル minimax-h3（MiniMax H3）を追加しました。MiniMax が 2026-07-31 に公開した general-purpose multimodal generation モデルで、テキスト・画像・音声・動画を入力として受け、ネイティブステレオ音声付きの 2K 動画を最大 15 秒で出力します。単価は ¥35/秒（税込表示）、参照画像は ¥10/枚です。最短 5 秒で ¥175、最長 15 秒で ¥525 です。
系譜は Hailuo 01 → Hailuo 02 → H3 です。広告・ブランディング・EC・プロダクトデザイン・UI/UX・ゲーム向けを想定しています。
特徴
音声付き 2K 動画
H3 は生成時に音声を同時に載せます（既定 ON）。解像度は 2K 固定です。対応尺は 5〜15 秒の整数秒、アスペクト比は 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 です。
非同期ジョブ
動画生成は分単位の処理になるため、POST /v1/videos は 202 でジョブ ID を返し、GET /v1/videos/{id} で完了を確認したあと GET /v1/videos/{id}/content で mp4 を取得します。OpenAI の Video API 互換の形に寄せているので、client.videos.create / retrieve / download_content がそのまま動きます。
投入時のクレジット予約
見積り額を投入時に予約し、残高不足のときは 402 で止めます（生成ジョブは投入されません）。完了時に実額で精算し、失敗・期限切れでは全額解放します。
使い方
model に minimax-h3 を指定します。テキスト生成の GET /v1/models には載りません。対応モデルは GET /v1/videos/models で確認してください。
curl https://hai-api.hcloud.ltd/v1/videos \
-H "Authorization: Bearer hai_..." \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3",
"prompt": "A product spin on a clean white table, soft studio light",
"seconds": 5,
"aspect_ratio": "16:9"
}'
# 完了確認
curl https://hai-api.hcloud.ltd/v1/videos/<id> \
-H "Authorization: Bearer hai_..."
# mp4 取得
curl -L https://hai-api.hcloud.ltd/v1/videos/<id>/content \
-H "Authorization: Bearer hai_..." \
-o out.mp4
注意点
- seed は非対応です。 指定すると 400 になります。
- 解像度は 2K 固定です。
sizeや他のresolutionは受け付けません。 - 生成に失敗した・期限切れになったジョブは課金しません。投入時の予約は解放されます。
- 動画行の利用履歴では入力 / 出力トークンは 0 です（秒課金のため）。