content-generation

コンテンツ生成

概要

AI 搭載ツールを使用して、画像、図、ドキュメント、要約などのプロフェッショナルなコンテンツを生成します。

クイック判断ツリー

What do you need?
│
├── Generate images
│   └── references/images.md
│   └── Script: scripts/generate_images.py
│
├── Create flowchart/diagram
│   └── references/flowchart.md
│   └── Script: scripts/generate_flowchart.py
│
├── Create Google Doc
│   └── references/document.md
│   └── Script: scripts/generate_document.py
│
├── Generate client proposal
│   └── references/proposal.md
│   └── Script: scripts/generate_proposal.py
│
├── Convert Markdown to PDF
│   └── references/pdf.md
│   └── Script: scripts/md_to_pdf.py
│
└── Summarize content
    └── references/summarize.md
    └── Script: scripts/summarize_content.py

環境設定

# Required in .env
FAL_API_KEY=fal_xxxx              # For image generation
OPENROUTER_API_KEY=sk-or-v1-xxx   # For AI text generation

API キーを取得します：

• fal.ai：https://fal.ai/dashboard/keys
• OpenRouter：https://openrouter.ai/keys

一般的な使い方

画像を生成する

# Nano Banana Pro (best quality)
python scripts/generate_images.py "Professional product photo of smartwatch" --model nano-banana-pro

# FLUX-2 (fast, cheap)
python scripts/generate_images.py "Vibrant lifestyle photo" --model flux-2 --size landscape_4_3

フローチャートを作成する

python scripts/generate_flowchart.py "User login: enter email, validate, check password, if correct go to dashboard"

ドキュメントを生成する

python scripts/generate_document.py --input content.json --title "Q4 Report"

提案書を生成する

python scripts/generate_proposal.py --transcript-file meeting.txt --client "Acme Corp"

コストの目安

ツール	コスト
Nano Banana Pro 1K	$0.15/画像
Nano Banana Pro 4K	$0.30/画像
FLUX-2	$0.012/メガピクセル
フローチャート	約$0.005/図
提案書	約$0.10/ドキュメント

セキュリティに関する注意事項

認証情報の取り扱い

• FAL_API_KEY は .env ファイルに保存してください（Git にコミットしないでください）
• OPENROUTER_API_KEY は .env ファイルに保存してください（Git にコミットしないでください）
• 漏えいした場合は、それぞれのダッシュボードからキーを再生成してください
• スクリプトの出力に API キーを記録したり表示したりしないでください

データのプライバシー

• テキストプロンプトは fal.ai と OpenRouter のサーバーに送信されます
• 生成された画像は .tmp/ ディレクトリにローカル保存されます
• AI サービスはサービス改善のためにプロンプトをログに記録する場合があります
• プロンプトに機密情報や秘密情報を含めないでください
• 生成されたドキュメントは Google Drive にアップロードされる場合があります

アクセス範囲

• FAL_API_KEY - 画像生成モデルへのフルアクセス
• OPENROUTER_API_KEY - 設定済みの AI モデルへのアクセス
• Google OAuth - Google Docs の作成に必要です（google-workspace スキルを参照）

コンプライアンスに関する考慮事項

• AI による生成の開示：必要に応じて、AI が生成したコンテンツであることを開示してください
• 画像の権利：生成された画像には fal.ai の利用規約が適用されます
• 著作権：AI が生成したコンテンツの著作権の扱いは、管轄区域によって異なります
• ブランドの一貫性：AI の出力がブランドガイドラインに沿っているか確認してください
• センシティブなコンテンツ：AI 画像生成ツールにはコンテンツポリシーがあります
• クライアント向け提案書：クライアントに送信する前に、内容の正確性を確認してください
• 帰属表示：状況によっては、AI による生成であることの開示が必要です

トラブルシューティング

よくある問題

問題：画像の生成に失敗する

症状： fal.ai がエラーを返す、または画像が生成されない 原因： プロンプトが無効、モデルが利用できない、または API に問題がある 解決方法：

• プロンプトにポリシー違反（露骨なコンテンツなど）がないか確認します
• モデル ID が正しく、利用可能であることを確認します
• API の接続をテストするため、より簡単なプロンプトを試します
• fal.ai のステータスページで障害が発生していないか確認します

問題：コンテンツポリシー違反

症状： 「Content policy violation」などの安全性に関するエラーが表示される 原因： プロンプトにフラグ対象の用語や概念が含まれている 解決方法：

• プロンプトから露骨、暴力的、または有害なコンテンツを取り除きます
• フィルターに引っかかる可能性のある曖昧な用語を言い換えます
• fal.ai のコンテンツポリシーのガイドラインを確認します
• より一般的でプロフェッショナルな表現を使用します

問題：Google ドキュメントが作成されない

症状： スクリプトは完了するが、ドキュメントが Drive に表示されない 原因： OAuth の問題、フォルダーの権限、または API エラー 解決方法：

• Google OAuth が機能していることを確認します（google-workspace スキルを参照）
• 保存先のフォルダーが存在し、アクセス可能であることを確認します
• mycreds.txt を削除して、再認証します
• スクリプトの出力にエラーメッセージがないか確認します

問題：フローチャートの構文エラー

症状： Mermaid 図のレンダリングに失敗する 原因： 生成された図の Mermaid 構文が無効 解決方法：

• 生成された Mermaid コードに構文エラーがないか確認します
• 複雑なフローを小さな図に分割します
• https://mermaid.live/ で図をテストします
• 特殊文字が正しくエスケープされていることを確認します

問題：PDF への変換に失敗する

症状： Markdown から PDF への変換中にエラーが発生する 原因： 依存関係が不足している、または Markdown が無効 解決方法：

• 必要な PDF ツール（weasyprint など）がインストールされていることを確認します
• Markdown の構文が有効であることを確認します
• カスタムフォントを指定している場合は、フォントファイルが存在することを確認します
• 問題を特定するため、より簡単な Markdown で試します

問題：OpenRouter API エラー

症状： テキスト生成が API エラーで失敗します 原因： API キーが無効、モデルを利用できない、またはレート制限に達しています 解決策：

• OPENROUTER_API_KEY が正しく設定されていることを確認します
• OpenRouter ダッシュボードでモデルの利用可否を確認します
• 現在のモデルを利用できない場合は、別のモデルを試します
• レート制限の状況を確認し、必要に応じて待機時間を追加します

リソース

• references/images.md - fal.ai の画像生成
• references/flowchart.md - Mermaid 図の生成
• references/document.md - Google Docs の作成
• references/proposal.md - クライアント向け提案書の生成
• references/pdf.md - Markdown から PDF への変換
• references/summarize.md - コンテンツの要約

統合パターン

生成して保存

スキル： content-generation → google-workspace 用途： ドキュメントを作成して Drive に保存します フロー：

1. コンテンツ（提案書、レポート、要約）を生成します
2. Google Doc または PDF として書式を整えます
3. google-workspace を使って適切な Drive フォルダーにアップロードします

提案書を CRM に登録

スキル： content-generation → attio-crm 用途： 生成した提案書を商談レコードに関連付けます フロー：

1. 会議の文字起こしからクライアント向け提案書を生成します
2. 提案書を Google Drive にアップロードします
3. 提案書へのリンクを添えて、Attio CRM の企業レコードにメモを追加します

画像を動画に追加

スキル： content-generation → video-production 用途： 動画コースのタイトルスライドを作成します フロー：

1. 各レッスン用のブランド入りタイトルスライド画像を生成します
2. 画像を動画対応形式でエクスポートします
3. video-production を使って、レッスン動画と結合します