BigBanana AI Director: オープンソースAIドラマ制作プラットフォーム
What is BigBanana AI Director?
BigBanana AI Director は、作家、アニメーター、開発者が AI 主導でスクリプト、ストーリーボードを作成し、MP4 としてエクスポートできる プロダクションレディなオープンソースフレームワーク です。GitHub 上の (shuyu‑labs/BigBanana‑AI‑Director)プロジェクトは次の技術で構築されています。
- React 19 + TailwindCSS:モダンでタイプセーフな UI
- AntSK API(テキスト:GPT‑5.x、ビジョン:Gemini‑3、動画:Sora 2 & Veo 3.1)
- IndexedDB:ローカルストレージ。バックエンド不要
- Docker:簡単で再現性のあるデプロイ
核心コンセプトは Script‑to‑Asset‑to‑Keyframe(スクリプト→アセット→キーフレーム)です。たった一行の文章が、キャラクター的一貫性・シーンの連続性・カメラ運動を正確にコントロールしつつ、フル長の短編ドラマに変換されます。
Key Features
| Feature | What it Does | Why It Matters |
|---|---|---|
| Automated Script Parsing | ストーリーのアウトラインをシーン・ビート・ダイアログに分解し、構造化されたスクリプトを生成します。 | 手作業でシーンを分解する時間を大幅に短縮します。 |
| Visual Prompt Generation | Gemini‑3 を用いて Midjourney スタイルのプロンプトを生成し、キャラクターリファレンス・環境コンセプト・キーフレームを作成します。 | ストーリーに沿った高品質画像を保証します。 |
| Keyframe‑Driven Video | Sora 2 & Veo 3.1 が開始フレームと終了フレーム間を補完し、滑らかな動画クリップを生成します。 | 映像監督のレベルのショット構図コントロールを実現します。 |
| Interactive Storyboard Grid | 9‑grid インターフェースで、個々のショットをドラッグ&ドロップ、調整し、全体のシーケンスをレンダリング前に確認できます。 | ペーシング・構図の微調整を迅速に行えるビジュアルエディタです。 |
| Export & Integration | HD キーフレームと MP4 クリップをエクスポートし、Adobe Premiere もしくは After Effects へのポストプロダクションに備えます。 | 業界標準ツールとの互換性を保持します。 |
| Docker‑Ready & Lightweight | 事前構築済み Docker イメージがすべての依存関係を含むので、起動するだけで本番稼働可能です。 | 「私のマシンで動く」問題を解消します。 |
The Four‑Phase Workflow
- Script & Storyboard – 生テキストまたはアウトラインを入力し、AI に分解・構造化させます。プロンプト編集・キャラクターリスト調整・カメラアングル変更がリアルタイムで可能です。
- Assets & Casting – 各キャラクターと環境の参照画像を生成。ワードローブシステムで顔を一定に保ちつつ衣装を差し替えられます。
- Director Workbench – ショットグリッドを使い、シーン配置・カメラ運動設定・キーフレーム補完をリアルタイムでプレビューします。
- Export – ビデオをレンダリングし、すべてのフレームと MP4 を ZIP でダウンロード、あるいは編集パッケージへ直接コピーします。
Getting Started
1. Clone the Repo
git clone https://github.com/shuyu-labs/BigBanana-AI-Director.git
cd BigBanana-AI-Director
2. Install Dependencies
npm install
3. Configure Your API Key
ルートに .env ファイルを作成、または .env.example をコピーし、AntSK API キーを追加します。
ANTSK_API_KEY=your‑api‑key-here
4. Run Locally
npm run dev
http://localhost:3000 を開き、ストーリーの読み込み・アセット生成・最終ビデオプレビューを行います。
5. Docker Deployment (Recommended)
docker-compose up -d --build
http://localhost:3005 でサイトが利用可能です。必要に応じて docker-compose.yml のポート設定を変更してください。
6. Production Build
npm run build
npm run preview
Licensing & Commercial Use
CC BY‑NC‑SA 4.0 ライセンスで公開されています。
- 許可:個人学習、研究、非営利プロジェクト
- 禁止:別途ライセンス取得なしに商用利用
- 対策:商用利用を希望される場合は
[email protected]までご連絡ください。
Why AntSK API?
プラットフォームは AntSK のエコシステムと深く結びついており、以下のメリットを提供します。
- クロスモデル互換性(GPT‑5.x、Gemini‑3、Sora 2、Veo 3.1)
- 低レイテンシ、高スループット
- コスト効果(フラッグシップ料金の 80% 以下)
- ダッシュボードでのリアルタイム使用量監視
このシナジーにより、テキスト解析・画像プロンプト生成・動画補間といった各フェーズで最適なモデルを追加設定なしに自動選択可能です。
Community & Extending
- オープンソース:フォーク、Issue 提出、Pull Request いつでも歓迎
- ロードマップ:マルチランゲージサポート、カスタムレンダーバックエンド用プラグイン、モバイルファースト設計向け UI 改善等を予定
- 貢献ガイド:リポジトリ内の
CONTRIBUTING.mdをご確認ください
Bottom Line
BigBanana AI Director は AI 主導のメディア制作の次世代ツールです。スクリプト・アセット・撮影・最終レンダリングを一つのプラットフォームで担い、個人クリエイター、中小スタジオ、開発者の AI アニメーションパイプライン構築を高速に実現します。Docker イメージと軽量フロントエンドで、すぐに稼働可能です。リポジトリをフォークし、AntSK キーを入力して数分でフル長のアニメーション短編ドラマを生成してみてください。
AI 主導の短編を作りたい方は、GitHubリポジトリ をチェックするか、Docker コンテナにコードを投入して即時デプロイしてください。