# AI Subtitle (AIテロップ自動生成ツール) 仕様書 本書は、StreamlitとOpenAI Whisperを用いたAI文字起こし・字幕生成アプリケーションの仕様をまとめたものです。 ## 1. アプリケーション概要 動画や音声ファイルをアップロードすることで、AIが自動的に文字起こしを行い、字幕ファイル（SRT / ASS）を生成するツールです。用途に合わせて「Free版（無料体験用）」と「Pro版（高機能・無制限版）」の2つが用意されています。 --- ## 2. システム構成・環境 - **言語/フレームワーク:** Python 3.13 / Streamlit - **AIモデル:** OpenAI Whisper (ローカル実行, GPU対応可) - **メディア処理:** FFmpeg (動画/音声フォーマット変換・情報の取得) - **認証システム (Pro版のみ):** Supabase Auth (OTPログイン) - **パッケージ化:** PyInstaller (exe化用 `build_pro.bat`) --- ## 3. エディション別 機能比較表 機能・制限 | Free版 (`subtitle_app_free.py`) | Pro版 (`subtitle_app.py`) --- | --- | --- **対象ユーザー** | お試し利用、リード獲得 | 有料購入者 **動画の長さ制限** | 最大 **5分 (300秒)** まで | **無制限** **ファイルサイズ制限** | 最大 **100MB** まで | **2GB** (実質無制限) **利用可能なAIモデル** | `tiny`, `base` のみ | `tiny`, `base`, `smart(small)`, `Pro(medium)` **出力可能な字幕形式** | SRT形式 のみ | SRT形式, **ASS形式** **フォント/スタイル編集** | 不可 | 可能 (色, サイズ, マージン設定可) **ユーザー認証** | なし (誰でもアクセス可) | **あり (Supabase Authによるログイン必須)** **透かし (ウォーターマーク)** | **画面全体(UI) と 出力されたSRTの最初の5秒間に強制追加** | なし **GitHubへの公開** | 公開済み (`oyajibuki/subtitle-ai-free`) | 非公開 (`.gitignore`で除外設定済) --- ## 4. ユーザー認証機能の仕様 (Pro版のみ) Pro版は無断コピーや不正利用を防ぐため、Supabaseを利用した独自の認証システム (`auth_manager.py`) を実装しています。 ### 認証・ログインフロー 1. **新規登録 (Sign Up):** - ユーザーは任意のメールアドレスでアカウントを作成可能。 - 登録後、**安全でランダムな初期パスワードが自動生成**され、画面上に一度だけ表示される（ユーザー自身でメモする必要あり）。 - 「Confirm email（メール確認）」は不要で、即座にログインが可能。 2. **ログイン (Login):** - 登録したメールアドレスとパスワードでログイン。 - 「ログイン状態を保持する（Remember Me）」機能により、次回以降はパスワード入力を省略できる（ローカルのキャッシュファイルに保存）。 3. **パスワードリセット (OTP方式):** - パスワードを忘れた場合、登録したメールアドレスに「6桁の認証コード（OTP）」を送信。 - 送られてきたOTPをアプリ内で入力すると、パスワードリセットが承認される。 - 承認と同時に、**新しいランダムパスワードが再度自動生成・適用**され、ユーザーに通知される。 --- ## 5. Free版の特殊仕様 (販促・流出対策) 無償公開されるFree版 (`subtitle_app_free.py`) においては、Pro版への誘導を最大化するために以下の制約を意図的に設けています。 1. **強制ウォーターマーク（UI）:** - CSSを使用して、画面全体に斜めで `[Created by AI Subtitle Free]` という透かし文字を配置（コピー防止）。 2. **強制ウォーターマーク（出力データ）:** - ユーザーが作成したSRTファイルをダウンロードする際、動画の **0:00:00 〜 0:00:05 の区間に必ず `[Created by AI Subtitle Free]` という字幕が挿入** される。 3. **表示デザイン:** - セッション開始時に、Google Apps Script (GAS) 経由で訪問者カウンター (Visitor) が作動・表示される。 - トップ画面の目立つ位置に「[Pro版へのお問い合わせはこちら]」のリンクを設置。 --- ## 6. コマンド・ビルド仕様 アプリケーションの起動およびパッケージ化には、用意されたバッチファイルを使用します。 ### 開発・検証用 起動コマンド - **Free版の起動:** `start_free.bat` - 内部コマンド: `py -3.13 -m streamlit run subtitle_app_free.py --server.maxUploadSize=100` - **Pro版の起動:** `start_pro.bat` - 内部コマンド: `py -3.13 -m streamlit run subtitle_app.py --server.maxUploadSize=2000` ### Pro版のEXE化（ビルド）コマンド - **実行ファイル:** `build_pro.bat` - PyInstallerを用いて `subtitle_app.py` などの依存ファイルをすべて1つのディレクトリ(`dist\AI_Subtitle_Pro`)にまとめる。 - プロセス中に `ffmpeg.exe` や Streamlit固有のフォルダなどを手動でコピーする手順が組み込まれている。 --- ## 7. 免責事項・留意事項 (購入者・ユーザー向け案内事項) 本アプリケーションを提供するにあたり、あらかじめ以下の点についてユーザー（または購入者）に明示する必要があります。 1. **処理時間およびパフォーマンスのPCスペック依存について** - 本ツールの「起動にかかる時間」や「文字起こしにかかる時間」は、ご利用のPCスペック（CPU、メモリ、GPU等）に大きく依存します。 - 動画の再生時間と文字起こしにかかる時間はイコールではありません。ハイスペックなPC環境（GPU搭載推奨）では高速に処理が完了しますが、一般的なノートPCや古いPCでは、動画の長さと同等、あるいはそれ以上の処理時間がかかる場合があります。 2. **外部ライブラリ・APIへの依存と将来の仕様変更について** - 本ツールは、AI文字起こしエンジンとして「OpenAI Whisper」、UIフレームワークとして「Streamlit」などの無料かつオープンな外部ライブラリを利用して構築されています。 - 万が一、これらの提供元がサービスを終了した場合、またはライセンス形態を変更（完全有料化・商用利用の禁止など）した場合には、本ツールの一部または全ての機能が利用できなくなる可能性があります。 - 外部要因による仕様変更、機能停止、またはそれに伴う損害について、開発者（提供者）はいかなる補償・返金も行えないものとします（ノークレーム・ノーリターンを前提とした提供となります）。 無料体験版 https://subtitle-ai-free-aen8v76jncxmxzrwxqdumz.streamlit.app/ 業務改善ツール https://oyajibuki.github.io/tools/