0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

MiniMax H3を3つの入力方式で使い分ける:非同期動画APIの設計ポイント

0
Last updated at Posted at 2026-08-03

MiniMax H3 が RouterBase で利用できるようになりました。現在公開されているのは、text-to-video、image-to-video、reference-to-video の3種類です。各ルートは 2K 出力と 6秒/10秒の動画に対応しています。

重要なのは、これらを別々のシステムとして実装しないことです。アプリケーション側では、入力形式だけを切り替え、非同期ジョブのライフサイクルは共通化できます。

基本フロー

  1. 生成ジョブを送信する
  2. 返された task ID を保存する
  3. 完了・失敗・キャンセルまで状態をポーリングする
  4. 完了した動画URLを取得する
  5. 必要であれば自社管理のストレージへ保存する

3つの入力方式

text-to-video は、既存のビジュアルに縛られず、シーンをゼロから作りたい場合に向いています。

image-to-video は、入力画像を最初のフレームとして扱い、構図や被写体を保ちながら動きを加えたい場合に適しています。

reference-to-video は、参照画像をそのまま最初のフレームにするのではなく、人物・商品・スタイルなどのガイドとして使いたい場合に有効です。

実装上の注意

実装では、ジョブID、利用ルート、プロンプトのバージョン、入力アセット、送信時刻、リトライ回数を記録しておくと、比較と障害調査が容易になります。また、「リクエストが受理されたこと」と「動画が完成したこと」は別の状態として扱うべきです。

MiniMax公式のH3ドキュメントは、4〜15秒、画像・動画・音声を含む、より広いマルチモーダル機能を説明しています。一方、RouterBaseで現在公開されているルートは、明確に定義されたサブセットです。本番実装では、実際に呼び出すRouterBaseルートの仕様を優先してください。

RouterBase routes

モデルは速く変わります。ジョブ管理までモデルごとに作り直す必要はありません。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?