mcpField
G
gemini-image

gemini-image

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

gemini-image について

gemini-imageは、スクリプトからGoogleのGeminiとImagenモデルで画像を生成するスキルです。テキストからビジュアルを作りたい制作者向けで、モデル、サイズ、縦横比、保存方法や複数案を指定できます。

主な機能

  1. 01プロンプトから画像を生成
  2. 02GeminiまたはImagenモデルの選択
  3. 03解像度と縦横比の指定
  4. 04一度に複数のバリエーションを生成
  5. 05ファイル名と出力先の設定

活用シーン

  1. 01SNS用の正方形・縦長素材の作成
  2. 02動画サムネイルや記事ヘッダーの生成
  3. 03デザイン候補のバリエーション作成
  4. 04高解像度の印刷素材の制作

インストール

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

$npx skills add https://github.com/akrindev/google-studio-skills --skill gemini-image

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

scripts/
generate_image.js
package-lock.json
package.json

詳細

Gemini Image Generation

実行可能なスクリプトを使って、Google の Gemini モデルと Imagen モデルでテキストプロンプトから高品質な画像を生成します。

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

次のような場合に、このスキルを使用します。

  • テキストによる説明からビジュアルコンテンツを作成する
  • 複数の画像バリエーションを生成する
  • 特定の解像度(1K、2K、4K)で画像を作成する
  • さまざまなアスペクト比(ソーシャルメディア、バナーなど)の画像を作成する
  • 写真のようにリアルな画像や芸術的なビジュアルを生成する
  • 人物生成の制御機能を使って画像を作成する
  • 複数の画像を一度にまとめて生成する
  • テキスト生成と組み合わせて、コンテンツを一貫して作成する

利用可能なスクリプト

scripts/generate_image.js

目的:Gemini 3 Pro Image または Imagen 4 モデルを使って画像を生成します

使用する場面:

  • あらゆる画像生成タスク
  • 複数の画像の生成(1 回のリクエストにつき 1~4 枚)
  • カスタム解像度やアスペクト比が必要な場合
  • プロ品質のアセットの作成
  • 写真のようにリアルな画像や芸術的な画像の生成

主なパラメーター:

パラメーター説明例
promptテキストによる説明(必須)"A futuristic city at sunset"
--model、-m使用するモデルgemini-3.1-flash-image-preview
--output-dir、-o画像の出力先ディレクトリimages/
--name、-n出力ファイルのベース名artwork
--no-timestamp自動タイムスタンプを無効化フラグ
--aspect、-aアスペクト比16:9
--size、-s解像度2K または 4K
--num画像の枚数(1~4)4
--person人物生成ポリシーallow_adult

出力:保存された PNG ファイルパスのリスト

ワークフロー

ワークフロー 1:基本的な画像生成
node scripts/generate_image.js "A futuristic city at sunset with flying cars"
  • 最適な用途:手早い画像生成、プロトタイプ
  • モデル:gemini-3.1-flash-image-preview(デフォルト、Nano Banana 2)
  • 出力:images/generated_image_YYYYMMDD_HHMMSS.png
ワークフロー 2:ソーシャルメディア(Instagram、Facebook)
node scripts/generate_image.js "Minimalist coffee shop interior" --aspect 1:1 --size 2K --name coffee-shop
  • 最適な用途:Instagram の投稿、プロフィール画像
  • アスペクト比:1:1(正方形)
  • 解像度:2K(2048x2048)
  • 出力:images/coffee-shop_YYYYMMDD_HHMMSS.png
ワークフロー 3:YouTube サムネイル(16:9)
node scripts/generate_image.js "Tech gadget review thumbnail with vibrant colors" --aspect 16:9 --size 2K --name thumbnail
  • 最適な用途:YouTube、動画サムネイル
  • アスペクト比:16:9(ワイドスクリーン)
  • 解像度:2K(2752x1536)
  • 出力:images/thumbnail_YYYYMMDD_HHMMSS.png
ワークフロー 4:複数のバリエーション
node scripts/generate_image.js "Abstract geometric patterns in blue and gold" --num 4 --name abstract
  • 最適な用途:A/B テスト、デザイン案
  • 生成数:異なるバリエーションを 4 枚
  • 出力:images/abstract_YYYYMMDD_HHMMSS_0.png、images/abstract_YYYYMMDD_HHMMSS_1.pngなど
