mcpField
G
generate-image

generate-image

github.com/davila7クリエイティブ・メディア33.0k1.4k 回インストール1 日前に更新
リポジトリ

generate-image について

generate-imageは、OpenRouterのモデルで画像を生成・編集するスキルです。写真やイラストなどのビジュアル制作向けに、モデル選択や入出力パス指定ができるPythonスクリプトを提供します。

主な機能

  1. 01テキストプロンプトから画像を生成
  2. 02指示に沿って画像を編集
  3. 03OpenRouterモデルの選択
  4. 04入出力パスの指定
  5. 05結果をPNG形式で保存

活用シーン

  1. 01プレゼンや文書用の画像作成
  2. 02コンセプトアートやイラスト制作
  3. 03既存の写真や画像の編集

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/davila7/claude-code-templates --skill generate-image

インストール後、Claude Code で/generate-imageを入力して読み込まれたか確認します。

同梱ファイルscripts/generate_image.py

詳細

Generate Image

OpenRouter の画像生成モデル（FLUX.2 Pro や Gemini 3 Pro を含む）を使って、高品質な画像を生成・編集します。

このスキルを使うタイミング

generate-image を使う場合:

  • 写真やフォトリアルな画像
  • アートイラストや芸術作品
  • コンセプトアートやビジュアルコンセプト
  • プレゼンテーションや文書向けのビジュアルアセット
  • 画像の編集や修正
  • その他の汎用的な画像生成ニーズ

代わりに scientific-schematics を使う場合:

  • フローチャートやプロセス図
  • 回路図や電気回路図
  • 生物学的経路やシグナル伝達カスケード
  • システムアーキテクチャ図
  • CONSORT 図や方法論のフローチャート
  • その他の技術的・スキーマ的な図

クイックスタート

scripts/generate_image.py スクリプトを使って画像を生成または編集します:

# Generate a new image
python scripts/generate_image.py "A beautiful sunset over mountains"

# Edit an existing image
python scripts/generate_image.py "Make the sky purple" --input photo.jpg

これにより画像が生成・編集され、現在のディレクトリに generated_image.png として保存されます。

API キーの設定

重要: このスクリプトには OpenRouter の API キーが必要です。実行前に、ユーザーが API キーを設定しているか確認してください:

  1. プロジェクトディレクトリまたは親ディレクトリにある .env ファイルを探します
  2. .env ファイル内に OPENROUTER_API_KEY=<key> があるか確認します
  3. 見つからない場合は、ユーザーに次の対応が必要であることを伝えます:
    • OPENROUTER_API_KEY=your-api-key-here と記載した .env ファイルを作成する
    • または環境変数を設定する: export OPENROUTER_API_KEY=your-api-key-here
    • API キーは https://openrouter.ai/keys で取得できます

スクリプトは .env ファイルを自動的に検出し、API キーがない場合は分かりやすいエラーメッセージを表示します。

モデルの選択

デフォルトモデル: google/gemini-3-pro-image-preview（高品質、推奨）

生成と編集に利用可能なモデル:

  • google/gemini-3-pro-image-preview - 高品質、生成と編集の両方に対応
  • black-forest-labs/flux.2-pro - 高速かつ高品質、生成と編集の両方に対応

生成のみ:

  • black-forest-labs/flux.2-flex - 高速で低コストだが、pro ほどの品質はない

選択の基準:

  • 品質: gemini-3-pro または flux.2-pro を使用
  • 編集: gemini-3-pro または flux.2-pro を使用（どちらも画像編集に対応）
  • コスト: 生成のみであれば flux.2-flex を使用

一般的な使用パターン

