FilmeeAi
Make narrated storybook anime videos (1-10 min, 9 narration languages) from one line of text, or add explainer animation and subtitles to a recorded talking-head video. Remote Streamable HTTP endpoint https://filmee.app/mcp with OAuth; free credits on sign-up.
Servidor MCP alojado
npx add-mcp 'https://filmee.app/mcp'Se instala en Claude Code, Codex, Cursor y más
Documentación
開発者向け REST API
自分のアプリやサービスのサーバーから、FilmeeAi の動画編集とアニメ生成を部品として呼び出せます。アプリの利用者が FilmeeAi に登録する必要はありません。使った分は、APIキーを発行したあなたの FilmeeAi アカウントのクレジットから消費されます。
呼び出せる機能
| 解説アニメの自動挿入 | 話している内容を読み取り、合ったアニメーションを差し込む(レイアウト・絵柄を指定可) |
|---|---|
| 字幕の焼き込み | 文字起こしから字幕を作って動画に焼き込む(通常 / 1語ずつ) |
| 美肌 | 肌の補正・明るさ・輪郭(弱 / 標準 / 強) |
| BGM | 著作権フリーの音楽を声の下に自動で差し込む(音量・ジャンル指定可) |
| 前後の無音カット | 話し始めと話し終わりの無音を自動で削る(常に有効・無料) |
| アニメ動画の生成 | 文章からナレーション・BGM・字幕付きのアニメ動画を作る(1/3/5/10分) |
各機能は個別に ON/OFF できます。explainer_animation を false にすると AI のシーン分割もアニメ生成も行わないので、「美肌だけ」「字幕だけ」の用途に使えます。
使い方
- アカウントページで API キーを発行します(キーは発行時に一度だけ表示されます)。 アカウントページ
- 動画のファイルへの直接リンクを渡して、仕上げを依頼します。
美肌だけの例:curl -X POST https://filmee.app/api/v1/talk-videos \ -H "Authorization: Bearer $FILMEEAI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "video_url": "https://example.com/my-talk.mp4", "explainer_animation": true, "subtitles": true, "beautify": true, "beautify_level": "normal", "language": "ja", "webhook_url": "https://your-app.example.com/filmeeai/webhook" }'curl -X POST https://filmee.app/api/v1/talk-videos \ -H "Authorization: Bearer $FILMEEAI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "video_url": "https://example.com/my-talk.mp4", "explainer_animation": false, "subtitles": false, "beautify": true, "beautify_level": "strong" }' - 状態を確認します(無料)。webhook_url を指定した場合は、完了時に通知が届きます。
curl https://filmee.app/api/v1/videos/talk_Ab12Cd34Ef56 \ -H "Authorization: Bearer $FILMEEAI_API_KEY" - status が completed になったら、完成動画を受け取ります。 課金されるのはこの呼び出しの初回だけ で、2回目以降は無料で同じURLが返ります。
curl -X POST https://filmee.app/api/v1/videos/talk_Ab12Cd34Ef56/result \ -H "Authorization: Bearer $FILMEEAI_API_KEY"
アニメ動画を作る
curl -X POST https://filmee.app/api/v1/anime-videos \
-H "Authorization: Bearer $FILMEEAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "prompt": "A shy robot learns to make friends", "length_minutes": 1, "language": "en" }'
料金
Web と同じクレジット単価です。トーク動画は1分あたり12クレジット+字幕1・美肌2・BGM2(分単位の切り上げ)。アニメ動画は1分100・3分250・5分400・10分700クレジット。失敗したジョブは消費されません。残高は GET /account で確認できます。
上限
- トーク動画: 15分・2GB まで。YouTube / TikTok / Instagram / Vimeo のページURLは読めません(ファイルへの直接リンクを渡してください)
- 開始できる動画: 1アカウントあたり1時間に10本、トーク動画の同時処理は3本まで
- APIリクエスト: 1キーあたり1分に120回まで(超えると 429 と Retry-After)
- トーク動画のジョブは完了から約6時間で状態が消えます。その前に result を受け取ってください
- 受け取った動画URLは保存期間を保証しません。自分のストレージに保存してください
Webhook(完了通知)
完了(video.completed)または失敗(video.failed)時に、webhook_url へ POST します。本文に動画のURLは含みません。FilmeeAi-Signature ヘッダの署名を、キー発行時に表示される webhook secret で検証してください。通知はベストエフォート(3回まで再送)なので、状態の正は常に GET /videos/{id} です。
import crypto from "node:crypto";
// header = req.headers["filmeeai-signature"] (t=...,v1=...)
export function verify(rawBody, header, secret) {
const parts = Object.fromEntries(header.split(",").map((p) => p.split("=")));
const expected = crypto
.createHmac("sha256", secret)
.update(\`${parts.t}.${rawBody}\`)
.digest("hex");
const ok = crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1 ?? ""));
const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) < 300;
return ok && fresh;
}
エラー
エラーは { "error": { "code": "...", "message": "..." } } の形で返ります。主な code: missing_api_key / invalid_api_key (401)、invalid_parameters / invalid_video_url (400)、insufficient_credits (402)、video_not_found (404)、not_ready / video_failed (409)、rate_limited / job_rate_limited / too_many_active_jobs (429)。
利用上の注意
人物の映った動画を加工する場合は、映っている本人の同意を得たものだけを送ってください。違法・権利侵害のコンテンツには使えません。
仕様書(OpenAPI)
https://filmee.app/api/v1/openapi.json
AIエージェントから使う(MCP)
できること
エージェントに「桃太郎の1分アニメを作って」と頼むだけで、FilmeeAi がナレーション・BGM・字幕付きのアニメ動画を作り、視聴用のリンクを返します。ふだんの FilmeeAi アカウントとクレジットをそのまま使います。
接続URL
https://filmee.app/mcp
認証は OAuth(あなたの FilmeeAi ログイン)です。API キーの貼り付けは不要で、接続時にサインイン画面が出ます。
Claude(Web / デスクトップ / スマホ)に追加する
- Claude の設定で「カスタマイズ」→「コネクタ」を開く
- 「カスタムコネクタを追加」を選ぶ
- 名前に FilmeeAi、URL に上の接続URLを入れて追加する
- 「接続」を押し、FilmeeAi のサインイン画面で許可する
- チャットの「+」→「コネクタ」で FilmeeAi をオンにする
Claude Code に追加する
ターミナルで次を実行し、初回にブラウザでサインインします。
claude mcp add --transport http filmeeai https://filmee.app/mcp
Cursor・ChatGPT・その他
Streamable HTTP の MCP に対応したクライアントなら、上の接続URLをそのまま登録できます。
ツール一覧
| ツール | 役割 | 課金 |
|---|---|---|
get_credit_balance | クレジット残高とプランを確認 | 無料 |
create_anime_video | あらすじから動画の生成を開始(1/3/5/10分) | 無料(開始時点) |
get_video_status | 生成の進み具合を確認 | 無料 |
get_video_link | 完成動画の視聴・共有URLを取得 | 初回のみクレジット消費 |
list_my_videos | 自分の完成動画を一覧 | 無料 |
create_talk_video_from_url | 撮影済みトーク動画のURLを渡して、前後の無音カット(無料)・字幕・美顔(強さ指定)・BGM(音量/ジャンル)・早口化・ズーム・解説アニメ挿入(15分/2GBまで) | 無料(開始時点) |
get_talk_video_status | トーク動画の編集の進み具合を確認 | 無料 |
get_talk_video_link | 完成したトーク動画の視聴・共有URLを取得 | 初回のみクレジット消費 |
クレジット
Web と同じ料金です。課金されるのは get_video_link で動画を受け取った時だけで、生成に失敗した場合は消費されません。
| 1分 | 100 クレジット |
|---|---|
| 3分 | 250 クレジット |
| 5分 | 400 クレジット |
| 10分 | 700 クレジット |
トーク動画は1分あたり12クレジットに、字幕+1・美白+2・BGM+2(いずれも1分あたり)を加えた額で、分単位の切り上げです。動画はファイルへの直接リンクで渡します(YouTube のページは読めません)。
無料プランは毎月200クレジット。追加は 料金ページ から。
データの扱い
エージェントから受け取るのは、ツールに渡された入力(あらすじ・設定・ジョブID)だけです。会話の内容やファイルは受け取りません。生成物の保存期間や第三者提供は プライバシーポリシー 、利用条件は 利用規約 をご覧ください。
サポート
うまく接続できない場合は お問い合わせ からご連絡ください。