Ideogram Ai Ideogram V4 Edit
Playground
Try it on WavespeedAI!Ideogram V4 Edit is a fast AI image-to-image editing model that transforms input images with text instructions while preserving the original image structure. Ready-to-use REST inference API for prompt-guided image editing, product image updates, logo and poster edits, marketing assets, creative retouching, brand visuals, and professional image editing workflows with simple integration, no coldstarts, and affordable pricing.
Features
ideogram-ai/ideogram-v4/edit
V4 Edit transforms an input image using a natural-language instruction. Upload an image, describe the edit you want, choose an output size, and generate a polished image result.
This model is designed for prompt-guided image editing, visual refinement, style changes, background updates, object modifications, and creative image variations.
Why Choose This?
-
Natural-language image editing
Edit images by simply describing what you want to change — no manual masking or complex editing workflow required. -
Prompt-guided visual control
Use clear instructions to adjust subjects, backgrounds, lighting, colors, style, composition, or fine visual details. -
Adjustable edit strength
Control how strongly the model changes the input image with thestrengthparameter, from subtle refinements to more creative transformations. -
Flexible output size
Choose an output size preset based on your target format, such as square images, social media assets, product visuals, or creative drafts. -
Simple single-image workflow
Each request takes one input image and returns one generated image URL, making it easy to integrate into automated editing pipelines. -
JPEG or PNG output
Generate results in eitherjpegorpngformat depending on your quality, file size, or post-processing needs.
Parameters
| Parameter | Required | Description |
|---|---|---|
| prompt | Yes | Text instruction describing how to edit the input image. Be specific about what should change and what should remain the same. |
| image | Yes | Input image to edit. Use a clear image with visible subjects and good lighting for best results. |
| strength | No | Edit strength from 0 to 1. Higher values allow stronger changes, while lower values preserve more of the original image. |
| output_format | No | Output image format: jpeg or png. Default: jpeg. |
How to Use
- Upload your image — provide the source image you want to edit.
- Write your prompt — describe the desired change in natural language.
- Choose output settings (optional) — set the output
strength, andoutput_format. - Submit — generate the edited image.
- Use the result — the model returns one generated image URL in the standard WaveSpeed prediction response.
Pricing
Just $0.01 per generated image.
| Output | Cost |
|---|---|
| 1 image | $0.01 |
Best Use Cases
- Product photography enhancement — Create cleaner, more polished product visuals for e-commerce, ads, and catalogs.
- Background replacement — Swap image backgrounds for studio scenes, lifestyle settings, interiors, outdoor environments, or branded visuals.
- Creative image editing — Modify visual style, mood, lighting, color palette, or artistic direction with a simple prompt.
- Social media content — Quickly generate polished image variations for posts, ads, thumbnails, and campaign assets.
- Design iteration — Test multiple visual directions from the same input image without rebuilding the asset manually.
- Object and subject refinement — Adjust clothing, materials, colors, props, or scene details while preserving the core composition.
- Image cleanup — Remove distractions, improve visual clarity, and make images look more professional.
Pro Tips
- Use a clear input image with good lighting and a visible subject.
- Write prompts that clearly separate what should change from what should stay the same.
Authentication
For authentication details, please refer to the Authentication Guide.
API Endpoints
Submit Task & Query Result
# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/ideogram-ai/ideogram-v4/edit" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
"strength": 0.8,
"output_format": "jpeg"
}'
# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"
Parameters
Task Submission Parameters
Request Parameters
| Parameter | Type | Required | Default | Range | Description |
|---|---|---|---|---|---|
| prompt | string | Yes | - | Text instruction describing how to edit the input image. | |
| image | string | Yes | - | The image to edit. Provide an uploaded image or a public image URL. | |
| strength | number | No | 0.8 | 0.0 ~ 1.0 | How strongly the edit should transform the input image. |
| output_format | string | No | jpeg | jpeg, png | The format of the generated image. |
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 | Array of URLs to the generated content (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, the ID of the prediction to get |
| data.model | string | Model ID used for the prediction |
| data.outputs | string | Array of URLs to the generated content. |
| 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 |