Communitygithub.com

Newdvn2025/topic-to-published-video

AutoDL Art API を使用してB-roll動画を生成、継続生成、ダウンロードします。テキスト、参照画像、最初と最後のフレーム入力をサポートします。ユーザーが許可した動画素材生成タスク向け。

topic-to-published-video とは?

このスキルは、AutoDL Art API を活用してB-roll(補助映像)を効率的に生成・管理するためのツールです。テキスト説明、参照画像、開始フレームと終了フレームの指定による動画生成をサポートし、口動画とB-rollを組み合わせたコンテンツ制作フローに最適化されています。 主な特徴として、APIキーは環境変数 `AUTODL_ART_TOKEN` または設定ファイルから安全に読み込まれ、チャットやマニフェストファイルにキーを記載する必要はありません。`--prepare-only` フラグで事前チェックとリクエストボディの保存を行い、ユーザー承認後に実際のAPIコールを実行する2段階のワークフローを採用。タスクIDは自動保存され、同じ出力ディレクトリで再実行すると中断されたタスクを継続できるため、コストの無駄を防ぎます。 対応する生成ワークフローは3種類:テキストのみ(`minimax_h3_lightx2v_no_pic`、デフォルト4〜5秒、768p横)、参照画像あり(`minimax_h3_z0902`)、開始/終了フレーム指定(`minimax_h3_b99_002`)があります。解像度はワークフローごとに固定値を使用する必要があり、混在はできません。APIの利用可否や価格はアカウント状況に依存するため、事前確認が推奨されます。 このスキルは主にClaude CodeやAIエージェント環境での使用を想定しており、Python 3.10以上で動作し、追加のサードパーティ依存関係は不要です。マニフェストファイルの例やプロンプトガイドも同梱されており、初めてのユーザーでも容易に開始できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Newdvn2025/topic-to-published-video/tree/HEAD/addons/autodl-broll

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

AutoDL B-roll

まず、実際の口動画、素材の不足状況、ユーザー予算を確認し、マニフェストを生成します。ユーザーが計画段階では送信しないでください。デフォルトのテキスト生成ワークフローは minimax_h3_lightx2v_no_pic、4〜5秒、768p横です。動作デモはユーザーの要求に応じて延長可能です。生成される画角は正確な16:9ではない場合があり、ダウンロード後に実際のサイズを確認し、プロジェクト要件に合わせて派生させ、元の動画は保持します。

設定と実行

Python 3.10以上、サードパーティのPython依存関係は不要です。環境変数 AUTODL_ART_TOKEN を最優先で読み取り、次にユーザー設定ディレクトリの topic-to-published-video/autodl.env を読み取ります。--env-file で別のファイルを指定可能です。環境変数が優先されます。APIキーをチャット、コマンド引数、マニフェスト、ステータスファイルに記載しないでください。

参照画像の相対パスはマニフェストディレクトリから解決します。ローカル画像はdata URLに変換します。

python3 scripts/autodl_broll.py manifest.json --prepare-only --output-dir output

このコマンドはリクエストボディの検証と保存のみを行い、APIは呼び出しません。ユーザー承認後:

python3 scripts/autodl_broll.py manifest.json --output-dir output

タスクIDは即座に保存され、同じ出力ディレクトリで再実行すると、記録されたタスクを継続し、新たに課金して送信することはありません。失敗したタスクは自動リトライされません。追加生成には新しいIDと新しい出力ディレクトリを使用し、対応する予算承認を取得します。同一IDで既に送信したリクエストの内容を変更しないでください。

ワークフローと検収

テキスト:minimax_h3_lightx2v_no_pic。参照画像:minimax_h3_z0902、少なくとも ref_image_0 が必要。開始/終了フレーム:minimax_h3_b99_002、first_frame と last_frame は必須。その他のワークフローと正確な列挙については API説明 を参照してください。異なるワークフロー間で resolution 値を混在させることはできません。

APIの利用可否と価格は現在のアカウントとサービスに依存します。固定単価や他サービスより常に安いことを保証するものではありません。リクエストがSUCCESSを返した後でも、空でないファイル、パラメータ、完全な動作を確認してください。フローディレクターが意味的な検収を担当します。

プロンプトを構築する必要がある場合は プロンプトガイド を読み、開始時には テキスト例 または 開始/終了フレーム例 をコピーしてください。

関連スキル