CapCutAPI: CapCutビデオクリップの自動制御用オープンソースツール

CapCutAPIはGitHubでホストされているオープンソースプロジェクトで、開発者のsun-guannanによって作成されました。Python開発に基づいており、動画編集のコードを通してCapCut（カット画像）の制御を自動化するように設計されています。ユーザーは、下書きの作成、クリップの追加、エフェクトの適用、字幕の生成などの機能を含むスクリプトを記述することにより、ビデオ編集を自動化することができます。このツールは、動画をバッチ処理する必要がある開発者やコンテンツ制作者、または効率的な編集を探している人に適しています。CapCutAPIの中心的な目標は、ビデオ編集プロセスを簡素化し、手動操作の時間を短縮し、クリエイティブな効率を向上させることです。

機能一覧

• 下書きビデオクリップの自動作成と、プロジェクトの迅速な初期化をサポート。
• ビデオ、写真、オーディオ、その他多くの素材の追加をサポート。
• ビデオエフェクトやトランジションの自動化アプリケーションを提供。
• 統合されたAIサービス、自動字幕生成、多言語サポート。
• 動画のバッチ処理に対応し、大規模なコンテンツ制作に適しています。
• ユーザーが編集ロジックをカスタマイズできるように、スクリプト化されたコントロールを提供する。
• プロのニーズを満たすために、ウォーターマークフリーのビデオのエクスポートをサポートします。

ヘルプの使用

CapCutAPIはPythonベースのオープンソースツールで、コードを通してCapCut（クリッピング）を制御することで、ユーザーがビデオ編集を自動化できるように設計されています。下記は、ユーザーがすぐに使い始められるように、インストールと使用方法の詳細ガイドです。

設置プロセス

1. 環境準備
   お使いのコンピューターにPython 3.8以上がインストールされていることを確認してください。Pythonのバージョンは以下のコマンドで確認できます：

   python --version
   

   Pythonがインストールされていない場合は パイソン公式サイト ダウンロードしてインストールする。

2. クローンプロジェクト
   CapCutAPIはGitHubでホストされている。Gitを使ってプロジェクトをローカルにクローンする必要がある。ターミナルを開き、以下のコマンドを実行する：

   git clone https://github.com/sun-guannan/CapCutAPI.git
   

   Gitがインストールされていない場合は、以下から入手できる。 ギットのウェブサイト ダウンロード

3. 依存関係のインストール
   プロジェクト・カタログにアクセスする：

   cd CapCutAPI
   

   プロジェクトの依存関係は requirements.txt ファイルをインストールする。依存関係をインストールする：

   pip install -r requirements.txt
   

   ネットワーク接続が機能していること、依存関係に以下のような一般的なPythonライブラリが含まれていることを確認してください。 requests 歌で応える pydub.

