glmv-prompt-gen

GLM-V Prompt Generation Skill

Analyze reference images or videos and generate professional prompts for AI image/video generation tools.

When to Use

Generate prompts for text-to-image tools (Midjourney, Stable Diffusion, DALL-E, etc.)
Generate prompts for text-to-video tools (Sora, Runway, Kling, Pika, etc.)
User mentions "generate prompt", "text-to-image prompt", "text-to-video prompt", "prompt engineering", "reference image generate prompt", "generate prompt"
User provides an image/video and wants to recreate or remix it
Extract prompt ideas from reference visual content

Supported Input Types

Type	Formats	Max Size	Max Count	Base64
Image	jpg, png, jpeg	5MB / 6000×6000px	50	✅
Video	mp4, mkv, mov	200MB	—	❌ (URL only)

⚠️ Images and videos cannot be used in the same request. ⚠️ Videos only support URLs — local paths and base64 are NOT supported.

📋 Output Display Rules (MANDATORY)

After running the script, you must display the full prompt output exactly as returned. Do not summarize, truncate, or only say "prompt generated". Users need the complete prompt (especially the English prompt) for direct copy/paste.

Show the full output: content analysis + prompt + prompt breakdown
In auto mode, show both text-to-image and text-to-video prompts
English prompts are core output and must be shown completely
If output was saved (-o), provide the file path and show file content

Output Modes

Mode	Description
`image`	Generate prompts for text-to-image tools (default)
`video`	Generate prompts for text-to-video tools
`auto`	Generate prompts for both image and video

Resource Links

Resource	Link
Get API Key	https://bigmodel.cn/usercenter/proj-mgmt/apikeys
API Docs	Chat Completions / Chat Completions

Prerequisites

API Key Setup / API Key Setup (Required / Required)

This script reads the key from the ZHIPU_API_KEY environment variable and shares it with other Zhipu skills. The script uses the ZHIPU_API_KEY environment variable to obtain the key, sharing the same key with other Zhipu skills.

Get Key / Get Key: Visit Zhipu Open Platform API Keys / Zhipu Open Platform API Keys to create or copy your key.

Setup options / Setup options (choose one):

OpenClaw config (recommended) / OpenClaw config (recommended): Set in openclaw.json under skills.entries.glmv-prompt-gen.env:
```
"glmv-prompt-gen": { "enabled": true, "env": { "ZHIPU_API_KEY": "你的密钥" } }
```
Shell environment variable / Shell environment variable: Add to ~/.zshrc:
```
export ZHIPU_API_KEY="你的密钥"
```

💡 If you already configured another Zhipu skill (for example zhipu-tools or glmv-caption), they share the same ZHIPU_API_KEY, so no extra setup is needed. 💡 If you have already configured a key for another Zhipu skill (such as zhipu-tools、glmv-caption), they share the same ZHIPU_API_KEY, so there is no need to configure it again.

How to Use

Image → Text-to-Image Prompt

python scripts/prompt_gen.py --images "https://example.com/photo.jpg"
python scripts/prompt_gen.py --images /path/to/photo.png

Image → Text-to-Video Prompt

python scripts/prompt_gen.py --images "https://example.com/scene.jpg" --mode video

Image → Both (Image + Video Prompts)

python scripts/prompt_gen.py --images "https://example.com/photo.jpg" --mode auto

Video → Text-to-Video Prompt

python scripts/prompt_gen.py --videos "https://example.com/clip.mp4" --mode video

Save Result to File

python scripts/prompt_gen.py --images photo.jpg --mode image -o prompt.md

Custom Model

python scripts/prompt_gen.py --images photo.jpg --model glm-4.6v-flash

Output Example (image mode)

### Content Analysis
A cyberpunk cityscape at night, with dense skyscrapers, glowing neon signs, and rain-wet streets reflecting colorful light.

### Prompt
Cyberpunk cityscape at night, towering skyscrapers with glowing neon signs,
rain-wet streets reflecting colorful lights, flying cars in the distance,
volumetric fog, dramatic lighting, ultra detailed, 8K, cinematic composition

### Prompt Breakdown
- **Subject**: Futuristic skyline with skyscrapers and neon lights
- **Style**: Cyberpunk, sci-fi
- **Color**: Cool/warm contrast with blue-purple dominance and neon accents
- **Lighting**: Neon glow, wet-surface reflections, volumetric fog
- **Composition**: Wide-angle perspective with layered depth
- **Mood**: Mysterious, futuristic, high-tech

CLI Reference

python scripts/prompt_gen.py (--images IMG [IMG...] | --videos VID [VID...]) [OPTIONS]

Parameter	Required	Description
`--images`, `-i`	One of	Image paths or URLs (jpg/png/jpeg, base64 OK)
`--videos`, `-v`	One of	Video URLs (mp4/mkv/mov, URL only)
`--mode`, `-m`	No	Output mode: `image` (default), `video`, or `auto`
`--model`	No	Model name (default: `glm-4.6v`)
`--temperature`, `-t`	No	Sampling temperature 0-1 (default: 0.6)
`--max-tokens`	No	Max output tokens (default: 2048)
`--thinking`	No	Enable thinking/reasoning mode
`--stream`	No	Enable streaming output
`--output`, `-o`	No	Save result to file
`--pretty`	No	Pretty-print JSON error output

Error Handling

API key not configured: → Guide user to configure ZHIPU_API_KEY

Authentication failed (401/403): → API key invalid/expired → check at Zhipu API Keys / Zhipu official website

Rate limit (429): → Quota exhausted → wait and retry

Content filtered: → warning field present → content blocked by safety review

Timeout: → Video processing may take time → increase timeout or use smaller files