Hugging Face Spaces対応のための修正を実施。アプリケーションの起動設定を環境に応じて自動選択し、エラーハンドリングを改善。Gradioのバージョンを更新し、OpenCVの依存関係をヘッドレス版に変更。デプロイガイドを追加し、環境変数設定方法を明記。

HUGGINGFACE_DEPLOY.md

@@ -0,0 +1,96 @@
+# Hugging Face Spacesへのデプロイガイド
+
+このドキュメントでは、Copa Video KlingをHugging Face Spacesにデプロイする方法を説明します。
+
+## 前提条件
+
+1. Hugging Faceアカウント
+2. UseAPI.netのアカウントとAPIキー
+3. （オプション）OpenAI APIキー
+
+## デプロイ手順
+
+### 1. Spaceの作成
+
+1. [Hugging Face Spaces](https://huggingface.co/spaces)にアクセス
+2. 「Create new Space」をクリック
+3. 以下の設定で作成：
+   - Space name: お好みの名前
+   - License: MIT
+   - Select the Space SDK: Gradio
+   - Gradio SDK version: 5.34.1
+   - Space hardware: CPU basic（無料プラン）
+
+### 2. コードのアップロード
+
+GitHubリポジトリからコードをアップロードするか、以下のファイルを手動でアップロード：
+
+- `app.py`
+- `requirements.txt`
+- `README.md`
+- `utils/` ディレクトリ全体
+  - `__init__.py`
+  - `kling_api.py`
+  - `openai_api.py`
+  - `video_processing.py`
+
+### 3. 環境変数の設定
+
+**重要**: APIキーは必ずSecrets経由で設定してください。
+
+1. Spaceの「Settings」タブを開く
+2. 「Repository secrets」セクションに移動
+3. 以下の環境変数を追加：
+
+```
+USEAPI_NET_TOKEN=your_useapi_net_token
+USEAPI_NET_EMAIL=your_email@example.com
+OPENAI_API_KEY=your_openai_api_key（オプション）
+```
+
+### 4. Spaceの再起動
+
+環境変数を設定後、Spaceを再起動してください：
+
+1. 「Settings」タブの「Restart this Space」ボタンをクリック
+2. 数分待つとアプリケーションが起動します
+
+## トラブルシューティング
+
+### アプリケーションが「Starting...」で止まる場合
+
+1. **ログを確認**：「Logs」タブでエラーメッセージを確認
+2. **環境変数の確認**：すべての必須環境変数が正しく設定されているか確認
+3. **依存関係の確認**：`requirements.txt`のパッケージが正しくインストールされているか確認
+
+### よくあるエラー
+
+#### 「APIが初期化されていません」
+
+- 環境変数が正しく設定されていることを確認
+- UseAPI.netのクレジットが残っているか確認
+
+#### ビルドエラー
+
+- `requirements.txt`のバージョンが正しいか確認
+- 特に`gradio==5.34.1`とREADME.mdの`sdk_version`が一致しているか確認
+
+### パフォーマンスの最適化
+
+無料のCPU Spaceでは処理に時間がかかる場合があります：
+
+1. **GPU Spaceへのアップグレード**を検討（有料）
+2. **動画の長さを短めに設定**（最初は0.5〜1分程度）
+3. **同時実行を避ける**（一度に1つのタスクのみ）
+
+## セキュリティに関する注意
+
+- APIキーは絶対にコードに直接記載しない
+- 必ずRepository secretsを使用する
+- 公開Spaceの場合、悪用を防ぐため使用制限を検討する
+
+## 追加リソース
+
+- [Hugging Face Spaces Documentation](https://huggingface.co/docs/hub/spaces)
+- [Gradio Documentation](https://www.gradio.app/docs)
+- [UseAPI.net Documentation](https://useapi.net/docs) 

app.py

@@ -24,10 +24,21 @@ def initialize_apis():
     
     errors = []
     
+    # Hugging Face Spaces環境かどうかを検出
+    is_huggingface_spaces = os.getenv("SPACE_ID") is not None
+    
     try:
         kling_api = KlingAPI()
     except Exception as e:
-        errors.append(f"Kling API: {str(e)}")
+        error_msg = f"Kling API: {str(e)}"
+        if is_huggingface_spaces:
+            error_msg += "\n\nHugging Face Spacesで環境変数を設定するには:\n"
+            error_msg += "1. Space設定ページの「Settings」タブを開く\n"
+            error_msg += "2. 「Repository secrets」セクションで以下を追加:\n"
+            error_msg += "   - USEAPI_NET_TOKEN\n"
+            error_msg += "   - USEAPI_NET_EMAIL\n"
+            error_msg += "3. Spaceを再起動する"
+        errors.append(error_msg)
         kling_api = None
     
     try:
@@ -683,17 +694,24 @@ if __name__ == "__main__":
     print("🚀 Kling AI Creative Toolkit 起動中...")
     print("="*50)
     
+    # 実行環境を検出
+    is_huggingface_spaces = os.getenv("SPACE_ID") is not None
+    if is_huggingface_spaces:
+        print(f"📍 実行環境: Hugging Face Spaces (Space ID: {os.getenv('SPACE_ID')})")
+    else:
+        print("📍 実行環境: ローカル")
+    
     # 環境変数の状態を確認
     env_status = []
-    if os.getenv('KLING_VIDEO_ACCESS_KEY'):
-        env_status.append("✅ KLING_VIDEO_ACCESS_KEY: 設定済み")
+    if os.getenv('USEAPI_NET_TOKEN'):
+        env_status.append("✅ USEAPI_NET_TOKEN: 設定済み")
     else:
-        env_status.append("❌ KLING_VIDEO_ACCESS_KEY: 未設定")
+        env_status.append("❌ USEAPI_NET_TOKEN: 未設定")
     
-    if os.getenv('KLING_VIDEO_SECRET_KEY'):
-        env_status.append("✅ KLING_VIDEO_SECRET_KEY: 設定済み")
+    if os.getenv('USEAPI_NET_EMAIL'):
+        env_status.append("✅ USEAPI_NET_EMAIL: 設定済み")
     else:
-        env_status.append("❌ KLING_VIDEO_SECRET_KEY: 未設定")
+        env_status.append("❌ USEAPI_NET_EMAIL: 未設定")
     
     if os.getenv('OPENAI_API_KEY'):
         env_status.append("✅ OPENAI_API_KEY: 設定済み（オプション）")
@@ -707,9 +725,11 @@ if __name__ == "__main__":
     # APIを初期化
     init_success, init_message = initialize_apis()
     print(f"\n{init_message}")
+    
+    # APIの初期化に失敗してもアプリは起動する
     if not init_success:
-        print("アプリケーションを終了します。環境変数を再確認してください。")
-        exit(1)
+        print("\n⚠️ 警告: APIの初期化に失敗しましたが、アプリケーションは起動します。")
+        print("環境変数を設定してからページをリロードしてください。")
     
     # UIを作成して起動
     app = create_ui()
@@ -717,12 +737,27 @@ if __name__ == "__main__":
     print("\n🌐 アプリケーションを起動しています...")
     print("="*50)
     
+    # Hugging Face Spaces環境かどうかを検出
+    is_huggingface_spaces = os.getenv("SPACE_ID") is not None
+    
     # 起動設定を調整
-    app.launch(
-        server_name="127.0.0.1",  # localhostに変更
-        server_port=7860,
-        share=False,
-        show_error=True,
-        quiet=False,  # ログを表示
-        inbrowser=True  # ブラウザを自動で開く
-    ) 
+    if is_huggingface_spaces:
+        # Hugging Face Spaces用の設定
+        app.launch(
+            server_port=7860,
+            share=False,
+            show_error=True,
+            quiet=False,
+            ssr_mode=False  # SSRモードを無効化
+        )
+    else:
+        # ローカル環境用の設定
+        app.launch(
+            server_name="127.0.0.1",
+            server_port=7860,
+            share=False,
+            show_error=True,
+            quiet=False,
+            inbrowser=True,
+            ssr_mode=False  # SSRモードを無効化
+        ) 

requirements.txt

@@ -11,11 +11,11 @@ httpx==0.25.0
 
 # 画像処理
 Pillow==10.3.0
-opencv-python==4.9.0.80
+opencv-python-headless==4.9.0.80
 numpy==1.26.4
 
 # Web UI
-gradio==4.31.5
+gradio==5.34.1
 
 # 環境変数管理
 python-dotenv==1.0.0 

作業履歴.md

@@ -1,5 +1,7 @@
 # 作業履歴
 
+このドキュメントは、`copa-video-kling`プロジェクトの開発作業履歴を記録しています。
+
 ## 実施内容
 1. **Kling AI直接API → UseAPI.net経由への変更**
    - JWT認証からBearer token認証に変更
@@ -127,4 +129,67 @@
    - 使用量の追跡
 3. **運用の最適化**:
    - v2-1モデルをデフォルトに設定
-   - エラーハンドリングの更新
+   - エラーハンドリングの更新
+
+## 2025-06-25: Hugging Face Spacesデプロイ問題の修正
+
+### 問題
+- Hugging Face Spacesでアプリケーションが「Starting...」で10分以上停止する
+- ログ: SSRモードで起動しようとしているが、環境変数未設定のメッセージが表示
+
+### 原因
+1. `app.launch()`の設定がローカル環境専用になっていた
+   - `server_name="127.0.0.1"` はHugging Face Spacesでは使用不可
+   - `inbrowser=True` はサーバー環境では無効
+   - SSRモードがデフォルトで有効
+
+2. Gradioバージョンの不一致
+   - README.md: `sdk_version: 5.34.1`
+   - requirements.txt: `gradio==4.31.5`
+
+3. OpenCVの依存関係
+   - ヘッドレス環境では`opencv-python-headless`が必要
+
+### 実施した修正
+
+#### 1. app.pyの修正
+```python
+# Hugging Face Spaces環境を検出して適切な設定を使用
+is_huggingface_spaces = os.getenv("SPACE_ID") is not None
+
+if is_huggingface_spaces:
+    app.launch(
+        server_port=7860,
+        share=False,
+        show_error=True,
+        quiet=False,
+        ssr_mode=False  # SSRモードを無効化
+    )
+else:
+    app.launch(
+        server_name="127.0.0.1",
+        server_port=7860,
+        share=False,
+        show_error=True,
+        quiet=False,
+        inbrowser=True,
+        ssr_mode=False
+    )
+```
+
+#### 2. requirements.txtの修正
+- `gradio==4.31.5` → `gradio==5.34.1`
+- `opencv-python` → `opencv-python-headless`
+
+#### 3. エラーハンドリングの改善
+- APIの初期化に失敗してもアプリケーションは起動するように変更
+- Hugging Face Spaces環境での環境変数設定方法を案内
+
+#### 4. デプロイガイドの作成
+- `HUGGINGFACE_DEPLOY.md`を作成
+- 環境変数の設定方法、トラブルシューティングなどを記載
+
+### 結果
+- Hugging Face Spacesでの起動問題を解決
+- 環境に応じた適切な設定を自動選択
+- より詳細なデバッグ情報の出力