Z AI Glm Image Edit
Playground
Try it on WaveSpeedAI!GLM-Image Edit is a powerful image-to-image editing model that transforms images based on text prompts. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Features
GLM-Image Image-Edit is Z.AI’s powerful image transformation model that modifies images based on text prompts. Upload up to 4 reference images and describe the changes you want — the model reimagines your images while preserving key elements and applying your requested modifications.
Why Choose This?
-
Multi-image reference Upload up to 4 reference images to guide the transformation with richer context.
-
Text-guided transformation Describe changes in natural language — lighting, style, time of day, environment, and more.
-
Flexible output sizing Custom width and height from 256 to 1536 pixels for any aspect ratio.
-
Prompt Enhancer Built-in tool to automatically improve your prompts for better results.
-
LLM-powered prompt expansion Optional feature to automatically enhance short prompts with more detail.
Parameters
| Parameter | Required | Description |
|---|---|---|
| prompt | Yes | Text description of the desired transformation |
| images | Yes | Reference images to transform (1-4 images) |
| width | No | Output width in pixels (256-1536, default: 1024) |
| height | No | Output height in pixels (256-1536, default: 1024) |
| seed | No | Random seed for reproducibility (-1 for random) |
| output_format | No | Output format: jpeg (default) or png |
| enable_prompt_expansion | No | Enhance prompt using LLM for better results |
| enable_sync_mode | No | API only: wait for result before returning response |
Output Format Options
- jpeg — Smaller file size, good for photos and web use (default)
- png — Lossless quality, supports transparency, best for graphics
How to Use
- Write your prompt — describe the transformation you want (e.g., “change to daytime”, “add snow”, “make it cyberpunk style”).
- Upload reference images — add 1-4 images using ”+ Add Item” button.
- Set size — adjust width and height (256-1536 pixels).
- Set seed — use -1 for random results, or specify a number for reproducibility.
- Choose output format — jpeg for smaller files, png for lossless quality.
- Enable prompt expansion (optional) — check this to let LLM enhance your prompt.
- Run — click Run, preview the result, and iterate if needed.
Pricing
| Item | Cost |
|---|---|
| Per image | $0.12 |
Simple flat-rate pricing regardless of image size or number of reference images.
Best Use Cases
- Lighting Changes — Transform day to night, add golden hour, change weather conditions.
- Style Transfer — Apply artistic styles while preserving composition.
- Scene Modification — Add or remove elements, change seasons, modify environments.
- Creative Reimagining — Generate variations based on multiple reference images.
- Content Adaptation — Adjust images for different moods or contexts.
Pro Tips
- Be specific in your transformation prompt — describe exactly what should change.
- Use multiple reference images when you want to blend styles or elements from different sources.
- Enable prompt expansion for short prompts; disable it for precise control.
- Start with default 1024x1024 size, then adjust for specific aspect ratios.
- Use the same seed to compare different prompts on the same reference images.
Notes
- Maximum 4 reference images per generation.
- Size range: 256-1536 pixels for both width and height.
- enable_sync_mode is only available through the API.
- Please ensure your prompts comply with content guidelines.
Related Models
- Z.AI GLM-Image Text-to-Image — Generate images from text prompts only.
- Z.AI CogView-4 — Z.AI’s high-quality text-to-image model with flexible quality modes.
- Qwen Image Edit 2511 — Precise image editing with text instructions.
Authentication
For authentication details, please refer to the Authentication Guide.
API Endpoints
Submit Task & Query Result
set -euo pipefail
export WAVESPEED_API_KEY="your-api-key"
REQUEST_BODY=$(cat <<'JSON'
{
"prompt": "A cinematic ocean wave at sunrise, highly detailed",
"images": [
"https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg"
],
"seed": -1,
"output_format": "jpeg",
"enable_prompt_expansion": false
}
JSON
)
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/z-ai/glm-image/edit" \
-H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
-H "Content-Type: application/json" \
-d "${REQUEST_BODY}")
TASK=$(printf '%s' "${SUBMIT_RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "${TASK}" | jq -r '.id // empty')
if [ -z "${PREDICTION_ID}" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL=$(printf '%s' "${TASK}" | jq -r '.urls.get // empty')
if [ -z "${RESULT_URL}" ]; then RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"; fi
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body \
"${RESULT_URL}" \
-H "Authorization: Bearer ${WAVESPEED_API_KEY}")
RESULT=$(printf '%s' "${RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')
case "${STATUS}" in
completed) printf '%s\n' "${RESULT}" | jq '.outputs'; break ;;
failed|cancelled|timeout) printf '%s\n' "${RESULT}" | jq . >&2; exit 1 ;;
created|processing) sleep 2 ;;
*) printf 'Unexpected status: %s
' "${STATUS}" >&2; exit 1 ;;
esac
doneParameters
Task Submission Parameters
Request Parameters
| Parameter | Type | Required | Default | Range | Description |
|---|---|---|---|---|---|
| prompt | string | Yes | - | The positive prompt for the generation. | |
| images | array<string> | Yes | - | 1 ~ 4 items | URL(s) of condition image(s) for image-to-image generation. Supports up to 4 URLs. |
| seed | integer | No | -1 | - | The random seed to use for the generation. -1 means a random seed will be used. |
| output_format | string | No | jpeg | jpeg, png, webp | The format of the output image. |
| enable_prompt_expansion | boolean | No | false | - | Enhance prompt using LLM for better results. |
| enable_sync_mode | boolean | No | false | - | If set to `true`, the request attempts to wait for the generated result and return outputs in the same response. If the result is not ready within the sync wait window, the API can return a timeout body while the task continues processing. This option is only available via the API and is supported only by some models. |
| enable_base64_output | boolean | No | false | - | If set to `true`, the prediction's `output` strings are returned as **naked base64** (no `data:<mime>;base64,` prefix). When `false` (default), outputs are returned as URLs pointing to our CDN. |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data.id | string | Unique identifier for the prediction, Task Id |
| data.model | string | Model ID used for the prediction |
| data.outputs | array | Output values, usually URL strings; some models return text strings or structured result objects (empty when status is not completed) |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |
Result Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| id | string | Yes | - | Task ID |
Result Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data | object | The prediction data object containing all details |
| data.id | string | Unique identifier for the prediction |
| data.model | string | Model ID used for the prediction |
| data.outputs | array<string | object> | Array of generated outputs (empty when status is not completed). Items are usually URL strings, but may be text strings or structured result objects, depending on the model. |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to poll for the prediction result |
| data.status | string | Status: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |