> 全体の目次は https://docs.takepilot.ai/llms.txt

# 技術的なしくみ

![しくみの図。あなたが AI エージェントに作りたい動画を頼む。エージェントは台本・フック・カット割りを考え、TakePilot のツールを呼ぶ。TakePilot のサーバーが声・画像・映像を作って 1 本に組み立てて書き出し、マイファイルに保存する](https://docs.takepilot.ai/images/diagrams/ja/how-it-works-flow.svg)

エージェントの設定をする人や、社内の開発の担当に向けた、TakePilot の技術的なしくみです。使い方だけを知りたいときは [TakePilot とは](https://docs.takepilot.ai/ja/overview) を読んでください。

## API キーはいらない {#no-api-keys}

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

## つなぎ方 {#how-it-connects}

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（[手順](https://docs.takepilot.ai/ja/plugin#other-agents)）。スキルを入れられなければ、手引きは `get_playbook` |

入れ方の手順は [プラグインで動画を作る](https://docs.takepilot.ai/ja/plugin#setup) にあります。

## スコープ {#scopes}

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

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

## ツール {#tools}

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

| 種類 | 費用 | 主なツール |
|---|---|---|
| 読む | 無料 | `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` で待ちます。

## お金の守り {#spend-safety}

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

## 組み立てと書き出し {#build-and-render}

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

## 人が web でだけすること {#human-only}

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

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

## このドキュメントを AI に読ませる {#docs-for-ai}

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

## 次にやること {#next-steps}

- [プラグインで動画を作る](https://docs.takepilot.ai/ja/plugin)
- [プラグインの費用と上限](https://docs.takepilot.ai/ja/plugin-costs)
- [TakePilot のしくみ](https://docs.takepilot.ai/ja/how-it-works)