mcpField
G
generate-image

generate-image

github.com/leonchaoxクリエイティブ・メディア99071 回インストール15 週間前に更新
リポジトリ

generate-image について

Generate Imageは、OpenRouterの画像モデルで画像を生成・編集するスキルです。イラスト、写真、プレゼンテーション用素材などの作成に向けて、モデルと出力先を指定できます。

主な機能

  1. 01テキストプロンプトから画像を生成
  2. 02入力ファイルの画像を編集
  3. 03掲載されたOpenRouterモデルを選択
  4. 04出力先のパスを指定
  5. 05生成画像をPNGで保存

活用シーン

  1. 01論文用の概念イラストを作成
  2. 02プレゼンテーションの背景を用意
  3. 03既存画像に指定した変更を加える

インストール

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

$npx skills add https://github.com/leonchaox/qinyan-academic-skills --skill generate-image

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

同梱ファイルscripts/generate_image.py

詳細

画像を生成

FLUX.2 Pro や Gemini 3.1 Flash Image Preview など、OpenRouter の画像生成モデルを使って、高品質な画像を生成・編集します。

このスキルを使用する場面

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.1-flash-image-preview（高品質、おすすめ）

生成と編集に使用できるモデル：

  • google/gemini-3.1-flash-image-preview - 高品質。生成と編集に対応
  • black-forest-labs/flux.2-pro - 高速で高品質。生成と編集に対応

生成のみ：

  • black-forest-labs/flux.2-flex - 高速で低コストですが、pro ほど高品質ではありません

次の基準で選択してください：

  • 品質：gemini-3.1-flash-image-preview または flux.2-pro を使用します
  • 編集：gemini-3.1-flash-image-preview または 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.1-flash-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.1 Flash Image Preview と FLUX.2 Pro は、どちらも OpenRouter を通じた画像編集に対応しています

他のスキルとの連携

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

コメント

Markdown 対応