mcpField
G
glm-image-gen

glm-image-gen

github.com/zai-orgクリエイティブ・メディア47566 回インストール28 週間前に更新
リポジトリ

glm-image-gen について

glm-image-genは、ZhiPuのGLM-Image APIでテキストプロンプトから画像を生成するスキルです。モデル、サイズ、品質、透かしを指定でき、生成画像をローカルに保存できます。

主な機能

  1. 01テキストから画像を生成
  2. 02モデルと画像サイズの選択
  3. 03HDまたは標準品質
  4. 04透かしの制御
  5. 05生成画像をローカルに保存
  6. 06コンテンツフィルタリング

活用シーン

  1. 01文章の説明からイラストを作成
  2. 02コンセプトアートやポートレートの生成
  3. 03指定した縦横比で画像を生成
  4. 04生成画像を後で使うために保存

インストール

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

$npx skills add https://github.com/zai-org/glm-skills --skill glm-image-gen

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

同梱ファイルscripts/glm_image_cli.py

詳細

GLM-Image Generation Skill / GLM-Image 图片生成技能

ZhiPu GLM-Image API を使用して、テキストプロンプトから高品質な画像を生成します。

When to Use / 使用场景

  • テキストの説明から画像を生成する
  • AI アート、イラスト、コンセプトアートを作成する
  • ユーザーが「生图」「文生图」「AI 绘画」「generate image」「text-to-image」「create image」に言及した場合
  • ユーザーがプロンプトを提示し、それを視覚化したい場合

Key Features / 核心特性

  • 高品質な生成:HD モードでは、より詳細で洗練された画像を生成します(約 20 秒)
  • 複数のアスペクト比:正方形、縦長、横長の形式に対応しています
  • GLM-Image モデル:理解力と品質が向上した最新モデルです
  • 優れた用途:科学解説イラスト、高品質なポートレート、ソーシャルメディア向けグラフィック、商業ポスター
  • ウォーターマークの制御:ウォーターマークを有効/無効にできます(ウォーターマークなしの場合は、署名済みの免責事項が必要です)
  • コンテンツセーフティ:コンプライアンスに対応するため、コンテンツフィルターを内蔵しています

Resource Links / 资源链接

リソースリンク
API キーを取得智谱开放平台 API Keys
API ドキュメント画像生成
モデルドキュメントGLM-Image モデルドキュメント

Prerequisites / 前置条件

API Key Setup / API Key 配置(Required / 必需)

スクリプトは ZHIPU_API_KEY 環境変数からキーを取得し、他の智谱スキルと同じキーを再利用できます。 このスクリプトは ZHIPU_API_KEY 環境変数からキーを読み取ります。Zhipu のスキル間で同じキーを再利用するかどうかは任意です。

キーの取得: 智谱开放平台 API Keys にアクセスして、キーを作成するかコピーしてください。

設定方法(いずれか 1 つを選択):

  1. グローバル設定(推奨): openclaw.json の env.vars に一度設定すれば、すべての Zhipu スキルで共有されます。

    {
      "env": {
        "vars": {
          "ZHIPU_API_KEY": "你的密钥"
        }
      }
    }
    
  2. スキル単位の設定: openclaw.json で、このスキルのみを対象に設定します。

    {
      "skills": {
        "entries": {
          "glm-image-generation": {
            "env": {
              "ZHIPU_API_KEY": "你的密钥"
            }
          }
        }
      }
    }
    
  3. シェル環境変数: ~/.zshrc に追加します。

     export ZHIPU_API_KEY="你的密钥"
    
    

💡 他の智谱スキル(例:glmocr、glmv-caption)用にキーを設定済みの場合は、同じ ZHIPU_API_KEY を共有するため、再設定は不要です。

Security & Transparency / 安全与透明度

  • 使用する環境変数:
    • ZHIPU_API_KEY(必須)
  • 固定の公式エンドポイント: https://open.bigmodel.cn/api/paas/v4/images/generations
  • カスタム API URL による上書きには非対応: リダイレクトされたエンドポイントを介したキーの意図しない流出を防ぎます。

