generate-youtube-thumbnail

YouTube サムネイルを生成する

Arcads の Nano Banana 2 画像エンドポイントを使い、キャラクターの顔立ちを適切に再現し、実証済みの CTR の法則を活用して YouTube サムネイルを作成する、再利用可能なワークフローです。

このスキルを使う場面

次のようなフレーズをきっかけに実行します。

• 「YouTube のサムネイルを作って」
• 「この動画のサムネイルを作成して」
• 「サムネイルのバリエーション／A/B テストが必要です」
• 「自分の顔を使って、このサムネイルを作り直して」
• 「サムネイルのコンセプトを 10 個生成して」
• 「［自分／自分の製品／自分のブランド］を使ったサムネイル」

読む順番

1. このファイル — ワークフロー、判断ツリー、バッチ生成
2. shared/skills/generate-youtube-thumbnail/prompting/guide.md — 顔立ちの一致、表情の早見表、プロンプトの構成（このポートフォリオ内のすべての生成 AI API で共通）
3. shared/skills/generate-youtube-thumbnail/prompting/formulas.md — 実証済みのサムネイルの法則 5 種とテンプレート（共通）
4. scripts/generate-batch.sh — Arcads 専用のバッチスクリプト（署名付きアップロード＋S3 PUT パイプライン）

前提条件

• ARCADS_BASIC_AUTH と ARCADS_API_KEY が設定された .env
• productId（既定では MASTER_CONTEXT.md の「My workspace」製品）
• ディスク上の参照画像（チャットに貼り付けた画像は API からアクセスできません）：
  • face/ — 被写体の写真 5 枚以上（ヘッドショット＋3/4 アングル＋クローズアップ＋表情）
  • logos/ — ブランドロゴのファイル（オレンジ色の Claude Code のスターバースト、黒い Arcads の A など）
  • products/ — 背景がすっきりした製品写真
  • examples/ — 実際の広告のスクリーンショット、比較素材
  • style/ — ユーザーが見た目を参考にしたいサムネイルの例

参照素材がない場合、またはユーザーが画像を保存せずにチャットに貼り付けた場合は、処理を中断し、実際のファイルをプロジェクトフォルダー（例：references/youtube thumbnail/）に置くようユーザーに依頼してください。チャットへの貼り付けは、ディスク上のファイルと同じではありません。

ワークフロー

1. 要件を確認する（順番に）

不足している情報をユーザーに尋ねますが、本当に必要なものだけを確認してください。

1. コンセプト — 動画の内容は何ですか？単一のコンセプト、A/B バリエーション、既存のサムネイルスタイルの再現のいずれですか？
2. 被写体 — サムネイルに登場するのは誰ですか（ユーザー本人、AI キャラクター、人なし）？
3. ブランド素材 — どのロゴ／製品／ブランドカラーを使いますか？
4. テキスト — タイトルにはどのような文言を入れますか？テキストを画像に含めますか、それとも後から（Canva／Photoshop で）追加しますか？
5. 比較素材 — 「実写 vs AI」のサムネイルの場合、どの実際の広告と、どの AI 生成広告を使いますか？

2. 参照素材がディスク上にあることを確認する

ls "references/youtube thumbnail/"

参照素材がない場合は、ユーザーに用意するよう依頼してください。ブランド固有のアイテム（ロゴ、ブランド製品、ブランドのアパレル）について、テキストだけの説明で進めてはいけません。ブランドと一致しない一般的な AI 生成画像になってしまいます。背景、表情、衣服には一般的な説明を使ってもかまいません。

3. コストを見積もって確認する

生成を開始する前に、必ずコストを見積もりとして提示してください。

「推定コスト：N 個のバリエーション × 24 クレジット = X クレジットです。事前に Arcads プラットフォームで正確な料金を確認したい場合はお知らせください。」

4. 法則を選ぶ

実証済みの法則 5 種については、shared/skills/generate-youtube-thumbnail/prompting/formulas.md を参照してください。ユーザーの意図に合わせて選びます。

ユーザーの発言...	使用する法則
「自分と自分のブランドだけ」／「ブランディング用サムネイル」	ピースサイン／ブランディング
「実写 vs AI」／「比較」／「ビフォー／アフター」	実写 vs AI の比較
「制作過程を見せて」／「ターミナルと一緒に」	ターミナルのフロー
「驚いた顔」／「ショックを受けたリアクション」	驚きのリアクション
「置き換え」／「代替」／「差し替え」	ビフォー／アフターの分割

5. プロンプトを作成する

shared/skills/generate-youtube-thumbnail/prompting/guide.md のテンプレートに従います。

YouTube thumbnail, 16:9 landscape.
[SUBJECT — likeness block + clothing + framing + "no hands" if applicable]
Expression: [specific expression from expressions cheat sheet]
[LEFT visual element + reference]
[RIGHT visual element + reference]
Across the top in massive bold yellow block letters with thick black outline reads [TITLE].
Background: [color + glow]
Style: [aesthetic notes]
Avoid: distorted face, extra fingers, hands visible, blurry logos, generic face

被写体が実在の人物の場合は、CRITICAL CHARACTER LIKENESS ブロックを必ず含めてください。shared/skills/generate-youtube-thumbnail/prompting/guide.md を参照してください。

6. 生成する（バッチスクリプトを使用）

