Vidu MoE とは？Mixture-of-Experts 動画モデル

一言でまとめるなら： Vidu MoE **は、1〜16 秒のクリップ、最大 1080p、24 fps、非同期配信、そして 1 回のリクエストでオプションの音声を必要とするチームのためのショート動画 API です。**APIMart では Vidu Q3 API をすぐに試せます。

本番投入への適合性を判断したいなら、結論はこうです。非同期ジョブを扱える体制があり、リトライ分の予算を見込み、各工程に適したモデル階層を選べる場合に最も効果を発揮します。 私ならプレビューには viduq3-turbo を、最終出力には viduq3-pro を使います。多くのジョブは 720p で約 60〜120 秒、1080p で約 90〜180 秒で完了し、ピーク時の待ち時間は約 4 分に達することもあります。

最も重要なポイントは次のとおりです。

• 入力モード： text-to-video、1 枚画像のアニメーション化、Grok Imagine Video の代替手段、2 フレームの開始/終了動画、複数画像の参照入力
• クリップの制限： 1〜16 秒
• 出力： 最大 1080p、24 fps
• 音声： 同じリクエスト内でオンにできる
• 画像参照： より広いモデル機能セットでは最大 7 枚
• 主要な API ルール： 画像 URL を送る場合は aspect_ratio を 送らない
• 配信： task_id を用いた非同期とポーリング
• 料金の例： Pro は 5 秒で約 $0.60、12 秒で $1.44
• 予算の現実： 承認済みクリップ 1 本につき 2〜3 回の試行を見込む

いくつかの細部が際立っています。この API は model、prompt、そしてオプションのメディア入力を持つシンプルな JSON リクエストを使います。モデル選択は明快で、低コストのテストには turbo、ハイエンドのレンダリングには pro という具合です。シード制御は、完全一致ではないものの、リトライをまたいで出力を似た方向に保つのに役立ちます。

これをプロダクトチーム向けに評価するなら、私は次の 3 つの問いに集中します。

1. 自分のアプリは非同期処理をきれいに扱えるか？
2. プロンプトのみの生成、画像主導の制御、開始/終了フレーム制御のどれが必要か？
3. 初回コストだけでなく、リトライ後も予算は成り立つか？

要点まとめ

• Vidu MoE は API 上で viduq3-mix に対応する。1〜7 枚の参照画像とプロンプトから、24 fps・720p または 1080p で 1〜16 秒のクリップを作る Q3 の参照生成モデルである。
• APIMart では、テキストから動画、画像から動画、開始・終了フレーム動画は viduq3-pro と viduq3-turbo が担い、1〜7 枚の画像による参照生成は viduq3 と viduq3-mix が担う。出力は 540p〜1080p（viduq3-mix は 720p と 1080p）で、ネイティブ音声も任意で付けられる。
• リクエストは https://api.apimart.ai/v1/videos/generations へ非同期で送信され、ステータス確認用の task_id が返る。image_urls と一緒に aspect_ratio を送ると 400 エラーになる。
• Pro は 5 秒クリップで約 0.60 ドル、12 秒クリップで約 1.44 ドルで、viduq3-turbo は Pro の約半額のため反復作業に向く。
• 一般的なジョブは 720p で 60〜120 秒、1080p で 90〜180 秒かかり、ピーク時は約 4 分待つこともあるため、承認済みクリップ 1 本あたり 2〜3 回の試行を予算に見込むべきである。

クイック比較

完全なガイドを読む前に、要点はシンプルです。Vidu MoE は、複数の入力モード、組み込みの音声、そして turbo と pro の切り替えによるコスト制御を求める、API ベースのショート動画生成に適しています。 残りは、リクエストの設定、ステータス処理、そして自分のワークフローに合う入力方法の選択に尽きます。

Vidu MoE の概要と中核機能

API レベルでは、Vidu MoE は少数のモデル名、ワークフロー、出力フィールドに対応します。

Vidu MoE は API 上では、バランス型の Q3 モデルである viduq3-mix として現れます。viduq3-turbo は速度寄り、viduq3-pro はより細部寄りです。

動画生成における Mixture-of-Experts の意味

Mixture-of-experts は、生成プロセスの異なる部分を専門化したコンポーネントへ振り分けます。実際には、これがモーション、シーン構成、プロンプトへの忠実度に役立ちます。

