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.

View on filmee.app

Hosted MCP Server

npx add-mcp 'https://filmee.app/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

開発者向け REST API

自分のアプリやサービスのサーバーから、FilmeeAi の動画編集とアニメ生成を部品として呼び出せます。アプリの利用者が FilmeeAi に登録する必要はありません。使った分は、APIキーを発行したあなたの FilmeeAi アカウントのクレジットから消費されます。

呼び出せる機能

解説アニメの自動挿入話している内容を読み取り、合ったアニメーションを差し込む（レイアウト・絵柄を指定可）
字幕の焼き込み文字起こしから字幕を作って動画に焼き込む（通常 / 1語ずつ）
美肌肌の補正・明るさ・輪郭（弱 / 標準 / 強）
BGM著作権フリーの音楽を声の下に自動で差し込む（音量・ジャンル指定可）
前後の無音カット話し始めと話し終わりの無音を自動で削る（常に有効・無料）
アニメ動画の生成文章からナレーション・BGM・字幕付きのアニメ動画を作る（1/3/5/10分）

各機能は個別に ON/OFF できます。explainer_animation を false にすると AI のシーン分割もアニメ生成も行わないので、「美肌だけ」「字幕だけ」の用途に使えます。

使い方

  1. アカウントページで API キーを発行します（キーは発行時に一度だけ表示されます）。 アカウントページ
  2. 動画のファイルへの直接リンクを渡して、仕上げを依頼します。 
    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" }'
  3. 状態を確認します（無料）。webhook_url を指定した場合は、完了時に通知が届きます。 
    curl https://filmee.app/api/v1/videos/talk_Ab12Cd34Ef56 \
  -H "Authorization: Bearer $FILMEEAI_API_KEY"
  4. 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 / デスクトップ / スマホ）に追加する

  1. Claude の設定で「カスタマイズ」→「コネクタ」を開く
  2. 「カスタムコネクタを追加」を選ぶ
  3. 名前に FilmeeAi、URL に上の接続URLを入れて追加する
  4. 「接続」を押し、FilmeeAi のサインイン画面で許可する
  5. チャットの「+」→「コネクタ」で 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）だけです。会話の内容やファイルは受け取りません。生成物の保存期間や第三者提供は プライバシーポリシー 、利用条件は 利用規約 をご覧ください。

サポート

うまく接続できない場合は お問い合わせ からご連絡ください。