Ideogram V4 Edit API | WaveSpeedAI

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

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, and output_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.

Ideogram v4 Edit API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/ideogram-ai/ideogram-v4/edit with your input as JSON. The endpoint returns a prediction id; poll the prediction endpoint until status flips to completed, then read the output URL from data.outputs[0]. Examples for Ideogram v4 Edit below.

HTTP example

# Submit the prediction
curl -X POST "https://api.wavespeed.ai/api/v3/ideogram-ai/ideogram-v4/edit" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "image": "https://example.com/your-input.jpg",
    "strength": 0.8,
    "output_format": "jpeg"
}'

# Response includes a prediction id. Poll for the result:
curl -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY"

# When status is "completed", read the output from data.outputs[0].

Node.js example

// npm install wavespeed
const WaveSpeed = require('wavespeed');

const client = new WaveSpeed(); // reads WAVESPEED_API_KEY from env

const result = await client.run("ideogram-ai/ideogram-v4/edit", {
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "image": "https://example.com/your-input.jpg",
        "strength": 0.8,
        "output_format": "jpeg"
});

console.log(result.outputs[0]); // → URL of the generated output

Python example

# pip install wavespeed
import wavespeed

output = wavespeed.run(
    "ideogram-ai/ideogram-v4/edit",
    {
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "image": "https://example.com/your-input.jpg",
    "strength": 0.8,
    "output_format": "jpeg"
}
)

print(output["outputs"][0])  # → URL of the generated output

Ideogram v4 Edit API — Frequently asked questions

What is the Ideogram v4 Edit API?

Ideogram v4 Edit is a Ideogram model for image editing, exposed as a REST API 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. You can call it programmatically or try it from the playground above.

How do I call the Ideogram v4 Edit API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID; poll the prediction endpoint until status flips to "completed", then read the output URL from the result. The playground generates a ready-to-paste code sample in Python, JavaScript, or cURL for whatever inputs you've set. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/ideogram-ai/ideogram-ai-ideogram-v4-edit.

How much does Ideogram v4 Edit cost per run?

Ideogram v4 Edit starts at $0.010 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Ideogram v4 Edit accept?

Key inputs: `prompt`, `image`, `output_format`, `strength`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/ideogram-ai/ideogram-ai-ideogram-v4-edit.

How do I get started with the Ideogram v4 Edit API?

Sign up for a free WaveSpeedAI account to claim starter credits, copy your API key from /accesskey, then call the endpoint shown in the API tab of the playground. The playground also auto-generates a code sample in Python, JavaScript, or cURL for the parameters you've set.

Can I use Ideogram v4 Edit outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (Ideogram). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.

示例查看全部

相關模型

README