Q3 シリーズはまた、インテリジェントなシーン切り替えとインテリジェントなカメラ切り替えをサポートします ^[2][4]。これは、モデルがシーンを見失うと連続性が一気に崩れかねないマルチショットのシーケンスで最も重要になります。

サポートされるワークフロー：Text-to-Video、Image-to-Video、参照ガイド付き生成

ここから先、主な違いは送る入力タイプに帰着します。

APIMart では、Q3 の 4 つのワークフローが複数のモデルに分かれています。

• Text-to-Video — プロンプトのみから。Vidu Q3 Pro API または Vidu Q3 Turbo API で利用
• Image-to-Video — 1 枚の開始画像から。viduq3-pro または viduq3-turbo で利用
• Reference-to-Video — 外見とスタイルの一貫性のための 1〜7 枚の画像から。viduq3 または viduq3-mix で利用
• Start-End to Video — 遷移を定義する 2 フレームから。viduq3-pro または viduq3-turbo で利用

viduq3 と viduq3-mix の参照生成用プロンプトは最大 5,000 文字（ドキュメント）、viduq3-pro と viduq3-turbo のテキストプロンプトは最大 2,000 文字です（ドキュメント）。viduq3-mix は Subjects エンティティライブラリをサポートしません。

入力と出力の一覧

送信ごとに data[0].task_id が返ります。GET /v1/tasks/{task_id} で status を確認し、completed になったら data.result.videos[0].url[0] に動画の URL が入ります。

Q3 の動画は 24 fps で動作し、1〜16 秒の長さをサポートし、540p、720p、1080p の出力を提供します ^[2]。画像入力は 1 ファイルあたり 50 MB に制限されています ^[4][1]。

これらのワークフローの選択肢が、次に送るペイロードを形作ります。続くセクションでは、それを認証とリクエスト形式に分解して解説します。

認証、リクエスト構造、APIMart のセットアップ

Vidu MoE 動画を生成するには、認証済みの JSON リクエストを送る必要があります。リクエストボディは入力モードによって異なります。テキストのみ、単一画像、複数画像のいずれかです。

API 認証情報の取得とリクエストヘッダーの設定

APIMart API キー管理ページから API キーを生成します ^[6]。それを APIMART_API_KEY として保存し、実行時に Python では os.environ.get("APIMART_API_KEY")、Node.js では process.env.APIMART_API_KEY で読み込みます。

すべてのリクエストに次のヘッダーを含めます。

• Authorization: Bearer YOUR_API_KEY
• Content-Type: application/json

動画生成ジョブの最小リクエストペイロード

Vidu Q3（MoE）生成用の標準 APIMart エンドポイントは https://api.apimart.ai/v1/videos/generations です ^[6]。API は image_urls からモードを判定します。

• URL 0 個 = text-to-video
• URL 1 個 = image-to-video
• URL 2 個 = first-to-last frame

中核となるフィールドと、それぞれの使用タイミングは次のとおりです ^[6]。

ここでよくあるミスが 1 つあります。aspect_ratio を image_urls と一緒に 送らないでください。画像を含めると、API はソース画像からアスペクト比を取得します。それでも aspect_ratio を送ると、リクエストは 400 エラーを返します。

ペイロードが設定できたら、ジョブを送信し、結果のポーリングを開始できます。

API 呼び出しの例とレスポンスパターン

text-to-video リクエストの例：

curl -X POST https://api.apimart.ai/v1/videos/generations \
  -H "Authorization: Bearer $APIMART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq3-turbo",
    "prompt": "A product shot of a glass perfume bottle on a marble surface, camera slowly zooms in, soft studio lighting",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "audio": false
  }'

送信が成功すると、task_id と submitted ステータスが返されます ^[6]。

{
  "code": 200,
  "data": [{
    "status": "submitted",
    "task_id": "task_xxxxxxxxxx"
  }]
}

API は非同期で動作します。つまり、最初のレスポンスはジョブが受理されたことを伝えるだけです。task_id を使って「Get Task Status」エンドポイントをポーリングします。ジョブが完了すると、レスポンスには MP4 リンクが含まれ、APIMart は結果を 72 時間保存します ^[6]。

シンプルなポーリングのリズムがうまく機能します。

