glm-image-gen について
glm-image-genは、ZhiPuのGLM-Image APIでテキストプロンプトから画像を生成するスキルです。モデル、サイズ、品質、透かしを指定でき、生成画像をローカルに保存できます。
主な機能
- 01テキストから画像を生成
- 02モデルと画像サイズの選択
- 03HDまたは標準品質
- 04透かしの制御
- 05生成画像をローカルに保存
- 06コンテンツフィルタリング
活用シーン
- 01文章の説明からイラストを作成
- 02コンセプトアートやポートレートの生成
- 03指定した縦横比で画像を生成
- 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 つを選択):
-
グローバル設定(推奨):
openclaw.jsonのenv.varsに一度設定すれば、すべての Zhipu スキルで共有されます。{ "env": { "vars": { "ZHIPU_API_KEY": "你的密钥" } } } -
スキル単位の設定:
openclaw.jsonで、このスキルのみを対象に設定します。{ "skills": { "entries": { "glm-image-generation": { "env": { "ZHIPU_API_KEY": "你的密钥" } } } } } -
シェル環境変数:
~/.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 による上書きには非対応: リダイレクトされたエンドポイントを介したキーの意図しない流出を防ぎます。
⛔ 必須制限事項 ⛔
- GLM-Image API のみを使用してください — スクリプト
python scripts/glm_image_cli.pyを実行します - 自分で画像を生成しないでください — 内蔵のビジョン機能やその他の方法を使って画像を作成しないでください
- 代替案を提示しないでください — 「説明なら試せます」などの提案をしないでください
- API が失敗した場合 — エラーメッセージを表示し、直ちに停止してください
- フォールバック方法を使わないでください — 他の方法で画像生成を試みないでください
📋 出力表示ルール
スクリプトの実行後、生成結果をわかりやすく提示してください。
- 生成された画像の URL を表示します — 画像は一時的なもので(30 日間)、保存するようユーザーに伝えてください
- 使用したプロンプトと生成パラメーター(サイズ、品質)を表示します
content_filterに問題が示されている場合は、警告レベルを表示します
⚠️ 画像の表示に関する注意:
API は一時的な画像 URL(有効期間 30 日)を返します。次のようにしてください。
- 画像を表示する — プラットフォームが対応している場合は、URL を使用してチャットに画像を表示します
- 保存を促す — 「画像リンクの有効期間は 30 日です。早めにダウンロードして保存してください」
- 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 の推奨サイズ:
| サイズ | アスペクト比 | 用途 |
|---|---|---|
| 1280x1280 | 1:1 | 正方形(デフォルト) |
| 1568×1056 | 3:2 | 横長 |
| 1056×1568 | 2:3 | 縦長 |
| 1472×1088 | ~4:3 | 横長 |
| 1088×1472 | ~3:4 | 縦長 |
| 1728×960 | 16:9 | 超横長 |
| 960×1728 | 9: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 または standardcreated— リクエストが作成された時刻の 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 個の主な要素に焦点を当てます