基本的な生成
python scripts/generate_image.py "Your prompt here"
モデルの指定
python scripts/generate_image.py "A cat in space" --model "black-forest-labs/flux.2-pro"
出力パスのカスタマイズ
python scripts/generate_image.py "Abstract art" --output artwork.png
既存の画像を編集
python scripts/generate_image.py "Make the background blue" --input photo.jpg
特定のモデルで編集
python scripts/generate_image.py "Add sunglasses to the person" --input portrait.png --model "black-forest-labs/flux.2-pro"
出力先を指定して編集
python scripts/generate_image.py "Remove the text from the image" --input screenshot.png --output cleaned.png
複数の画像

異なるプロンプトや出力パスを指定して、スクリプトを複数回実行します:

python scripts/generate_image.py "Image 1 description" --output image1.png
python scripts/generate_image.py "Image 2 description" --output image2.png

スクリプトのパラメーター

  • prompt（必須）: 生成する画像の説明、または編集の指示テキスト
  • --input または -i: 編集する入力画像のパス（編集モードを有効にします）
  • --model または -m: OpenRouter のモデル ID（デフォルト: google/gemini-3-pro-image-preview）
  • --output または -o: 出力ファイルのパス（デフォルト: generated_image.png）
  • --api-key: OpenRouter の API キー（.env ファイルより優先されます）

使用例

科学文書向け
# Generate a conceptual illustration for a paper
python scripts/generate_image.py "Microscopic view of cancer cells being attacked by immunotherapy agents, scientific illustration style" --output figures/immunotherapy_concept.png

# Create a visual for a presentation
python scripts/generate_image.py "DNA double helix structure with highlighted mutation site, modern scientific visualization" --output slides/dna_mutation.png
プレゼンテーションやポスター向け
# Title slide background
python scripts/generate_image.py "Abstract blue and white background with subtle molecular patterns, professional presentation style" --output slides/background.png

# Poster hero image
python scripts/generate_image.py "Laboratory setting with modern equipment, photorealistic, well-lit" --output poster/hero.png
一般的なビジュアルコンテンツ向け
# Website or documentation images
python scripts/generate_image.py "Professional team collaboration around a digital whiteboard, modern office" --output docs/team_collaboration.png

# Marketing materials
python scripts/generate_image.py "Futuristic AI brain concept with glowing neural networks" --output marketing/ai_concept.png

エラー処理

スクリプトは次のような場合に分かりやすいエラーメッセージを表示します:

  • API キーの欠落（設定手順付き）
  • API エラー（ステータスコード付き）
  • 予期しないレスポンス形式
  • 依存関係の欠落（requests ライブラリ）

スクリプトが失敗した場合は、エラーメッセージを確認して問題を解決してから再試行してください。

注意事項

  • 画像は base64 エンコードされたデータ URL として返され、自動的に PNG ファイルとして保存されます
  • スクリプトは、異なる OpenRouter モデルからの images 形式と content 形式の両方のレスポンスに対応しています
  • 生成時間はモデルによって異なります（通常 5〜30 秒）
  • 画像編集の場合、入力画像は base64 でエンコードされてモデルに送信されます
  • 対応している入力画像形式: PNG、JPEG、GIF、WebP
  • 料金情報は OpenRouter の料金ページを確認してください: https://openrouter.ai/models

画像編集のヒント

  • 変更したい内容を具体的に指定してください（例：「空を夕焼けの色に変更」と「空を編集」）
  • 可能な場合は、画像内の具体的な要素を指定してください
  • 最良の結果を得るには、明確で詳細な編集指示を使用してください
  • Gemini 3 Pro と FLUX.2 Pro はどちらも、OpenRouter を通じた画像編集に対応しています

他のスキルとの連携

  • scientific-schematics: 技術的な図、フローチャート、回路、経路の作成に使用します
  • generate-image: 写真、イラスト、アートワーク、ビジュアルコンセプトの作成に使用します
  • scientific-slides: generate-image と組み合わせて、視覚的に豊かなプレゼンテーションを作成します
  • latex-posters: ポスターのビジュアルやヒーロー画像の作成に generate-image を使用します

コメント

Markdown 対応