• 最初の 5 分間は 5 秒ごとにポーリング
• その後は 1 分ごとにポーリング
• ステータスが completed になるまでポーリングを続ける

その時点で、返された動画リンクをダウンロードして保存します。

次に、duration、resolution、aspect ratio、参照入力を調整して、最終的な動画を制御します。異なるシネマティックスタイルを必要とするプロジェクトでは、ハイエンドの動画生成のために Kling V3 の機能を比較することもできます。

生成ワークフロー、パラメータ、出力制御

エンドツーエンドのフロー：送信、監視、取得、結果の保存

ジョブを送信したら、ステータスをポーリングします。APIMart は Vidu のジョブに Webhook を送らないため、進捗は GET /v1/tasks/{task_id} で追跡します ^[6]。

ジョブはその後、固定のステータス経路をたどります。pending → processing → completed または failed です ^[6]。タスクが failed に至った場合、レスポンスにはエラーメッセージが含まれます。それをログに記録し、ワークフロー内で処理しておくと、チームがパターンを把握し、問題をより早く修正できます。

ステータスが completed になったら、すぐに出力をダウンロードして耐久性のあるストレージに保存します。APIMart は結果を 72 時間しか保存しないため、このステップは重要です ^[6]。

構成、モーション、長さ、一貫性に影響する主要パラメータ

ジョブが動き出すと、いくつかのパラメータが、結果の見え方、実行ごとの安定度、かかる費用を形作ります。

最初から追跡しておく価値があるパラメータが 1 つあります。seed です。気に入ったモーションパターンが得られたら、その整数を記録して保持しておきましょう。そうすれば、後でプロンプトを調整するときに、同じシードを再利用して、ゼロからやり直すのではなく、似た全体構成を保てます。

プロンプトのみ、画像参照、その両方をいつ使うか

これらの入力モードでは、速度と制御を引き換えにできます。自分の視覚的な方向性がどれだけ固まっているかに合うものを選びましょう。

• プロンプトのみ（text-to-video）： ビジュアル素材が確定する前の初期アイデア出し、スタイルテスト、シーン実験に最適。viduq3-turbo を 540p または 720p で使ってイテレーションコストを抑えるか、高い一貫性の代替として WAN 2.6 と比較しましょう ^[7]。
• 単一画像（image-to-video）： 製品写真、キャラクターイラスト、ブランドビジュアルなど、特定のものをアニメーション化したいときに最適。EC やマーケティング業務に強く適合します。
• 2 枚画像（first-to-last frame）： 製品が特定の角度に回転する、キャラクターが定義されたポーズに移行するなど、遷移が決まった結果に着地する必要があるときに最適です ^[5]。

手動プロンプトでムラのある結果になる場合は、被写体・カメラ・動きの指示をより明確にしてプロンプトを書き直します。is_rec によるプロンプト最適化は Vidu 自身のプラットフォームのみの機能で、APIMart にはありません。

パフォーマンス、料金、実際の統合シナリオ

レイテンシ、信頼性、動画あたりのコストを評価する方法

リクエスト形式を固めたら、次に見るべきは速度、料金、ジョブの成功率です。これは非同期ワークフローなので、アプリはジョブを送信し、task_id を保存し、後でポーリングで最終的な MP4 を取得すべきです ^[3][6]。

ジョブは通常、シンプルな経路をたどります。queued、complete、または failed です。ジョブが失敗すると、クレジットは多くの場合自動的に返金されます ^[3][10]。これは本番で重要です。リトライは例外的なケースではなく、プロセスの一部だからです。

ターンアラウンドタイムについては、720p の生成は通常 60〜120 秒で完了します。1080p では 90〜180 秒程度を見込んでください。キュー時間はオフピーク時には 15〜30 秒であることが多く、ピーク時の p95 レイテンシは約 4 分まで延びることがあります ^[7]。というわけで、本番でも十分に機能します。ただし、非同期完了をきれいに扱えるようにシステムが設計されている場合に限ります。

料金については、Pro のレートで 5 秒のクリップが $0.60、12 秒のクリップが $1.44 です ^[10]。実際には、ほとんどのチームは 承認済みアセット 1 本につき 2〜3 回の試行を見込むべきです。これにより、使用可能なクリップ 1 本の最終コストは、長さに応じて $1.20〜$4.32 の範囲になります ^[10]。テストモードであれば、viduq3-turbo は Pro の約半額で、高速なイテレーションにより理にかなっています。Pro は最終レンダリングに取っておく方が良いでしょう ^[10]。

