> ## Documentation Index > Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt > Use this file to discover all available pages before exploring further. # MiniMax H3 動画生成 API 連携ガイド > Minimax API guide - Ace Data Cloud 本文では、MiniMax H3 動画生成 API の連携と使用方法を紹介します。このインターフェースは、テキストから動画、開始・終了フレーム制御、およびマルチモーダル参照による動画生成をサポートし、統一された V2 マルチモーダル `content` 構造を使用してタスクを作成します。 ## 申請フロー MiniMax H3 動画生成 API を使用するには、まず [Ace Data Cloud コンソール](https://platform.acedata.cloud/console/applications) で API Token を取得し、控えておいてください。 ![](https://cdn.acedata.cloud/dvc3cg.jpg) まだログインまたは登録していない場合は、自動的にログインページへ移動して登録とログインを促されます。完了後は自動的に現在のページへ戻ります。 **1 つの API Token でプラットフォームのすべてのサービスを呼び出せるため、サービスごとに個別で申請する必要はありません。** 初回申請時には無料クレジットが付与され、無料で体験できます。クレジットが不足した場合は、[コンソール](https://platform.acedata.cloud/console/coin) で共通残高をチャージできます。 > 📘 完全なドキュメント：[MiniMax H3 動画生成 API →](https://platform.acedata.cloud/documents/minimax-videos-integration) Token は環境変数として保存し、ソースコードに書き込んだりバージョン管理リポジトリにコミットしたりしないことを推奨します。 ```bash theme={null} export ACEDATACLOUD_API_KEY="YOUR_API_KEY" ``` ## インターフェース概要 * **Base URL**：`https://api.acedata.cloud` * **Endpoint**：`POST /minimax/videos` * **認証方式**：HTTP Header に `authorization: Bearer {token}` を含める * **リクエストヘッダー**： * `accept: application/json` * `content-type: application/json` * **モデル（model）**：`MiniMax-H3` * **入力構造**：`content` を通じてテキスト、画像、動画、音声を統一的に渡す * **出力モード**：デフォルトでは同期的に生成完了を待機し、完全な `task` を返す。`async: true` または `callback_url` を渡す場合は、直ちに `task_id` と `trace_id` を返す * **結果照会**：[MiniMax H3 タスク照会 API](https://platform.acedata.cloud/documents/minimax-tasks-integration) を通じてステータスと完成動画を取得 * **非同期コールバック**：任意。`callback_url` を通じて最終タスク結果を受け取る 生成モードを選択するために `action` を渡す必要はありません。インターフェースが `content` 内の素材タイプと `role` に基づいて用途を自動的に判断します。 ## どのようなシーンに適しているか | シーン | 入力の組み合わせ | 一般的な用途 | | - | - | - | | テキストから動画 | テキスト | 広告クリエイティブ、絵コンテのプレビュー、ショート動画、雰囲気ショット | | 開始フレーム画像から動画 | テキスト + 開始フレーム画像 | 商品画像、ポスター、人物写真、またはイラストを自然に動かす | | 終了フレーム / 開始・終了フレーム動画 | テキスト + 終了フレーム、またはテキスト + 開始フレーム + 終了フレーム | オープニングとエンディング、トランジション、成長変化、ビフォーアフターの制御 | | マルチモーダル参照から動画 | テキスト + 参照画像 / 動画 / 音声 | キャラクターと製品の一貫性を維持し、動作、カメラワーク、声質、または編集リズムを再現 | ## 呼び出しフロー デフォルトで `async` を渡さない場合、`/minimax/videos` は生成完了を待機し、完全な `task` を直接返します。すぐに接続を解放する必要がある場合は、`async: true` または `callback_url` を渡します。 1. 即時レスポンス内の `task_id` と `trace_id` を保存します。 2. コールバックを設定していない場合は、約 10 秒ごとに `/minimax/tasks` を呼び出して照会します。 3. `task.status` が `succeeded` になったら、`task.content.url` から動画を取得します。 4. ステータスが `failed` または `cancelled` の場合はポーリングを停止し、`task.error` を読み取ります。 ## トップレベルのリクエストパラメーター | パラメーター | 型 | 必須 | デフォルト値 | 説明 | | - | - | - | - | - | | `model` | string | はい | - | `MiniMax-H3` に固定 | | `content` | object\[] | はい | - | マルチモーダルコンテンツ配列。空でない `text` 項目を 1 つ含める必要があります | | `resolution` | string | はい | - | `768P` または `2K` | | `duration` | integer | はい | - | 生成時間。4～15 秒の整数 | | `ratio` | string | 条件付き必須 | `adaptive` | `adaptive`、`21:9`、`16:9`、`4:3`、`1:1`、`3:4`、`9:16` | | `async` | boolean | いいえ | `false` | `true` の場合、直ちにタスク識別子を返し、タスクインターフェースを通じて結果を取得 | | `callback_url` | string | いいえ | - | 最終タスク結果を受信する公開コールバック URL。指定すると非同期モードが自動的に有効化されます | `ratio` のルールはワークフローによって異なります。 * **テキストから動画**：必須であり、`adaptive` は使用できません。 * **開始フレーム、終了フレーム、または開始・終了フレーム動画**：画面比率は入力画像によって決まり、省略するか `adaptive` を渡すことを推奨します。 * **マルチモーダル参照から動画**：省略可能で、デフォルトは `adaptive` です。固定比率を明示的に指定することもできます。 インターフェースは、`prompt`、`image_urls`、`audio_urls`、`messages`、`first_frame_image` などの旧バージョンまたは互換フィールドを受け付けません。このようなパラメーターエラーを受け取った場合は、旧フィールドを削除して `content` に移行してください。たとえば、`"prompt": "猫が手を振る"` を `"content": [{"type": "text", "text": "猫が手を振る"}]` に変更します。新旧両方の形式を同時に送信しないでください。 ## content コンテンツ項目のパラメーター 各コンテンツ項目には必ず `type` が必要で、その他のフィールドはタイプによって決まります。 | `type` | データフィールド | `role` | 説明 | | - | - | - | - | | `text` | `text` | 指定なし | 各リクエストには空でないテキスト項目を 1 つ含める必要があり、最大 7000 文字 | | `image_url` | `image_url.url` | `first_frame` | 開始フレーム画像。画像が 1 枚のみで `role` を省略した場合も、開始フレームとして処理されます | | `image_url` | `image_url.url` | `last_frame` | 終了フレーム画像。単独で使用することも、`first_frame` と組み合わせて開始点と終了点を制御することもできます | | `image_url` | `image_url.url` | `reference_image` | 参照対象、キャラクター、製品、衣装、シーン、またはスタイル | | `video_url` | `video_url.url` | `reference_video` | 動作、カメラワーク、演技、または編集構造を参照 | | `audio_url` | `audio_url.url` | `reference_audio` | 声質、セリフ、音楽、またはリズムを参照 | メディアアドレスは次の 3 つの形式をサポートしています。 * 公開アクセス可能な HTTPS URL。大きなファイルに推奨されます。 * `mm_file://{file_id}`。すでにアップロード済みまたは既存の結果ファイルを参照します。 * 対応するメディアタイプの Base64 data URI。Base64 ではサイズが約 3 分の 1 増加するため、リクエスト本文全体が 64 MB を超えないようにしてください。 ## 素材仕様と数量制限 | 素材 | 形式 | 単一ファイル制限 | サイズ / 長さ | 数量制限 | | - | - | - | - | - | | 画像 | JPG、JPEG、PNG、WEBP、HEIC、HEIF | 30 MB 以下 | 幅・高さともに 256-5760 px；アスペクト比 0.4-2.5 | 先頭フレームは最大 1 枚、末尾フレームは最大 1 枚、参照画像は最大 9 枚 | | 動画 | MP4、MOV；H.264/AVC または H.265/HEVC；音声トラック AAC または MP3 | 50 MB 以下 | 各クリップ 2-15 秒、合計 15 秒以下；幅・高さともに 256-5760 px；アスペクト比 0.4-2.5；23.976-60 fps | 参照動画は最大 3 クリップ | | 音声 | WAV、MP3 | 15 MB 以下 | 各クリップ 2-15 秒、合計 15 秒以下 | 参照音声は最大 3 クリップ | マルチモーダル参照シーンでは、画像、動画、音声の合計は最大 12 ファイルです。先頭・末尾フレームのシーンと参照素材のシーンは排他的です：`reference_image`、`reference_video`、または `reference_audio` を使用した場合、`first_frame` または `last_frame` は使用できません。その逆も同様です。 ## プロダクション級能力の展示 以下はコンセプト画像やプレースホルダー素材ではなく、MiniMax H3 公式のプロダクション級能力サンプルにおける実際の参照入力と実際の動画出力です。3 組の事例はそれぞれブランド短編、実写ナラティブ、ファッションECをカバーしており、商業制作においてモデルの最も重要な能力を評価するのに適しています。 | 能力 | 主な観察ポイント | | - | - | | 人物と顔の一貫性 | 複数ショットの切り替え後、顔立ち、髪型、メイク、人物の雰囲気が安定しているか | | 顔の演技 | クローズアップにおける視線、微表情、感情の緊張感、自然な頭部の動き | | 商品構造の維持 | メガネ、ハンドバッグなどの製品の輪郭、素材、着用関係、鏡面反射 | | ブランドビジュアルの実行 | シーンの雰囲気、フィルムグレイン、色彩、Logo、編集テンポが統一されているか | | 映画的なナラティブ | ショットサイズの変化、人物の動線、カメラワーク、テンポ、音声が完全なシークエンスを形成できるか | ここでの「顔の能力」とは、動画生成における人物の外見的一貫性、顔のディテール、演技制御を指しており、本人認証、顔照合、または顔交換インターフェースではありません。 ### 高級ブランド短編：人物、製品、ブランド資産の統一 **制作目標：** 16:9 の高級ファッションブランド映像。荒漠の道路とヴィンテージカーによってクールな雰囲気を構築し、女性主人公の外見と黒いハンドバッグの構造を維持しながら、ブランド Logo を自然にエンディングへ組み込みます。この事例では、ショットをまたぐ人物の一貫性、商品維持、映画的な質感、ブランドによる締めくくりの能力を重点的に検証します。 | 雰囲気とシーンの参照 | 人物参照 | | - | - | | 荒漠の道路とヴィンテージカーによるブランド映像の雰囲気参照 | ブランド映像の女性主人公参照 | | ハンドバッグ製品参照 | ブランド Logo 参照 | | - | - | | 黒いハンドバッグの製品参照 | ブランド Logo 参照 |