TakePilotドキュメント
日本語
日本語English

開発者向け / 技術的なしくみ

技術的なしくみ

ページをコピー
markdown で見るClaude で開くChatGPT で開く
このページ
  1. API キーはいらない
  2. つなぎ方
  3. スコープ
  4. ツール
  5. お金の守り
  6. 組み立てと書き出し
  7. 人が web でだけすること
  8. このドキュメントを AI に読ませる
  9. 次にやること

エージェントの設定をする人や、社内の開発の担当に向けた、TakePilot の技術的なしくみです。使い方だけを知りたいときは TakePilot とは を読んでください。

API キーはいらない

  • 動画・画像・声を作る AI の API キーは、すべて TakePilot のサーバーにあります。AI の会社と自分で契約する必要はありません。
  • 作った分は、TakePilot のクレジットで払います。どの AI の呼び出しも TakePilot のサーバーを通り、そこで 1 回ずつ数えて引きます（クレジットとプラン）。
  • 台本やカット割りを考えるのは、あなたのエージェントです。その分は、エージェントのサブスクで動き、TakePilot には払いません。

つなぎ方

TakePilot は、リモートの MCP サーバーとしてツールを出します。

項目 値
MCP サーバーの URL https://api.takepilot.ai/v1/mcp
認証 OAuth 2.1（動的なクライアントの登録）。初めてツールを使うときにブラウザが開き、TakePilot にログインして許可する
プラグイン スキル（広告の動画の作り方の手順）⁠と MCP のツールのセット。配布は公開のリポジトリ TakePilot/takepilot-plugin
エージェント 入るもの
Claude Code・Codex CLI・Grok Build プラグイン（スキルとコマンドとツール）
Claude Desktop プラグインの zip（チャットのモード）
ChatGPT のデスクトップアプリ カスタムの MCP サーバー（ツールと、手引きの get_playbook だけ。Chat のモード）
ほかの MCP クライアント リモートの MCP サーバーとスキルの zip（手順）。スキルを入れられなければ、手引きは get_playbook

入れ方の手順は プラグインで動画を作る にあります。

スコープ

許可の画面で、次の 3 つのスコープを渡します。

スコープ できること
read 商材・アバター・テンプレート・マイファイル・広告の成果を読む
write 商材を登録する、ファイルを上げる、広告の成果を送る（無料）
spend クレジットを使うツールを呼ぶ（声・画像・映像を作る、書き出す）

ツール

ツールは、動画を作る部品です。動画の段取りはエージェントが考え、ツールは生成と保存だけをします。

種類 費用 主なツール
読む 無料 list_products・list_avatars・list_templates・list_files・get_ad_results・get_playbook
見積もる 無料 estimate
作る 原価 + 20% generate_speech・generate_image・generate_clip・build_video・render_video
待つ 無料 wait_jobs（最長 50 秒で戻る）
登録・送る 無料 create_product・request_file_upload・sync_ad_results・set_spend_caps

長くかかる仕事（映像・組み立て・書き出し）⁠は、すぐに job_id を返し、wait_jobs で待ちます。

お金の守り

  • 費用のかかるツールは、max_usd（この呼び出しで使ってよい額）⁠と idempotency_key（8〜128 文字）⁠が必須です。見積もりが max_usd を超えると作りません。
  • 同じキーと同じ引数で呼び直すと、前と同じ結果を返し、2 回目は作りません。同じキーで引数が違うと idempotency_mismatch を返します。
  • 1 回（既定 $10）・エージェントごとの 1 日（既定 $20）・人の 1 日（既定 $50）⁠の上限を、サーバーが数えます。下げるのはツールからも web からもすぐ効きます。上げるのは、本人が確かめのページで確かめたときだけです。エージェントは自分で上限を上げられません（プラグインの費用と上限）。

組み立てと書き出し

  • 組み立ては、いつも TakePilot のサーバーで行います。毎回使い捨ての、ネットにつながらない箱の中で動かします。あなたの PC では組み立てません。
  • 書き出しは、PC のメモリが 16 GB 以上で空きが 10 GB 以上あれば、あなたの PC で行います。TakePilot が配る版の HyperFrames の CLI を使い、費用はかかりません。足りないときは、エージェントが聞いてから TakePilot のサーバーで書き出します（有料）。マップの動画、声のある他人のテンプレートから作った動画、隠された・無くなったファイルを使うバージョンは、いつもサーバーで書き出します。

人が web でだけすること

次のことは、エージェントからはできず、web で人が押します。ツールは、そのページの URL を返すだけです。

  • みんなの作品に公開する
  • 上限を上げる

このドキュメントを AI に読ませる

  • https://docs.takepilot.ai/llms.txt: 全ページの一覧
  • 各ページの URL の末尾に .md を付けると、markdown で読めます（例 https://docs.takepilot.ai/ja/developers.md）

次にやること

更新