ワークフロー 5:カスタム出力ディレクトリ
node scripts/generate_image.js "Detailed architectural rendering of modern museum" --aspect 16:9 --size 4K --output-dir ./professional/ --name museum
  • 最適な用途:印刷物、高品質なアセット、整理されたプロジェクト
  • モデル:gemini-3.1-flash-image-preview または gemini-3-pro-image-preview(4K の場合)
  • 解像度:4K(16:9 の場合は 5504x3072)
  • ディレクトリが存在しない場合は自動的に作成されます
ワークフロー 6:写真のようにリアルな画像(Imagen 4)
node scripts/generate_image.js "Robot holding a red skateboard in urban setting" --model imagen-4.0-generate-001 --aspect 16:9 --size 2K --num 2 --name robot-skate
  • 最適な用途:リアルな写真、商品写真
  • モデル:imagen-4.0-generate-001(写真のようにリアル)
  • 注意:英語のプロンプトのみ
  • 1 回のリクエストにつき最大 4 枚
ワークフロー 7:ブログ記事のアイキャッチ画像
node scripts/generate_image.js "Serene mountain lake at sunrise with reflections" --aspect 16:9 --size 2K --output-dir ./blog-images/ --name featured-image
  • 最適な用途:ブログのヘッダー、記事画像
  • 連携に適したスキル:ブログコンテンツの生成には gemini-text
ワークフロー 8:コンテンツ作成パイプライン(テキスト+画像)
# 1. Generate content (gemini-text skill)
node skills/gemini-text/scripts/generate.js "Write a product description for smart home device"

# 2. Generate product image (this skill)
node scripts/generate_image.js "Sleek modern smart home device on white background" --aspect 4:3 --size 2K --name product

# 3. Create social media post
  • 最適な用途:E コマース、マーケティングキャンペーン
  • 連携するスキル:gemini-text、gemini-batch による一括生成
ワークフロー 9:タイムスタンプを無効化
node scripts/generate_image.js "Fixed filename image" --name my-image --no-timestamp
  • 最適な用途:ファイル名を完全に制御したい場合
  • 出力:images/my-image.png(タイムスタンプなし)
  • 使用する場面:特定の命名規則や自動化されたパイプライン向けにファイルを生成する場合

パラメーターのリファレンス

モデルの選択
モデルニックネーム品質最大サイズ最適な用途
gemini-3.1-flash-image-previewNano Banana 2Pro レベル4K新しいデフォルト。高速で高品質
gemini-3-pro-image-previewNano Banana Pro最高4K最高品質、複雑なテキストのレンダリング
gemini-2.5-flash-imageNano Banana良好2K大量生成、低レイテンシ
imagen-4.0-generate-001Imagen 4写実的2Kリアルな写真、商品画像
アスペクト比
比率用途1K サイズ2K サイズ
1:1Instagram、アバター1024x10242048x2048
16:9YouTube、プレゼンテーション1376x7682752x1536
9:16Instagram ストーリーズ、TikTok768x13761536x2752
4:3従来型ディスプレイ1024x7682048x1536
3:4縦向き768x10241536x2048
21:9ウルトラワイド-5504x2400

注:4K 解像度は gemini-3.1-flash-image-preview と gemini-3-pro-image-preview で利用できます。

解像度ガイド
サイズ用途最適なモデル
1K(1024px)Web サムネイル、プレビューすべてのモデル
2K(2048px)標準的な Web、ソーシャルメディアすべてのモデル
4K(4096px)印刷、ハイエンド素材gemini-3-pro のみ
人物生成ポリシー
ポリシー説明制限事項
dont_allow画像に人物を含めないなし
allow_adult成人のみデフォルトとして推奨
allow_allすべての年齢EU、UK、CH、MENA では制限あり

出力の解釈

ファイル名
  • デフォルト形式:{name}_YYYYMMDD_HHMMSS.png(タイムスタンプを自動付与)
  • 画像 1 枚の場合の例:artwork_20260130_031643.png
  • 画像が複数の場合:{name}_YYYYMMDD_HHMMSS_0.png、{name}_YYYYMMDD_HHMMSS_1.png など
  • タイムスタンプなし(--no-timestamp):{name}.png
  • スクリプトの出力:「Saved: /path/to/file.png」
画像品質
  • すべての画像には真正性を示す SynthID ウォーターマークが含まれます
  • 可逆圧縮の品質を保つ PNG 形式
  • 必要に応じて JPEG/WEBP に変換できます
  • 4K 画像はファイルサイズが大幅に大きくなります
