MiniMax-H3 API

正確なモデル ID MiniMax-H3 を使用します。モデル フィールドはこのページと正確に一致する必要があります。

サンプル出力MiniMax-H3POST /v1/videos5.2s

パラメータ: duration=5resolution=2Kratio=16:9

プロンプト： A fleet of hot-air balloons drifts over mist-filled mountain valleys at dawn. Aerial camera glides slowly between the balloons as golden light breaks over the ridges and fog rolls through the pines below. Calm, majestic, photoreal landscape, steady motion, no text.

このサンプルを作成したリクエスト

{
  "model": "MiniMax-H3",
  "prompt": "A fleet of hot-air balloons drifts over mist-filled mountain valleys at dawn. Aerial camera glides slowly between the balloons as golden light breaks over the ridges and fog rolls through the pines below. Calm, majestic, photoreal landscape, steady motion, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "2K",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

認証とエンドポイント

https://modelflare.dev/v1 で Modelflare API キーを使用します。ゲートウェイのエントリ ポイントは POST /v1/videos です。

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

タスクの作成

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [{"type": "text", "text": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot"}],
    "resolution": "2K", "duration": 5, "ratio": "16:9"
  }'

ポーリングとダウンロード

タスクIDを保存します。 GET /v1/videos/{task_id} をポーリングし、GET /v1/videos/{task_id}/content でダウンロードします。結果 URL は有効期限が切れている可能性があるため、速やかにファイルを転送してください。

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

リクエストメモ

MiniMax-H3 は content[] を使用し、resolution、duration、ratio で出力を制御します。

リクエストパラメータ

MiniMax-H3 はマルチモーダル content[] アレイを使用します。タスク作成後に MiniMax クエリ パスをポーリングします。 first_frame / last_frame および reference_* の役割は別個のワークフローです。

フィールド	必須	注意事項
model	はい	MiniMax-H3
content[]	はい	text 項目は 1 つだけ。 first_frame、last_frame、reference_image、reference_video、または reference_audio が含まれる場合があります
resolution	はい	768P / 2K
duration	はい	4～15秒
ratio	条件付き	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
content[].role	条件付き	画像からビデオへの変換には first_frame / last_frame を使用し、参照ワークフローには reference_* を使用します。グループを混ぜないでください
content[].url	いいえ	パブリック HTTP/HTTPS URL が必要です。 Base64メディアはサポートされていません
aigc_watermark	いいえ	ウォーターマークを入れるかどうか
callback_url	いいえ	タスクステータスコールバックURL

入出力制限

768P または 2K で 4 ～ 15 秒出力します。テキストのみのリクエストには具体的な ratio が必要です。 image-to-video では、最初のフレームと最後のフレームが 1 つずつ許可されますが、リファレンス ワークフローでは少なくとも 1 つのリファレンス画像またはビデオが必要で、オーディオのみを使用することはできません。 2 つの役割グループを混合しないでください。

文書化されたワークフローの例

MiniMax-H3 メディア URL はパブリックにアクセスできる必要があり、Base64 は使用できません。最初/終了フレームと参照ワークフローを混合してはなりません。

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [
      {"type": "text", "text": "让图像主体沿视频动作自然移动"},
      {"type": "reference_image", "role": "reference_image", "url": "https://example.com/subject.png"},
      {"type": "reference_video", "role": "reference_video", "url": "https://example.com/motion.mp4"}
    ],
    "resolution": "2K", "duration": 5, "ratio": "16:9"
  }'

エラーと失敗したタスク

無効なモデル パラメーターは、リクエスト ID を含む 4xx を返します。非同期タスクは、作成が成功した後に失敗することもあります。ポーリング応答からの error_code と error_message を最終タスク理由として使用します。異なる JSON 形式で同じリクエストを再試行しないでください。

サポート範囲

このページでは、Modelflare モデルの生成と編集呼び出しについて説明します。検索またはマップのエンリッチメント、音声管理、および要素ライブラリ管理は、このパブリック モデル呼び出しサーフェスの外部にあるリソース API であり、必須のリクエスト フィールドではありません。

価格設定と請求

動画秒単位課金モデルです。現在の顧客価格、参考定価、完全な仕様については、モデル価格ページを参照してください。

ノート

このページでは、Modelflare のパブリック インターフェイスについて説明します。ここに示されているフィールドと制限は現在の契約です。

バリアント

モデルID	違い
MiniMax-H3	このページに記載されているモデル。