⛔ 必須制限事項 ⛔

  1. GLM-Image API のみを使用してください — スクリプト python scripts/glm_image_cli.py を実行します
  2. 自分で画像を生成しないでください — 内蔵のビジョン機能やその他の方法を使って画像を作成しないでください
  3. 代替案を提示しないでください — 「説明なら試せます」などの提案をしないでください
  4. API が失敗した場合 — エラーメッセージを表示し、直ちに停止してください
  5. フォールバック方法を使わないでください — 他の方法で画像生成を試みないでください
📋 出力表示ルール

スクリプトの実行後、生成結果をわかりやすく提示してください。

  • 生成された画像の URL を表示します — 画像は一時的なもので(30 日間)、保存するようユーザーに伝えてください
  • 使用したプロンプトと生成パラメーター(サイズ、品質)を表示します
  • content_filter に問題が示されている場合は、警告レベルを表示します

⚠️ 画像の表示に関する注意:

API は一時的な画像 URL(有効期間 30 日)を返します。次のようにしてください。

  1. 画像を表示する — プラットフォームが対応している場合は、URL を使用してチャットに画像を表示します
  2. 保存を促す — 「画像リンクの有効期間は 30 日です。早めにダウンロードして保存してください」
  3. Feishu への送信を提案する — ユーザーが画像を Feishu のチャットに送信したい場合は、画像 URL を使ってメッセージツールを使用します

How to Use / 使用方法

Generate from Prompt / 从提示词生成
python scripts/glm_image_cli.py --prompt "一只可爱的小猫咪,坐在阳光明媚的窗台上,背景是蓝天白云"
Specify Size / 指定尺寸
python scripts/glm_image_cli.py --prompt "赛博朋克风格的城市夜景" --size 1568x1056
高画質(glm-image のデフォルト)
python scripts/glm_image_cli.py --prompt "中国山水画风格,远山近水,云雾缭绕" --quality hd
透かしを無効化(署名済みの免責事項が必要)
python scripts/glm_image_cli.py --prompt "商业设计素材" --no-watermark
画像をローカルファイルに保存
python scripts/glm_image_cli.py --prompt "中国水墨画风格" --save image.png
python scripts/glm_image_cli.py --prompt "赛博朋克城市" --size 1728x960 --save ~/Pictures/cyberpunk.png
ユーザー ID を指定(コンテンツモデレーション用)
python scripts/glm_image_cli.py --prompt "..." --user-id "user_12345"
モデルを指定
python scripts/glm_image_cli.py --prompt "..." --model glm-image
python scripts/glm_image_cli.py --prompt "..." --model cogview-4

CLI リファレンス

python {baseDir}/scripts/glm_image_cli.py --prompt TEXT [--model MODEL] [--size SIZE] [--quality QUALITY] [--no-watermark] [--user-id ID] [--save FILE]
パラメーター必須説明
--prompt, -pはい生成したい画像のテキスト説明
--model, -mいいえモデル:glm-image(デフォルト)、cogview-4、cogview-3-flash
--size, -sいいえ画像サイズ(デフォルト:1280x1280)
--quality, -qいいえ画質:hd(デフォルト)または standard
--no-watermarkいいえ透かしを無効化(署名済みの免責事項が必要)
--user-idいいえコンテンツモデレーション用のエンドユーザー ID(6~128 文字)
--saveいいえ生成した画像をローカルファイルに保存

対応サイズ

GLM-Image の推奨サイズ:

サイズアスペクト比用途
1280x12801:1正方形(デフォルト)
1568×10563:2横長
1056×15682:3縦長
1472×1088~4:3横長
1088×1472~3:4縦長
1728×96016:9超横長
960×17289:16超縦長

カスタムサイズ:

  • 幅と高さ:1024px~2048px
  • 幅と高さはどちらも 32 の倍数である必要があります
  • 最大総ピクセル数:2^22(4,194,304 px)以下

レスポンス形式

公式 API レスポンス:

{
  "created": 123,
  "data": [
    {
      "url": "<string>"
    }
  ],
  "content_filter": [
    {
      "role": "assistant",
      "level": 1
    }
  ]
}

CLI 出力形式:

