Browse ModelsIdeogram AIIdeogram AI Ideogram V4 Edit

Ideogram Ai Ideogram V4 Edit

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 the strength parameter, 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 either jpeg or png format depending on your quality, file size, or post-processing needs.


Parameters

ParameterRequiredDescription
promptYesText instruction describing how to edit the input image. Be specific about what should change and what should remain the same.
imageYesInput image to edit. Use a clear image with visible subjects and good lighting for best results.
strengthNoEdit strength from 0 to 1. Higher values allow stronger changes, while lower values preserve more of the original image.
output_formatNoOutput image format: jpeg or png. Default: jpeg.

How to Use

  1. Upload your image — provide the source image you want to edit.
  2. Write your prompt — describe the desired change in natural language.
  3. Choose output settings (optional) — set the output strength, and output_format.
  4. Submit — generate the edited image.
  5. Use the result — the model returns one generated image URL in the standard WaveSpeed prediction response.

Pricing

Just $0.01 per generated image.

OutputCost
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

ParameterTypeRequiredDefaultRangeDescription
promptstringYes-Text instruction describing how to edit the input image.
imagestringYes-The image to edit. Provide an uploaded image or a public image URL.
strengthnumberNo0.80.0 ~ 1.0How strongly the edit should transform the input image.
output_formatstringNojpegjpeg, pngThe format of the generated image.

Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
data.idstringUnique identifier for the prediction, Task Id
data.modelstringModel ID used for the prediction
data.outputsarrayArray of URLs to the generated content (empty when status is not completed)
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds

Result Request Parameters

ParameterTypeRequiredDefaultDescription
idstringYes-Task ID

Result Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
dataobjectThe prediction data object containing all details
data.idstringUnique identifier for the prediction, the ID of the prediction to get
data.modelstringModel ID used for the prediction
data.outputsstringArray of URLs to the generated content.
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds
© 2025 WaveSpeedAI. All rights reserved.