Ideogram 4.5 Edit API and MCP for AI agents
TollNode gives Claude, Cursor or any AI agent Ideogram 4.5 Edit, Ideogram's precise photo editor, over API and MCP, from $0.012 per image, with no subscription.
Ask it to 'make the glowing display bright green instead of yellow and add a small potted succulent on the floor beside the device' and get back one edited image link.
No subscription · Sign-up optional · From $0.012 per call · Charged only when it works · No Ideogram account needed
Edit this product photo: change the glowing display from yellow to green and add a small potted succulent on the floor beside the device, keep everything else the same. Image: https://example.com/device.jpg
TollNode · Ideogram · medium$0.082 · 1 image
| Result | Detail |
|---|---|
| File | 1 image link, does not expire |
| Quality | medium |
| Edit | Display color changed, succulent added, rest unchanged |
Real result, shown below.
Ideogram 4.5 Edit image examples
Made by this node in our own tests, from the request shown under each.
Before
AfterThe request that made it
Send the same body to get this kind of result. Change the prompt or the options to get your own.
{
"image": "https://tollnode.com/examples/image-instant.jpg",
"prompt": "make the glowing display bright green instead of yellow and put a small potted succulent on the floor beside the device, keep everything else the same",
"quality": "medium"
}What you control with Ideogram 4.5 Edit
Prompt and image
Ideogram 4.5 edits from a prompt
Describe exactly what to change in the photo.
- Image
- https://tollnode.com/examples/image-instant.jpg
- Prompt
- make the glowing display bright green instead of yellow and add a succulent
- Returns
- 1 image link
You get
- image: source photo to edit, as an https URL
- prompt: what to change, up to 2,000 characters
Mask and references
Target edits with a mask or style
Limit the edit to one area or guide style with references.
- Mask
- optional, black areas are edited
- reference_images
- up to 3, optional
- Seed
- optional, for repeatable results
You get
- mask: black-and-white https image, black areas get edited
- reference_images: up to 3 https images to guide the look
- seed: optional number to repeat a result
- from $0.012
Quality and price
very_low, low, medium or high quality
Pick the quality; the price follows it.
- Default quality
- medium
- Options
- very_low, low, medium, high
- Returns
- 1 image link
You get
- quality: very_low, low, medium or high, sets the price
- image: required source photo to edit
- prompt: required instruction for the edit
Failed calls are never charged, and image links returned by TollNode don't expire.
What people ask their AI to do with it
Ecommerce sellers
Change product color without a reshoot
“Change the hoodie color from red to forest green in this product photo, keep the model and background the same. Image: https://example.com/hoodie-red.jpg”
medium
Cost today$0.082
Real estate agents
Remove clutter from listing photos
“Remove the moving boxes from this living room photo and put a small bookshelf in that spot instead. Image: https://example.com/living-room.jpg”
medium
Cost today$0.082
Marketers
Swap ad backgrounds without a reshoot
“Change the background of this ad photo from plain white to a warm beige studio backdrop, keep the product exactly the same. Image: https://example.com/ad-shot.jpg”
medium
Cost today$0.082
Retouchers
Fix small flaws with a mask
“Use the mask to remove the scuff on the wall behind the chair and keep everything else unchanged. Image: https://example.com/room.jpg, mask: https://example.com/room-mask.png”
low
Cost today$0.042
App developers
Match screenshots to brand colors
“Change this app screenshot's accent color from blue to orange to match our new brand, keep the layout and text the same. Image: https://example.com/screenshot.png”
medium
Cost today$0.082
Social media managers
Restyle photos from reference images
“Match the lighting and mood of these two reference photos on my storefront photo, keep the storefront itself the same. Image: https://example.com/storefront.jpg”
high
Cost today$0.298
Use it as a Ideogram 4.5 Edit MCP server in Claude, Cursor or Codex
Connect once. Then just ask.
Paste this into Claude Code, Cursor or Codex. It connects TollNode and gives your agent a small wallet. Add a few dollars of USDC and you're done.
npx agentcash add https://tollnode.comCopy for your AI agent
Paste this into your agent so it knows what this node does and how to call it.
You can use TollNode's Ideogram 4.5 Edit node to make precise edits to an existing photo. Call POST https://tollnode.com/api/v1/nodes/ideogram-4-5-edit with image (required, https URL), prompt (required, what to change), quality (very_low, low, medium or high, sets the price), mask (optional https URL, black areas are edited), reference_images (optional, up to 3 https URLs) and seed (optional integer). The price depends on quality and is charged only when an image is returned. Over MCP, call the 'ideogram-4-5-edit' tool; use list_models to see prices. Give me the image link when it is done.Price
from $0.012
per image
The price depends on the quality you choose. If you don't choose, you get medium.
| very_low | $0.012 per image |
| low | $0.042 per image |
| mediumdefault | $0.082 per image |
| high | $0.298 per image |
Charged only when a call returns a result. Failed or empty calls cost $0.
Ideogram 4.5 Edit without an Ideogram account
No subscription, no credit packs
Pay per image: $0.012 at very_low, $0.042 at low, $0.082 at medium, $0.298 at high.
No Ideogram account, no dashboard setup
Your agent calls TollNode. You never set up an Ideogram account or billing.
Only charged when it works
If the edit fails or returns nothing, the call costs nothing.
One connection, many image models
The same setup also gives your agent FLUX Kontext, Nano Banana and other editors, so it can compare results.
FAQ
- Is this the official Ideogram API?
- No. TollNode is an independent service. It gives your agent access to Ideogram 4.5 Edit through its own API and MCP server, priced per image, with no Ideogram account needed.
- Can I use it as an Ideogram 4.5 Edit MCP server in Claude?
- Yes. Add https://tollnode.com/mcp in Claude Code, Claude Desktop or Cursor, and the 'ideogram-4-5-edit' tool appears with its options and prices.
- What quality options are there?
- very_low, low, medium or high. The default is medium, and the quality you pick sets the price.
- Can I limit the edit to part of the photo?
- Yes. Send a black-and-white mask as an https URL. Black areas of the mask get edited; the rest of the photo stays the same.
- Can I guide the edit with reference images?
- Yes. Add up to 3 https image URLs in reference_images to guide the look of the edit.
- What if the edit fails?
- You're not charged. TollNode only collects payment when a usable image is returned.
- How long are the image links valid?
- They don't expire. Download the file or keep the link.
Works well with
- Ideogram 4.5 text-to-imageGenerate a new image from scratch in the same family before editing itfrom $0.042
- FLUX Kontext Pro image editingRun the same edit instruction on a different photo editor to compare$0.055
- Crisp image upscalerEnlarge the edited photo after the change is made$0.010
- Veo 3.1 Fast video with soundTurn the edited photo into a short video with soundfrom $0.811
Ready in a minute
Connect your AIFor developers: endpoint, inputs and an example response
POST https://tollnode.com/api/v1/nodes/ideogram-4-5-edit
Input
| Field | Type | Notes |
|---|---|---|
| mask | string | Optional black-and-white mask (https URL): black areas are edited. Or send the file inline as a base64 data: URI (up to 4.5 MB) |
| seed | integer | |
| image* | string | Image to edit (https URL). Or send the file inline as a base64 data: URI (up to 4.5 MB) |
| prompt* | string | What to create or change |
| quality | enum | Sets the price. Default medium (very_low, low, medium, high) |
| reference_images | array | Optional reference images to guide the edit (https URLs). Or send the file inline as a base64 data: URI (up to 4.5 MB) |
Example response
{
"images": [
"https://tollnode.com/api/v1/files/00000000-0000-0000-0000-000000000000/0"
]
}Also described in the OpenAPI file and llms.txt. Setup for every app: Agents & MCP.