4. CapCutの設定
   CapCutAPIは、インストールされたCapCutソフトウェアで動作するために必要です。お使いのコンピュータまたはデバイスに、最新バージョンのCapCutがインストールされていることをご確認ください。 キャップカット公式サイト (ダウンロード）。一部の機能にはCapCut Professionalが必要な場合があります。お使いのCapCutのバージョンがAPIコールをサポートしているかどうかを確認することをお勧めします。
5. 環境変数の設定
   AI字幕生成など、一部の機能を設定するにはAPIキーが必要です。キーを環境変数またはプロジェクト設定ファイルに保存してください。 config.json をプロジェクト・ルート・ディレクトリに追加してください。の設定方法の詳細については、プロジェクト・ルート・ディレクトリを参照してください。 README.md ドキュメンテーション

使用方法

CapCutAPIの中核は、PythonスクリプトによってCapCutの編集機能を制御することです。以下に主な機能の詳細な流れを示します。

ビデオ草稿の作成

うごきだす create_draft.py このスクリプトは、新しいCapCutプロジェクトのドラフトを作成します。サンプルコード：

from capcut_api import CapCutAPI
api = CapCutAPI()
draft_id = api.create_draft(project_name="MyVideo")
print(f"Created draft with ID: {draft_id}")

• 一度実行されると、CapCutは自動的に新しいプロジェクトのドラフトを生成し、その後の操作に使用されるIDが付きます。
• CapCutソフトウェアがオンになっていることを確認してください。そうでない場合、APIコールに失敗する可能性があります。

材料の追加

CapCutAPIは、ビデオ、イメージ、オーディオクリップの追加をサポートします。サンプルコードです：

api.add_material(draft_id, material_type="video", file_path="path/to/video.mp4")
api.add_material(draft_id, material_type="audio", file_path="path/to/audio.mp3")

• material_type アジュバント "video"そして"image" 歌で応える "audio".
• ファイル・パスはローカル・ファイルへの絶対パスである必要がある。
• クリップはタイムラインのデフォルトトラックに自動的に追加され、パラメータで位置を調整できます。

エフェクトとトランジションの適用

CapCutAPIを使用すると、特殊効果やトランジションを自動的に適用できます。例えば、フェードトランジションの追加など：

api.apply_transition(draft_id, transition_type="fade", duration=1.0)

• transition_type 以下のような様々なエフェクトがサポートされている。 "fade"そして"slide" など、一覧はドキュメントを参照のこと。
• duration このパラメータはトランジションの長さ（秒）を制御する。

字幕の自動生成

CapCutAPIは、AIサービスキーの設定を必要とするAI字幕生成を統合します。サンプルコード

api.generate_subtitles(draft_id, language="zh-CN", output_path="subtitles.srt")

• language パラメータは以下のような多言語に対応している。 "zh-CN"(中国語）、"en-US"(英語）。
• 生成された字幕ファイルは指定されたパスに保存されます。 .srt 歌で応える .vtt フォーマット
• キャプションの精度を高めるために、クリアなビデオ音声を推奨します。

ビデオの輸出

編集を終了した後、あなたは透かしなしでビデオをエクスポートすることができます：

api.export_video(draft_id, output_path="path/to/output.mp4", resolution="1080p")

• resolution アジュバント "720p"そして"1080p" など、CapCutのバージョンによって異なる。
• ビデオの長さによっては、書き出しに数分かかる場合があります。

ほら

• 文書参照プロジェクトのルート・ディレクトリの README.md 歌で応える examples/ このフォルダには詳細なサンプルコードが含まれているので、初めて使用する場合は注意深く読むことを推奨する。
• テスト中にコンポーネントを調整するスクリプトの実行時にエラーが発生した場合は、CapCutが起動しているか、ネットワーク接続が機能しているかを確認してください。
• 互換性CapCutAPIは、主にWindowsとmacOSプラットフォーム用のデスクトップ版CapCutをサポートしており、モバイルのサポートは限定的です。
• 地域支援質問がある場合は、GitHubにissueを提出するか、コミュニティ・ディスカッションをチェックしてください。

以上の手順で、ユーザーはすぐにCapCutAPIを使用してビデオ編集を自動化することができます。短い動画を一括生成する場合でも、複雑な編集作業を処理する場合でも、このツールは効率を大幅に向上させることができます。

アプリケーションシナリオ

1. 短編ビデオの量産
   CapCutAPIは、クリップの一括インポート、スクリプトによる字幕や特殊効果の追加、繰り返し操作の時間短縮など、複数の動画を自動生成することができます。
2. 教育用ビデオ制作
   CapCutAPIのAI字幕機能は、ビデオの魅力を高める特殊効果を備えた正確な字幕を自動的に生成します。
3. マーケティング・ビデオ・オートメーション
   CapCutAPIは、ブランド映像の迅速なインポートをサポートし、大規模なマーケティングキャンペーンのために統一されたエフェクトやトランジションを自動的に適用します。
4. パーソナル・プロジェクト・クリップ
   インディーズ開発者やビデオ愛好家は、CapCutAPIを使用してカスタムスクリプトを記述し、タイムラインを動的に調整したり、複数のクリップをバッチ処理するなど、複雑な編集ロジックを実装できます。

品質保証

1. CapCutAPIは有料ですか？
   CapCutAPIはGitHubでホストされている無料のオープンソースプロジェクトです。ただし、一部の機能（AI字幕など）は、サービスプロバイダーによっては、CapCut ProまたはサードパーティのAIサービスキーが必要な場合があります。
2. CapCutはモバイルに対応していますか？
   現在、CapCutAPIは主にデスクトップ版CapCut（WindowsおよびmacOS）をサポートしています。モバイルのサポートは限られているため、最新の互換性情報については公式ドキュメントを確認することをお勧めします。
3. APIコールの失敗を解決するには？
   CapCutソフトウェアが起動していることを確認し、ネットワーク接続とAPIキーの設定を確認してください。それでも失敗する場合は、GitHubのプロジェクトページにエラーログを添えてissueを送信してください。
4. ウォーターマークのないビデオをエクスポートできますか？
   はい、CapCutAPIは透かしのないビデオのエクスポートをサポートしていますが、CapCut Proを使用しているか、透かしのないエクスポートの条件を満たしていることを確認してください。