{
  "ok": true,
  "model": "glm-image",
  "image_url": "https://open.bigmodel.cn/.../generated_image.png",
  "prompt": "一只可爱的小猫咪,坐在阳光明媚的窗台上,背景是蓝天白云",
  "size": "1280x1280",
  "quality": "hd",
  "created": 1710835200,
  "content_filter": [
    {
      "role": "assistant",
      "level": 3
    }
  ],
  "saved_file": "/Users/xxx/image.png",
  "error": null
}

主なフィールド:

  • ok — 生成が成功したかどうか
  • model — 生成に使用したモデル
  • image_url — data[0].url から取得した、一時 URL(有効期間は 30 日間)
  • prompt — 使用したテキストプロンプト
  • size — 生成した画像の寸法
  • quality — hd または standard
  • created — リクエストが作成された時刻の Unix タイムスタンプ
  • content_filter — コンテンツ安全性分析の配列(空の場合があります)
    • role:問題が検出された場所(user/assistant/history)
    • level:重大度 0~3(0 = 最も重大、3 = 軽微)
  • saved_file — 保存されたローカルファイルの絶対パス(--save を使用した場合)
  • error — 失敗時のエラー詳細

コンテンツ安全性

API にはコンテンツフィルタリング機能が含まれています。問題が検出された場合、content_filter に次の項目が含まれます。

  • role:問題が検出された場所(user/assistant/history)
  • level:重大度 0~3(0 = 最も重大、3 = 軽微)

level 0~1 が検出された場合: 生成は失敗し、ユーザーにエラーが表示されます。 level 2~3 が検出された場合: 生成は成功する場合がありますが、潜在的な問題についてユーザーに警告してください。

エラー処理

API キーが設定されていない場合:

{
  "ok": false,
  "error": {
    "code": "MISSING_API_KEY",
    "message": "ZHIPU_API_KEY not configured. Get your API key at: https://bigmodel.cn/usercenter/proj-mgmt/apikeys"
  }
}

→ エラーをそのままユーザーに表示し、設定方法を案内します

認証に失敗した場合(401/403):

{
  "ok": false,
  "error": {
    "code": "authentication_error",
    "message": "令牌已过期或验证不正确",
    "status": 401
  }
}

→ API キーが無効または期限切れです → 再設定します

レート制限(429):

{
  "ok": false,
  "error": {
    "code": "rate_limit_exceeded",
    "message": "API rate limit exceeded. Please try again later.",
    "status": 429
  }
}

→ クォータを使い切っています → 待機するか、クォータを確認するようユーザーに伝えます

コンテンツフィルター違反:

{
  "ok": false,
  "error": {
    "code": "content_filter_violation",
    "message": "Content safety check failed",
    "status": 400
  }
}

→ プロンプトに不適切な内容が含まれている可能性があることを説明します

無効なサイズ:

{
  "ok": false,
  "error": {
    "code": "INVALID_SIZE",
    "message": "Invalid size: 512x512 for model glm-image. Must be multiple of 32, 1024-2048px, max 2^22 pixels"
  }
}

→ 対応サイズの一覧から有効なサイズを選ぶよう案内します

ダウンロードに失敗した場合:

{
  "ok": false,
  "error": {
    "code": "DOWNLOAD_FAILED",
    "message": "Failed to download image to image.png"
  }
}

→ ファイルパスのアクセス許可とディスク容量を確認します

ネットワークエラー:

{
  "ok": false,
  "error": {
    "code": "NETWORK_ERROR",
    "message": "Network error: [Errno 8] nodename nor servname provided, or not known"
  }
}

→ インターネット接続を確認します

プロンプトのヒント / プロンプトのコツ

良いプロンプト:

  • 具体的な詳細:「緑色の目をしたオレンジ色のブリティッシュショートヘアの猫が、木製の窓辺に座っている」
  • スタイルのキーワード:「サイバーパンク風」、「中国水墨画」、「油絵の質感」、「3D レンダリング」
  • 照明:「明るい日差し」、「柔らかな逆光」、「映画のような照明」
  • 構図:「クローズアップ」、「広角視点」、「俯瞰アングル」

避けること:

  • あいまいな描写:「きれいな画像」
  • 矛盾する要素:「昼と夜が同時に存在する」
  • 被写体が多すぎる:1~2 個の主な要素に焦点を当てます

コメント