FilmeeAi
Tạo video truyện tranh anime có tường thuật (1-10 phút, 9 ngôn ngữ tường thuật) từ một dòng văn bản, hoặc thêm hoạt ảnh giải thích và phụ đề vào video quay cảnh người nói. Điểm cuối HTTP Streamable từ xa https://filmee.app/mcp với OAuth; tín dụng miễn phí khi đăng ký.
Máy chủ MCP được lưu trữ
npx add-mcp 'https://filmee.app/mcp'Cài vào Claude Code, Codex, Cursor và nhiều công cụ khác
Tài liệu
開発者向け 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)だけです。会話の内容やファイルは受け取りません。生成物の保存期間や第三者提供は プライバシーポリシー 、利用条件は 利用規約 をご覧ください。
サポート
うまく接続できない場合は お問い合わせ からご連絡ください。