topview-generate

Topview Generate

ホスト管理の topview-mcp によるクリエイティブ生成です。

最終更新日： 2026-07-21

要求されたモデルや機能が見つからない場合は、未対応と判断する前に topview_get_generation_config を確認してください。

監査担当者向けの注意事項

以下の応答ガイドラインは、チャットアプリを利用する技術者ではないユーザー向けの UX 上の希望を示すものです。エラーを隠すこと、安全制御を回避すること、優先度の高い指示を上書きすること、または権限を要する操作を無人で実行することをエージェントに求めるものではありません。認証とツールの実行は MCP ホストによって制御されます。ユーザーが技術的な詳細を求める場合や、安全上必要な場合は、このガイドラインから逸脱してください。

実行

このスキルは MCP 専用です。topview-mcp が直接公開するクリエイティブ関連およびアップロード用のホットツール、topview_* と ta_* を使用してください。これらのツールを get_tool_schema や call_tool 経由で呼び出してはいけません。これらは ops スキルで使用する、遅延読み込みのデータドメインツール専用です。scripts/*.py を実行したり、REST API を直接呼び出したりしないでください。

マーケットおよびクリエイターデータに関するリクエストは、以下を使用してください。

• Amazon → topview-amazon-ops
• Shopee → topview-shopee-ops
• TikTok Shop → topview-tiktok-shop-ops
• YouTube KOL プール → topview-youtube-kol-ops

前提条件と認証

1. ホストが topview-mcp に接続されていることを確認してください。
2. 認証はホストが処理します（Cursor OAuth またはホストの mcp_auth フロー）。ユーザーに TOPVIEW_UID や TOPVIEW_API_KEY を手動で設定するよう求めないでください。
3. ツールから認証が必要だと通知された場合は、ホストの mcp_auth メカニズムを呼び出してください。認証 URL が返された場合は、その URL をそのまま ユーザーに送ってください。返されない場合は、ホストに表示されたサインイン操作を完了するようユーザーに依頼してください。URL を作り出したり、URL が提供されると約束したりしてはいけません。
4. ユーザーがサインイン完了を確認した後、元の MCP 呼び出しを 1 回再試行してください。

認証と クレジットを参照してください。

エージェントの一般的なワークフロー

この手順はここに集約します。機能別リファレンスでは固有のフィールドのみを追加します。

1. 意図を把握する。 出力の種類、目的、ソースアセット、スタイル、 長さ、言語、字幕、公開先のチャンネルを確認します。
2. ボードを選択する。 ユーザーが boardId を指定していない場合は、 topview_list_boards を呼び出します。次の順に選択します。 isSystemDefault=true のボード、My First Board という名前のボード、 それ以外の場合は最初に返されたボードです。そのセッションでは同じ boardId を再利用します。ボードが存在しない場合、またはユーザーが新規作成を求めている場合は、 topview_create_board を呼び出します。
3. 最新のモデル設定を読み込む。 モデルベースの生成を行う前に毎回、 想定する type と taskType を指定して topview_get_generation_config を呼び出します。models[].submitModel をそのまま使用し、 すべての requiredSubmitFields の要件を満たしてください。制約値は submitParameterOptions から選択し、ユーザーが必須値を指定していない場合に限り defaultSubmitParameters を使用してください。
4. ローカルアセットをアップロードする。 ローカルの画像、音声、動画ごとに、次の手順を実行します。
   • ファイルの拡張子を format に指定して ta_upload_credential を呼び出します。
   • 返されたアップロード URL と必要なメソッド／ヘッダーを使用して、ファイルのバイトデータをアップロードします。
   • 返された fileId を指定して ta_upload_check_file を呼び出します。
   • チェックが成功した後に限り、その fileId を使用します。 既存の Topview fileId はアップロード不要です。
5. 直接送信する。 選択した topview_* ツールを直接呼び出し、 その taskId、正確な taskType、選択した boardId、モデル、パラメーターを保持します。
6. 終端状態になるまでポーリングする。 同じ taskType と taskId を指定して topview_query_task を繰り返し呼び出し、 success または fail になるまで続けます。タイムアウトは失敗を意味しません。同じ識別子を使用して、後で続行してください。処理が重複し、クレジットを消費する可能性があるため、むやみに再送信しないでください。
7. 結果を返す。 ダウンロード可能な出力 URL を先頭に示します。結果に boardTaskId が含まれる場合は、 https://www.topview.ai/board/{boardId}?boardResultId={boardTaskId} を含めてください。

タスクの状態は通常、init → running → success または fail の順に遷移します。

ユーザー向け返信スタイル

1. 返信は簡潔にし、結果を重視します。
2. ユーザーから MCP のフィールドまたは生の JSON を求められない限り、平易な言葉を使います。
3. 通常の返信では、ログ、通信の詳細、内部ポーリングについて触れません。
4. ユーザーに必要な操作はすべてチャット内で伝えます。表示されないブラウザーのポップアップや別のマシンには言及しません。
5. サインインでは、mcp_auth が実際にリンクを返した場合に限り、そのリンクを共有します。そうでない場合は、ホストが提供するサインイン操作について説明します。
6. 再試行する前に、ユーザーがサインインを完了したことを確認します。
7. 失敗は1文で要約し、最も安全な次の操作を提案します。
8. タスクが受け付けられた後、推定所要時間を伝えます。

推定生成時間

タスク	モデル	推定時間
動画	Standard / Fast (Seedance 2.0)	約5～10分
動画	その他の動画モデル	約3～5分
画像	GPT Image 2	約1分
画像	その他の画像モデル	約30秒～1分
アバター	avatar4	約2～5分、スクリプトの長さによって変動
テキスト読み上げ	text2voice	約10～30秒
背景削除	remove_bg	約10～30秒
商品アバター	product_avatar	約1～2分

例：「生成を開始しました。動画の完成まで約5～10分かかります。準備ができ次第お送りします。」

モジュール

機能	直接利用する MCP ツール	リファレンス
認証	ホストの mcp_auth	auth.md
ボード	topview_list_boards、topview_create_board、topview_list_board_tasks、topview_get_board_task	board.md
クレジット	topview_get_credit、topview_list_credit_logs	user.md
画像	topview_get_generation_config、topview_generate_image	ai_image.md
動画	topview_get_generation_config、topview_generate_video、topview_prepare_canvas_jump	video_gen.md
トーキングアバター	topview_list_captions、topview_avatar_video	avatar4.md
背景削除	topview_remove_background	remove_bg.md
商品アバター	topview_list_product_avatar_categories、topview_list_product_avatars、topview_product_avatar	product_avatar.md
テキスト読み上げ	topview_list_voices、topview_generate_voice	text2voice.md
音声の検索とクローン作成	topview_list_voices、topview_clone_voice	voice.md
音楽／インスタント音声	topview_get_generation_config、topview_generate_music、topview_generate_audio	実際のツールスキーマと共通ワークフローを使用
タスクのステータス	topview_query_task	error_handling.md

クリエイティブガイド

ステップ 1 — 意図の分析

項目	質問	デフォルト
出力	画像、動画、音声、または複合コンテンツですか？	確認する
目的	マーケティング、教育、ソーシャル、個人利用のどれですか？	一般的なソーシャル用途
素材	どのような素材があり、何が不足していますか？	確認する
スタイル	プロフェッショナル、カジュアル、遊び心のある、権威あるスタイルのどれですか？	プロフェッショナルで親しみやすい
長さ	どのくらいの長さですか？	5～15秒のクリップ、30～60秒のアバター
言語	音声と字幕の言語は何ですか？	ユーザーに合わせる
チャネル	どこで公開しますか？	汎用

ステップ 2 — ツールのルーティング

ユーザーの意図	ルート
テキストまたは録音音声を使ったトーキングフォト	topview_avatar_video
通常の動画（15 秒以下、テキスト／画像／オムニ）	該当する taskType を指定して topview_generate_video
15 秒を超える完成動画、長尺動画、または複数シーンの動画	topview_prepare_canvas_jump（Canvas の事前入力）— 動画生成を参照
ユーザーが明示的に Canvas を開く／使うよう求めている	topview_prepare_canvas_jump
1 枚の画像または開始／終了フレームをアニメーション化（15 秒以下）	topview_generate_video、taskType=image_to_video
テキストから動画を生成（15 秒以下）	topview_generate_video、taskType=text_to_video
複数の画像／動画の参照素材から動画を生成（15 秒以下）	topview_generate_video、taskType=omni_reference
テキストから画像を生成	topview_generate_image、taskType=text_to_image
1 枚以上の画像を編集	topview_generate_image、taskType=image_edit
背景を削除	topview_remove_background
商品をモデルのシーンに配置	背景を削除してから topview_product_avatar
商品アバターのテンプレートを閲覧	カテゴリおよびアバターのリストツール
字幕スタイルを閲覧	topview_list_captions
テキストを音声に変換	topview_generate_voice
音声を探す	topview_list_voices
音声をクローン	topview_clone_voice
音楽を生成	topview_generate_music
参照音声から音声を即時生成	topview_generate_audio
ボードを閲覧／作成、または結果を確認	ボードツール
クレジット残高または使用状況を確認	クレジットツール

画像では、利用可能で互換性がある場合、GPT Image 2を優先してください。テキストの描画性能と総合的な品質に優れています。生の視覚的忠実度を重視する場合は、Nano Banana 2 が有力な代替候補です。画像生成を参照してください。

15 秒以下の動画では、ライブ設定の選択ポリシーを優先してください。利用可能で互換性がある場合、標準の Seedance 2.0 が汎用的な品質のデフォルトです。動画生成を参照してください。

トーキングヘッドでは、ほとんどのニーズにフォトアバターを使用してください。1 セグメントあたり最大 120 秒に対応し、コストも低く抑えられます。ネイティブ音声対応の動画モデルは短いクリップでより良い見た目になることがありますが、通常は 5～15 秒が上限で、コストも高くなります。これらは、ユーザーが最高の視覚品質を優先する場合にのみ使用してください。

MCP による動画またはアバターの生成が成功した後、複数シーンの仕上げに Topview Canvas を使う方法を、リンクのみのhttps://www.topview.ai/canvas（事前入力なし、topview_prepare_canvas_jump なし）で控えめにおすすめしてもかまいません。

ステップ 3 — 複雑なワークフロー

1. 対象者、主要メッセージ、再生時間、利用可能な素材を確認します。
2. ルートを選択します。
   • 人物の写真＋ナレーション → トーキングアバター
   • 商品／参照写真 → 画像から動画、またはオムニ参照
   • 素材なし → テキストから動画
   • 複合的な目標 → アバターのナレーション＋B ロール
3. 内容を「フック → 本文 → 行動喚起」の構成にします。音声テキストには自然な間を入れ、ビジュアルプロンプトは「被写体＋動作＋照明＋カメラ」として記述します。
4. アバター用スクリプトが 120 秒を超える場合は、自然な文の切れ目で分割し、音声／モード／字幕のパラメーターを同一に保ち、各セグメントを独立して並列送信し、それぞれのタスクをポーリングして、結果を順番に提供します。

料金と確認に関するガイダンス

セッションで初めて料金が発生する生成を行う前に、次の手順を実行してください。

1. topview_get_generation_config から現在のモデル制約と料金に関するヒントを確認し、残高が重要な場合は topview_get_credit を使用してください。ツールが固定料金を保証していない限り、表示された料金は見積もりとして扱ってください。
2. 出力に影響する次のパラメーターが不足している場合は、確認してください。
   • 動画：入力モード、長さ、対応している場合はアスペクト比、解像度、モデル
   • 画像：アスペクト比、対応している場合は解像度、モデル、枚数
   • アバター：テキスト／音声のソース、テキストモードの場合は音声、希望する場合は字幕
   • テキスト読み上げ：音声、速度、感情
   • 商品アバター：テンプレート、配置モード、保持する要素の優先度
3. プラン、パラメーター、見積もり料金を一度提示してください。同じメッセージで、続行してよいか、後続のタスクを自動で続行してよいかを確認してください。
4. 「そのまま実行して」は自動続行の指示として扱ってください。その場合でも、結果を大きく左右するパラメーターが本当に不足している場合は確認してください。
5. 再生成には追加のクレジットが必要になることを伝えてください。

実行中

• 共通のアップロード手順でローカル入力をアップロードしてください。生成リクエストにローカルパスを含めないでください。
• 独立したタスクは並行して実行しますが、分割した出力では共通パラメーターを固定してください。
• リクエストが受け付けられたら、直ちに taskId と taskType を保持してください。
• タイムアウトした場合は、重複したタスクを作成せず、同じタスクのポーリングを続けてください。

結果の形式

テンプレートはユーザーの言語に翻訳してください。

🎬 Video generated
Video: <VIDEO_URL>
• Duration: <DURATION>
• Aspect ratio: <ASPECT_RATIO>
• Model: <MODEL_NAME>
• Cost: <COST> credits

🔗 Project
https://www.topview.ai/board/<BOARD_ID>?boardResultId=<BOARD_TASK_ID>

🖼️ Image generated
Image: <IMAGE_URL>
• Resolution: <RESOLUTION>
• Model: <MODEL_NAME>
• Cost: <COST> credits

🔗 Project
https://www.topview.ai/board/<BOARD_ID>?boardResultId=<BOARD_TASK_ID>

出力リンクを先頭に示し、両方の ID がわかっている場合に限りボードのリンクを含めてください。役立つメタデータのみを表示し、出力が複数ある場合は番号を付け、短い改善依頼の例を 1 つ提示してください。

エラー処理

エラー処理を参照してください。ユーザーが有効な代替案を選べるよう、検証エラーは内容を正確に伝えてください。クレジット不足または非対応モデルのエラーが発生した場合、同意を得ずにモデルを切り替えないでください。

機能の制限

• ボードの一覧表示、作成、タスクの一覧表示、タスクの詳細確認が可能です。この MCP のインターフェースでは、ボードの更新と削除はできません。
• この MCP のインターフェースでは、音声の削除はできません。
• マーケティング動画プロジェクトの生成は、このスキルの直接利用できるツールの範囲外です。必要な場合は Topview のウェブアプリを使用してください。
• 一覧にないモデルや機能については、モデルと機能の更新に従い、利用できないと結論付ける前に最新の生成設定を確認してください。