MCP(モデルコンテキストプロトコル)
MCP ツールリファレンス
現在の FoxCut MCP ツール、課金の仕組み、結果の仕様です。
読み取り専用ツール
| ツール | 用途 |
|---|---|
| account_status | プラン、状態、アイデンティティ、クレジット残高 |
| list_models | モデルの機能と料金 |
| list_workflows | タスク別ワークフローカタログ |
| list_presets | モーション、スタイル、マーケティングのプリセット |
| list_voices | 音声のみ生成とトーキングアバターの音声選択肢 |
| estimate_generation_cost | 送信前のクレジット見積もり |
| get_generation | 1 件のジョブの状態と出力 |
| 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_video | UGC、デモ、レビュー、広告の各モード |
| create_brand_asset | 選択したブランドシステムの成果物を 1 点 |
| create_marketplace_cards | コマースカードを 1 枚以上作成 |
| create_video_explainer | ナレーション付きシーンまたは編集済み解説動画 |
| create_youtube_thumbnail | 16:9 または縦型のカバー画像 |
| create_character / train_character | アイデンティティを下書きして学習 |
| create_moodboard | 再利用できるビジュアル方針を保存 |
| cancel_generation | 対象となる作業を停止します。アセットは削除されません |