これらの数字は基本生成のみをカバーしています。リトライは 含まれていません。チームが複数回のパスを見込むなら（そしてほとんどがそうです）、日々の本番に近い予算にするには、合計を 2〜3 倍してください。

ユースケース：マーケティング動画、教育クリップ、EC 商品ビジュアル

コストと待ち時間が明確になったら、次のステップは、出荷したいアセットに適した入力モードを選ぶことです。最善の選択は、ほぼ 1 つのことに帰着します。自分がすでにどれだけの視覚的制御を持っているかです。

シンプルな考え方は次のとおりです。

• ブランドの一貫性が重要なら、Reference-to-Video を使う
• ソース画像がすでに良く見えるなら、Image-to-Video を使う
• 2 つの状態間のモーションが必要なら、First-Last Frame を使う
• 広告バリエーションを大量に高速で作りたいなら、Text-to-Video を使うか、高い一貫性のプロフェッショナルな出力のために MiniMax Hailuo 2.3 を検討する。

編集時間を削りたいチームにとって、ワークフローを最も変えるのはネイティブ音声です。ネイティブ音声は、別途のソーシングと編集作業を削減し ^[8]、1 回の生成パスで完成したクリップを得たいチームにとって、追加のポストプロダクション工程を取り除けます。そこがこのモデルが最も役立つ場面です。長いハンドオフの連鎖にファイルを通すことなく、出荷可能なアセットに近づけることが目標のときです。

結論：Vidu MoE が自分の本番ワークフローに合うかどうかの判断方法

Vidu MoE は、最大 12〜16 秒のショートクリップ、複数の入力モード、そして非同期 API 構成でのネイティブ音声が必要なときに意味があります。seed パラメータは、繰り返しのジョブをおおよそ同じ方向に保つのに役立ちますが、同一の入力がビット単位で一致する出力を生むとは期待すべきではありません ^[6][10]。失敗したジョブも、自動的なクレジット返金を引き起こす傾向があります ^[3][10]。

これは、ショート動画を大規模に制作し、結果まで数分待つことができ、リトライ分の予算に余裕があるチームに適しています。それがあなたのワークフローに当てはまるなら、APIMart は、マーケティングクリエイティブ、製品ビジュアル、解説コンテンツを 1 つの API サーフェスで実行するクリーンな方法を提供します。

よくある質問

最初にどの Vidu MoE モデルを使うべきですか？

ほとんどの開発者にとって、viduq3-turbo が最適な出発点です。最速の生成速度、優れた価格対性能比、そしてオーディオビジュアル同期やインテリジェントなシーン切り替えといった高度な機能を提供します。

最も充実した機能セットが欲しいなら、viduq3-pro を選びましょう。ストーリーボード生成と最高品質のオーディオビジュアル整合を備えています。どちらのモデルも 1〜16 秒の動画と最大 1080p の解像度をサポートします。

失敗した、または遅延した動画ジョブはどう扱うべきですか？

非同期ワークフローでタスク ID を使います。

時間がかかるジョブには、一定間隔でステータス API をポーリングします。APIMart は Vidu のジョブに Webhook を送りません。

ジョブが失敗した場合は、ステータスのレスポンスでエラーの詳細を確認します。

本番の安定性のために、ポーリング時には指数バックオフを使い、レート制限にぶつからないようにします。

APIMart は結果を 72 時間保存するため、各動画は完了後すぐにダウンロードしてください。

最も制御性が高い入力モードはどれですか？

APIMart で最も細かく制御できるのは、viduq3-pro または viduq3-turbo の開始・終了フレーム（image_urls に 2 枚）か、viduq3 または viduq3-mix の参照画像（1〜7 枚と必須のプロンプト）です。

開始・終了フレームは動きの始点と終点を固定し、参照画像はショットをまたいでキャラクター・商品・スタイルの一貫性を保ちます。

Vidu 自身のプラットフォームには、image_settings 配列で最大 9 つのキーフレームを指定するマルチフレームモードもありますが、このエンドポイントは APIMart では利用できません。