scripts/generate-batch.sh を新しいバージョン付きスクリプト（scripts/generate-thumbnails-vN.sh）にコピーし、次の項目を変更します。

1. REF_BASE と COMMON_REFS 配列を、参照ファイルのパスに更新します
2. PROMPTS 配列の各項目を、作成したプロンプトに置き換えます
3. bash scripts/generate-thumbnails-vN.sh > output/run.log 2>&1 & を実行します
4. tail -F output/run.log | grep -E "DONE|FAILED|Asset" で進行状況を確認します

スクリプトは次の処理を行います。

• 画像のアップスケーリング（Lanczos で長辺を 1080px にし、RGB JPEG に変換）
• 署名付きアップロードと S3 PUT
• 生成ごとに新規アップロード（重要 — filePaths を再利用すると 500 エラーが発生します）
• 並列実行（同時に 10 件で、合計約 1.5 分）
• 失敗時の再試行
• アセットのポーリングとダウンロード

7. 確認して提示する

すべての生成が完了したら、Read ツールで各サムネイルを読み込み、次の内容を提示します。

• サムネイルごとの簡潔な評価（人物の再現度、読みやすさ、感情への訴求力）
• CTR の可能性が高い上位 3 件を順位付け
• 選んだ具体的な理由（表情、色のコントラスト、公式のどれが効果的か）
• 次の改善案（異なる表情、背景色、コピーのバリエーション）

8. 必須の開示事項

• クレジットの合計は必ず概算として示し、正確な料金は Arcads で確認するようユーザーに伝えてください
• 料金データ： Nano Banana 2 の画像生成は、1 回あたり 24 クレジット（2026 年 4 月以降の 800x クレジット倍率適用後）
• 生成時間： 通常約 30～60 秒
• 並列処理の目安： 10 件を並列実行すると、合計約 1.5～2 分で完了します

注意点と落とし穴

参照画像はアップロードごとに実質 1 回しか使えません

同じアップロード済みの filePath を複数の生成呼び出しで再利用すると、HTTP 500 UNKNOWN_ERROR が発生します。生成ごとに必ず参照画像を新しくアップロードしてください。 バッチスクリプトでは、generate_one() の呼び出しごとに upload_all_fresh() を実行して、この処理を自動化しています。

画像の前処理は必須です

長辺が 1080px 未満の画像は、422 — The provided image is too small. を返します。スキルの prepare_image() 関数は次の処理を行います。

1. 画像を開きます
2. RGB に変換します（一部のエンドポイントで問題になるアルファチャンネルを除去します）
3. 必要に応じて Lanczos リサンプリングで長辺を 1080px に拡大します
4. JPEG 品質 92 で保存します

referenceImages はプレーンな文字列の配列です

オブジェクトではありません。[{filePath: "..."}] を送信すると、400 — each value in referenceImages must be a string が返されます。代わりに ["external-api-temp-uploads/abc.jpg", ...] を送信してください。

チャットに貼り付けられた画像はファイルではありません

ユーザーが画像をチャットに直接貼り付けた場合、API に渡すことはできません。実際のファイルをプロジェクトフォルダーに保存するよう依頼してください。

参照画像が不足すると人物の再現性が低下します

顔の参照画像が 1～2 枚の場合、AI は「眼鏡をかけた、ひげのある一般的な男性」として描写しがちです。異なる角度から撮影した顔の参照画像が 5 枚以上あると、特定の人物としての特徴を捉えやすくなります。人物を扱う場合は、顔の参照画像を必ず 5 枚以上使用してください。

macOS の bash 3.2

macOS のデフォルトの bash は declare -A（連想配列）をサポートしていません。バッチスクリプトでは、インデックス付き配列と一時ファイルを使用しています。

古くなった署名付き URL

署名付き URL は expiresIn の期間（約 10 分）が過ぎると期限切れになります。長時間実行するジョブでは URL を再利用せず、新しくアップロードしてください。

ブランド固有のアイテムには実際の参照ファイルが必要です

ブランド固有のアイテム（ロゴ、ブランド入りのアパレル、カスタムグッズ）を文章で説明しても、一般的な見た目に近いものが生成されます。Mr. Paid Social の帽子は、文章だけでは「MR PAID SOCIAL」と表示されますが、実際のワッペンのタイポグラフィとは一致しません。ブランドをピクセル単位で正確に再現するには、実際のブランド素材をディスクに保存し、参照画像として渡してください。

コストの目安

操作	クレジット	備考
Nano Banana 2 の画像（1 回生成）	24	800x を超えた場合の倍率適用後
6 パターンのバッチ	144	初期の試作で一般的
10 パターンのバッチ	240	調整で一般的
20 パターンのバッチ	480	幅広いコンセプトの検討で一般的

常に概算として提示し、正確な数値は Arcads プラットフォームで確認してください。

関連項目

• shared/skills/generate-youtube-thumbnail/prompting/guide.md — 類似性の調整、表情、プロンプトの構成（すべての API で共通）
• shared/skills/generate-youtube-thumbnail/prompting/formulas.md — 実証済みの CTR フォーミュラ 5 種とプロンプトテンプレート（共通）
• scripts/generate-batch.sh — Arcads 専用の Bash バッチ生成スクリプト（署名付きアップロードパイプライン）
• arcads-external-api skill — Nano Banana 2 エンドポイントとリファレンスアップロードパイプラインの基盤となる API リファレンス