エラーメッセージ
  • 「Model not available」:モデル名のスペルを確認してください
  • 「Unsupported size」:サイズとモデルの組み合わせを確認してください
  • 「Aspect ratio error」:選択したモデルでサポートされている比率を使用してください

よくある問題

「google-genai or pillow not installed」
cd scripts && npm install
「Image generation failed」
  • プロンプトの長さを確認してください(長すぎると失敗することがあります)
  • よりシンプルで焦点を絞ったプロンプトを試してください
  • お使いの地域でモデルが利用可能か確認してください
  • API のクォータ上限を確認してください
「Unsupported aspect ratio」
  • 選択したモデルがその比率に対応しているか確認してください
  • Imagen 4 は Gemini よりも選択できる比率が少なくなっています
  • 最も互換性の高い 16:9 または 1:1 を使用してください
「4K not supported」
  • 4K は gemini-3.1-flash-image-preview または gemini-3-pro-image-preview で最適に動作します
  • 古いモデルでは --size 2K を使用してください
  • --model gemini-3.1-flash-image-preview --size 4K を試してください
「Imagen prompt language error」
  • Imagen モデルが対応しているプロンプトは英語のみです
  • 他の言語では gemini-3.1-flash-image-preview を使用してください
  • Imagen ではプロンプトを英語に翻訳してください
ストレージに対してファイルが大きすぎる
  • ファイルサイズを小さくするには --size 1K を使用してください
  • 生成後に画像を圧縮してください
  • Web で使用する場合は PNG を JPEG に変換してください

ベストプラクティス

プロンプトエンジニアリング
  • 具体的で詳しく記述してください
  • スタイルを表す語句(例:「photorealistic」、「digital art」)を含めてください
  • 照明、雰囲気、構図について言及してください
  • 複雑な概念には類推を使ってください
  • ネガティブプロンプトは避けてください(避けたいものではなく、生成したいものを記述します)
モデルの選択
  • 次の用途には gemini-3.1-flash-image-preview を使用してください:最適なデフォルトバランス、品質、速度、4K
  • 次の用途には gemini-3-pro-image-preview を使用してください:最高品質、複雑なテキストのレンダリング
  • 次の用途には gemini-2.5-flash-image を使用してください:速度、大量生成
  • 次の用途には imagen-4.0-generate-001 を使用してください:写実表現、商品画像
パフォーマンスの最適化
  • --num を使って複数の画像を一度に生成します
  • プレビューには低解像度を使用します
  • 大量のリクエストにはバッチ処理を使用します(gemini-batch スキル)
  • 繰り返しリクエストする場合は結果をキャッシュします
品質に関するヒント
  • ほとんどのウェブ用途では 2K 解像度を使用します
  • 最大限の詳細が必要な場合に限り 4K を使用します
  • 具体的なプロンプトとスタイルの指示を組み合わせます
  • バッチ生成の前に --num 1 でプロンプトをテストします
コスト管理
  • コスト効率を高めるには Flash モデルを使用します
  • 4K での生成は大幅にコストが増加します
  • 可能な場合は複数のリクエストをまとめてバッチ処理します
  • テストでは 1K、最終生成では 2K/4K で生成します

関連スキル

  • gemini-text:画像とあわせてテキストコンテンツを生成します
  • gemini-tts:画像ベースのコンテンツ向けの音声を作成します
  • gemini-batch:複数の画像リクエストを効率的に処理します
  • gemini-embeddings:類似検索用の画像埋め込みを生成します

クイックリファレンス

# Basic
node scripts/generate_image.js "Your prompt"

# Social media (1:1)
node scripts/generate_image.js "Prompt" --aspect 1:1 --size 2K --name social-post

# YouTube thumbnail (16:9)
node scripts/generate_image.js "Prompt" --aspect 16:9 --size 2K --name thumbnail

# 4K high quality
node scripts/generate_image.js "Prompt" --aspect 16:9 --size 4K --name high-res

# Multiple variations
node scripts/generate_image.js "Prompt" --num 4 --name variations

# Custom directory
node scripts/generate_image.js "Prompt" --output-dir ./my-images/ --name custom

# Photorealistic
node scripts/generate_image.js "Prompt" --model imagen-4.0-generate-001 --aspect 16:9 --size 2K --name photo

# No timestamp
node scripts/generate_image.js "Prompt" --name fixed-name --no-timestamp

リファレンス

コメント