ドキュメントを見る
MCP(モデルコンテキストプロトコル)

MCP ツールリファレンス

現在の FoxCut MCP ツール、課金の仕組み、結果の仕様です。

読み取り専用ツール

ツール用途
account_statusプラン、状態、アイデンティティ、クレジット残高
list_modelsモデルの機能と料金
list_workflowsタスク別ワークフローカタログ
list_presetsモーション、スタイル、マーケティングのプリセット
list_voices音声のみ生成とトーキングアバターの音声選択肢
estimate_generation_cost送信前のクレジット見積もり
get_generation1 件のジョブの状態と出力
list_generations最近のジョブ
list_assets生成メディア
list_characters再利用可能な人物像

H3 MAX の参照動画生成

model=minimax-h3-max、video_mode=reference と reference_image_urls、reference_video_urls、reference_audio_urls のいずれかを指定して generate_video を使います。まずメディアをインポートまたはアップロードし、返された相対アセットコンテンツ URL を渡してください。参照素材はアイデンティティ、スタイル、動き、音を導くもので、開始・終了フレームではありません。

  • 画像は最大 9 枚、動画クリップは 3 本、音声クリップは 3 本で、合計 12 ファイルまで使用できます。動画・音声クリップはそれぞれ 2〜15 秒で、各メディア形式の合計尺は 15 秒までです。音声を使う場合は画像または動画が 1 つ以上必要です。
  • アセットには一覧順に Image 1、Image 2、Video 1、Audio 1 と名前を付けます。それぞれの役割を説明し、動作、カット、各セリフを話すキャラクターを指定します。指示どおりの結果が保証されるわけではありません。
  • 参照モードでは、開始・終了フレーム、キャラクター ID、スタイル/カメラプリセット、単数形の reference_video_url(Kling モーション転送)を併用しないでください。
  • kind=t2v と params.videoMode=reference、referenceImageUrls、referenceVideoUrls、referenceAudioUrls、durationSec、resolution、aspect を指定して見積もります。参照素材の費用も含まれ、検証済みアセットのメタデータが使われます。クライアント側のトークン数は無視されます。
  • 480p または 768p、list_models にある長さとアスペクト比、standard または draft の品質を使います。生成時に見積もり分のクレジットが確保され、ポーリング用のジョブ ID が返されます。

作成ツール

ツール動作
generate_imageテキストから画像を生成、または画像を編集するジョブをキューに追加
generate_videoテキスト、画像、参照素材、モーションから動画を生成するジョブをキューに追加
generate_audio音声のみの WAV 生成をキューに追加。出力された UTF-8 バイト数に応じて 2〜8 クレジット
generate_speechトーキングアバター動画を生成するジョブをキューに追加
edit_media / upscale_media元データを変更しない派生ジョブ
run_product_photoshoot商用画像の各モード
create_marketing_videoUGC、デモ、レビュー、広告の各モード
create_brand_asset選択したブランドシステムの成果物を 1 点
create_marketplace_cardsコマースカードを 1 枚以上作成
create_video_explainerナレーション付きシーンまたは編集済み解説動画
create_youtube_thumbnail16:9 または縦型のカバー画像
create_character / train_characterアイデンティティを下書きして学習
create_moodboard再利用できるビジュアル方針を保存
cancel_generation対象となる作業を停止します。アセットは削除されません