Ideogram 3.0 Edit

Ideogram 3.0 Edit lets you inpaint images with surgical control. Upload an image, mask a region, then refine layout or text while the rest stays intact. Ideal for typography fixes, layout tweaks, brand updates, and production safe visual polish in existing assets.

Complete technical specification for integration
Ready-to-use code snippets for common workflows
Retro Vending Machine Rebrand

Replace only the masked vending machine branding area with a bold mid-century soda brand design reading 'FIZZROCKET' in crisp legible retro typography, cream and turquoise enamel lettering, small starburst accents, authentic printed product labels, slightly aged but clean commercial finish, perfectly integrated perspective, preserve all unmasked chrome surfaces, diner background, floor reflections, lighting, and camera framing
import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
model: 'ideogram:4@3',
positivePrompt: 'Replace only the masked vending machine branding area with a bold mid-century soda brand design reading \'FIZZROCKET\' in crisp legible retro typography, cream and turquoise enamel lettering, small starburst accents, authentic printed product labels, slightly aged but clean commercial finish, perfectly integrated perspective, preserve all unmasked chrome surfaces, diner background, floor reflections, lighting, and camera framing',
providerSettings: {
ideogram: {
renderingSpeed: 'QUALITY',
magicPrompt: 'OFF',
styleType: 'DESIGN',
stylePreset: 'BAUHAUS'
}
},
inputs: {
seedImage: 'https://assets.runware.ai/assets/inputs/b0ec5523-9d79-4973-a0dc-03be847d7ff7.jpg',
maskImage: 'https://assets.runware.ai/assets/inputs/68dfcc5a-b894-4546-9e42-fb7de460fb91.jpg'
}
})import asyncio
import os
from runware import Runware
async def main():
async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
results = await client.run({
"model": "ideogram:4@3",
"positivePrompt": "Replace only the masked vending machine branding area with a bold mid-century soda brand design reading 'FIZZROCKET' in crisp legible retro typography, cream and turquoise enamel lettering, small starburst accents, authentic printed product labels, slightly aged but clean commercial finish, perfectly integrated perspective, preserve all unmasked chrome surfaces, diner background, floor reflections, lighting, and camera framing",
"providerSettings": {
"ideogram": {
"renderingSpeed": "QUALITY",
"magicPrompt": "OFF",
"styleType": "DESIGN",
"stylePreset": "BAUHAUS"
}
},
"inputs": {
"seedImage": "https://assets.runware.ai/assets/inputs/b0ec5523-9d79-4973-a0dc-03be847d7ff7.jpg",
"maskImage": "https://assets.runware.ai/assets/inputs/68dfcc5a-b894-4546-9e42-fb7de460fb91.jpg"
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "imageInference",
"taskUUID": "c2e0416b-6cc1-4345-a8c1-31d473101eea",
"model": "ideogram:4@3",
"positivePrompt": "Replace only the masked vending machine branding area with a bold mid-century soda brand design reading 'FIZZROCKET' in crisp legible retro typography, cream and turquoise enamel lettering, small starburst accents, authentic printed product labels, slightly aged but clean commercial finish, perfectly integrated perspective, preserve all unmasked chrome surfaces, diner background, floor reflections, lighting, and camera framing",
"providerSettings": {
"ideogram": {
"renderingSpeed": "QUALITY",
"magicPrompt": "OFF",
"styleType": "DESIGN",
"stylePreset": "BAUHAUS"
}
},
"inputs": {
"seedImage": "https://assets.runware.ai/assets/inputs/b0ec5523-9d79-4973-a0dc-03be847d7ff7.jpg",
"maskImage": "https://assets.runware.ai/assets/inputs/68dfcc5a-b894-4546-9e42-fb7de460fb91.jpg"
}
}
]'runware run ideogram:4@3 \
positivePrompt="Replace only the masked vending machine branding area with a bold mid-century soda brand design reading 'FIZZROCKET' in crisp legible retro typography, cream and turquoise enamel lettering, small starburst accents, authentic printed product labels, slightly aged but clean commercial finish, perfectly integrated perspective, preserve all unmasked chrome surfaces, diner background, floor reflections, lighting, and camera framing" \
providerSettings.ideogram.renderingSpeed=QUALITY \
providerSettings.ideogram.magicPrompt=OFF \
providerSettings.ideogram.styleType=DESIGN \
providerSettings.ideogram.stylePreset=BAUHAUS \
inputs.seedImage=https://assets.runware.ai/assets/inputs/b0ec5523-9d79-4973-a0dc-03be847d7ff7.jpg \
inputs.maskImage=https://assets.runware.ai/assets/inputs/68dfcc5a-b894-4546-9e42-fb7de460fb91.jpg{
"taskType": "imageInference",
"taskUUID": "c2e0416b-6cc1-4345-a8c1-31d473101eea",
"model": "ideogram:4@3",
"positivePrompt": "Replace only the masked vending machine branding area with a bold mid-century soda brand design reading 'FIZZROCKET' in crisp legible retro typography, cream and turquoise enamel lettering, small starburst accents, authentic printed product labels, slightly aged but clean commercial finish, perfectly integrated perspective, preserve all unmasked chrome surfaces, diner background, floor reflections, lighting, and camera framing",
"providerSettings": {
"ideogram": {
"renderingSpeed": "QUALITY",
"magicPrompt": "OFF",
"styleType": "DESIGN",
"stylePreset": "BAUHAUS"
}
},
"inputs": {
"seedImage": "https://assets.runware.ai/assets/inputs/b0ec5523-9d79-4973-a0dc-03be847d7ff7.jpg",
"maskImage": "https://assets.runware.ai/assets/inputs/68dfcc5a-b894-4546-9e42-fb7de460fb91.jpg"
}
}{
"taskType": "imageInference",
"taskUUID": "c2e0416b-6cc1-4345-a8c1-31d473101eea",
"imageUUID": "189f150a-9307-41e3-bacd-b61610714c0a",
"imageURL": "https://im.runware.ai/image/os/a12d13/ws/2/ii/189f150a-9307-41e3-bacd-b61610714c0a.jpg",
"seed": 1101883378,
"cost": 0.09
}Aquarium Kiosk Menu Revision

Edit only the masked hanging menu board area. Replace the cluttered old board with a refined contemporary café menu design that fits the aquarium interior. Use crisp legible typography, balanced spacing, soft sea-glass color accents, and realistic printed sign materials. Include the text: 'Drift Cafe' at the top, then sections 'COFFEE', 'SPARKLING', and 'BAKERY'. Under COFFEE: 'Espresso 4', 'Flat White 5', 'Cold Brew 5'. Under SPARKLING: 'Citrus Tonic 6', 'Ginger Lime 6'. Under BAKERY: 'Miso Biscuit 4', 'Pear Tart 5'. Keep perspective, lighting, shadows, and mounting consistent with the original scene. Preserve everything outside the mask unchanged.
import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
model: 'ideogram:4@3',
positivePrompt: 'Edit only the masked hanging menu board area. Replace the cluttered old board with a refined contemporary café menu design that fits the aquarium interior. Use crisp legible typography, balanced spacing, soft sea-glass color accents, and realistic printed sign materials. Include the text: \'Drift Cafe\' at the top, then sections \'COFFEE\', \'SPARKLING\', and \'BAKERY\'. Under COFFEE: \'Espresso 4\', \'Flat White 5\', \'Cold Brew 5\'. Under SPARKLING: \'Citrus Tonic 6\', \'Ginger Lime 6\'. Under BAKERY: \'Miso Biscuit 4\', \'Pear Tart 5\'. Keep perspective, lighting, shadows, and mounting consistent with the original scene. Preserve everything outside the mask unchanged.',
providerSettings: {
ideogram: {
renderingSpeed: 'QUALITY',
magicPrompt: 'OFF',
styleType: 'DESIGN',
stylePreset: 'MAGAZINE_EDITORIAL'
}
},
inputs: {
seedImage: 'https://assets.runware.ai/assets/inputs/a68c7d4b-3570-4ed8-8ecd-b545479cf8e2.jpg',
maskImage: 'https://assets.runware.ai/assets/inputs/295882c1-7cc2-4720-be9b-b4e309aec1de.jpg'
}
})import asyncio
import os
from runware import Runware
async def main():
async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
results = await client.run({
"model": "ideogram:4@3",
"positivePrompt": "Edit only the masked hanging menu board area. Replace the cluttered old board with a refined contemporary café menu design that fits the aquarium interior. Use crisp legible typography, balanced spacing, soft sea-glass color accents, and realistic printed sign materials. Include the text: 'Drift Cafe' at the top, then sections 'COFFEE', 'SPARKLING', and 'BAKERY'. Under COFFEE: 'Espresso 4', 'Flat White 5', 'Cold Brew 5'. Under SPARKLING: 'Citrus Tonic 6', 'Ginger Lime 6'. Under BAKERY: 'Miso Biscuit 4', 'Pear Tart 5'. Keep perspective, lighting, shadows, and mounting consistent with the original scene. Preserve everything outside the mask unchanged.",
"providerSettings": {
"ideogram": {
"renderingSpeed": "QUALITY",
"magicPrompt": "OFF",
"styleType": "DESIGN",
"stylePreset": "MAGAZINE_EDITORIAL"
}
},
"inputs": {
"seedImage": "https://assets.runware.ai/assets/inputs/a68c7d4b-3570-4ed8-8ecd-b545479cf8e2.jpg",
"maskImage": "https://assets.runware.ai/assets/inputs/295882c1-7cc2-4720-be9b-b4e309aec1de.jpg"
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "imageInference",
"taskUUID": "f1686893-e02a-4c87-9c9d-a1e5bceb700a",
"model": "ideogram:4@3",
"positivePrompt": "Edit only the masked hanging menu board area. Replace the cluttered old board with a refined contemporary café menu design that fits the aquarium interior. Use crisp legible typography, balanced spacing, soft sea-glass color accents, and realistic printed sign materials. Include the text: 'Drift Cafe' at the top, then sections 'COFFEE', 'SPARKLING', and 'BAKERY'. Under COFFEE: 'Espresso 4', 'Flat White 5', 'Cold Brew 5'. Under SPARKLING: 'Citrus Tonic 6', 'Ginger Lime 6'. Under BAKERY: 'Miso Biscuit 4', 'Pear Tart 5'. Keep perspective, lighting, shadows, and mounting consistent with the original scene. Preserve everything outside the mask unchanged.",
"providerSettings": {
"ideogram": {
"renderingSpeed": "QUALITY",
"magicPrompt": "OFF",
"styleType": "DESIGN",
"stylePreset": "MAGAZINE_EDITORIAL"
}
},
"inputs": {
"seedImage": "https://assets.runware.ai/assets/inputs/a68c7d4b-3570-4ed8-8ecd-b545479cf8e2.jpg",
"maskImage": "https://assets.runware.ai/assets/inputs/295882c1-7cc2-4720-be9b-b4e309aec1de.jpg"
}
}
]'runware run ideogram:4@3 \
positivePrompt="Edit only the masked hanging menu board area. Replace the cluttered old board with a refined contemporary café menu design that fits the aquarium interior. Use crisp legible typography, balanced spacing, soft sea-glass color accents, and realistic printed sign materials. Include the text: 'Drift Cafe' at the top, then sections 'COFFEE', 'SPARKLING', and 'BAKERY'. Under COFFEE: 'Espresso 4', 'Flat White 5', 'Cold Brew 5'. Under SPARKLING: 'Citrus Tonic 6', 'Ginger Lime 6'. Under BAKERY: 'Miso Biscuit 4', 'Pear Tart 5'. Keep perspective, lighting, shadows, and mounting consistent with the original scene. Preserve everything outside the mask unchanged." \
providerSettings.ideogram.renderingSpeed=QUALITY \
providerSettings.ideogram.magicPrompt=OFF \
providerSettings.ideogram.styleType=DESIGN \
providerSettings.ideogram.stylePreset=MAGAZINE_EDITORIAL \
inputs.seedImage=https://assets.runware.ai/assets/inputs/a68c7d4b-3570-4ed8-8ecd-b545479cf8e2.jpg \
inputs.maskImage=https://assets.runware.ai/assets/inputs/295882c1-7cc2-4720-be9b-b4e309aec1de.jpg{
"taskType": "imageInference",
"taskUUID": "f1686893-e02a-4c87-9c9d-a1e5bceb700a",
"model": "ideogram:4@3",
"positivePrompt": "Edit only the masked hanging menu board area. Replace the cluttered old board with a refined contemporary café menu design that fits the aquarium interior. Use crisp legible typography, balanced spacing, soft sea-glass color accents, and realistic printed sign materials. Include the text: 'Drift Cafe' at the top, then sections 'COFFEE', 'SPARKLING', and 'BAKERY'. Under COFFEE: 'Espresso 4', 'Flat White 5', 'Cold Brew 5'. Under SPARKLING: 'Citrus Tonic 6', 'Ginger Lime 6'. Under BAKERY: 'Miso Biscuit 4', 'Pear Tart 5'. Keep perspective, lighting, shadows, and mounting consistent with the original scene. Preserve everything outside the mask unchanged.",
"providerSettings": {
"ideogram": {
"renderingSpeed": "QUALITY",
"magicPrompt": "OFF",
"styleType": "DESIGN",
"stylePreset": "MAGAZINE_EDITORIAL"
}
},
"inputs": {
"seedImage": "https://assets.runware.ai/assets/inputs/a68c7d4b-3570-4ed8-8ecd-b545479cf8e2.jpg",
"maskImage": "https://assets.runware.ai/assets/inputs/295882c1-7cc2-4720-be9b-b4e309aec1de.jpg"
}
}{
"taskType": "imageInference",
"taskUUID": "f1686893-e02a-4c87-9c9d-a1e5bceb700a",
"imageUUID": "f54f5c3f-5b63-4ef0-b745-503c0a8b83b2",
"imageURL": "https://im.runware.ai/image/os/a13d12/ws/2/ii/f54f5c3f-5b63-4ef0-b745-503c0a8b83b2.jpg",
"seed": 910758514,
"cost": 0.09
}Wayfinding Mural Typography Refresh

Edit only the masked area of the existing atrium wayfinding mural. Replace the outdated text block with refined environmental graphic design that reads exactly: "NORTH HALL", "Studios 1-4", "Workshops", "Ticket Desk". Add simple geometric arrow icons and a clean visual hierarchy, aligned to the wall perspective. Preserve the surrounding painted mural, wall texture, lighting, shadows, floor reflections, and architectural details unchanged. Sophisticated civic interior branding, highly legible typography, polished color palette of cobalt, cream, and terracotta, realistic integration.
import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
model: 'ideogram:4@3',
positivePrompt: 'Edit only the masked area of the existing atrium wayfinding mural. Replace the outdated text block with refined environmental graphic design that reads exactly: "NORTH HALL", "Studios 1-4", "Workshops", "Ticket Desk". Add simple geometric arrow icons and a clean visual hierarchy, aligned to the wall perspective. Preserve the surrounding painted mural, wall texture, lighting, shadows, floor reflections, and architectural details unchanged. Sophisticated civic interior branding, highly legible typography, polished color palette of cobalt, cream, and terracotta, realistic integration.',
providerSettings: {
ideogram: {
renderingSpeed: 'QUALITY',
magicPrompt: 'OFF',
styleType: 'DESIGN',
stylePreset: 'BAUHAUS'
}
},
inputs: {
seedImage: 'https://assets.runware.ai/assets/inputs/8de2e5e8-dd50-46dc-a5e3-4a8a33e429f0.jpg',
maskImage: 'https://assets.runware.ai/assets/inputs/63a93508-6e34-41ce-82a8-d387c3360b6e.jpg'
}
})import asyncio
import os
from runware import Runware
async def main():
async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
results = await client.run({
"model": "ideogram:4@3",
"positivePrompt": "Edit only the masked area of the existing atrium wayfinding mural. Replace the outdated text block with refined environmental graphic design that reads exactly: \"NORTH HALL\", \"Studios 1-4\", \"Workshops\", \"Ticket Desk\". Add simple geometric arrow icons and a clean visual hierarchy, aligned to the wall perspective. Preserve the surrounding painted mural, wall texture, lighting, shadows, floor reflections, and architectural details unchanged. Sophisticated civic interior branding, highly legible typography, polished color palette of cobalt, cream, and terracotta, realistic integration.",
"providerSettings": {
"ideogram": {
"renderingSpeed": "QUALITY",
"magicPrompt": "OFF",
"styleType": "DESIGN",
"stylePreset": "BAUHAUS"
}
},
"inputs": {
"seedImage": "https://assets.runware.ai/assets/inputs/8de2e5e8-dd50-46dc-a5e3-4a8a33e429f0.jpg",
"maskImage": "https://assets.runware.ai/assets/inputs/63a93508-6e34-41ce-82a8-d387c3360b6e.jpg"
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "imageInference",
"taskUUID": "828afc8c-87fb-42dd-a5ce-5cf4cdfc702e",
"model": "ideogram:4@3",
"positivePrompt": "Edit only the masked area of the existing atrium wayfinding mural. Replace the outdated text block with refined environmental graphic design that reads exactly: \"NORTH HALL\", \"Studios 1-4\", \"Workshops\", \"Ticket Desk\". Add simple geometric arrow icons and a clean visual hierarchy, aligned to the wall perspective. Preserve the surrounding painted mural, wall texture, lighting, shadows, floor reflections, and architectural details unchanged. Sophisticated civic interior branding, highly legible typography, polished color palette of cobalt, cream, and terracotta, realistic integration.",
"providerSettings": {
"ideogram": {
"renderingSpeed": "QUALITY",
"magicPrompt": "OFF",
"styleType": "DESIGN",
"stylePreset": "BAUHAUS"
}
},
"inputs": {
"seedImage": "https://assets.runware.ai/assets/inputs/8de2e5e8-dd50-46dc-a5e3-4a8a33e429f0.jpg",
"maskImage": "https://assets.runware.ai/assets/inputs/63a93508-6e34-41ce-82a8-d387c3360b6e.jpg"
}
}
]'runware run ideogram:4@3 \
positivePrompt="Edit only the masked area of the existing atrium wayfinding mural. Replace the outdated text block with refined environmental graphic design that reads exactly: \"NORTH HALL\", \"Studios 1-4\", \"Workshops\", \"Ticket Desk\". Add simple geometric arrow icons and a clean visual hierarchy, aligned to the wall perspective. Preserve the surrounding painted mural, wall texture, lighting, shadows, floor reflections, and architectural details unchanged. Sophisticated civic interior branding, highly legible typography, polished color palette of cobalt, cream, and terracotta, realistic integration." \
providerSettings.ideogram.renderingSpeed=QUALITY \
providerSettings.ideogram.magicPrompt=OFF \
providerSettings.ideogram.styleType=DESIGN \
providerSettings.ideogram.stylePreset=BAUHAUS \
inputs.seedImage=https://assets.runware.ai/assets/inputs/8de2e5e8-dd50-46dc-a5e3-4a8a33e429f0.jpg \
inputs.maskImage=https://assets.runware.ai/assets/inputs/63a93508-6e34-41ce-82a8-d387c3360b6e.jpg{
"taskType": "imageInference",
"taskUUID": "828afc8c-87fb-42dd-a5ce-5cf4cdfc702e",
"model": "ideogram:4@3",
"positivePrompt": "Edit only the masked area of the existing atrium wayfinding mural. Replace the outdated text block with refined environmental graphic design that reads exactly: \"NORTH HALL\", \"Studios 1-4\", \"Workshops\", \"Ticket Desk\". Add simple geometric arrow icons and a clean visual hierarchy, aligned to the wall perspective. Preserve the surrounding painted mural, wall texture, lighting, shadows, floor reflections, and architectural details unchanged. Sophisticated civic interior branding, highly legible typography, polished color palette of cobalt, cream, and terracotta, realistic integration.",
"providerSettings": {
"ideogram": {
"renderingSpeed": "QUALITY",
"magicPrompt": "OFF",
"styleType": "DESIGN",
"stylePreset": "BAUHAUS"
}
},
"inputs": {
"seedImage": "https://assets.runware.ai/assets/inputs/8de2e5e8-dd50-46dc-a5e3-4a8a33e429f0.jpg",
"maskImage": "https://assets.runware.ai/assets/inputs/63a93508-6e34-41ce-82a8-d387c3360b6e.jpg"
}
}{
"taskType": "imageInference",
"taskUUID": "828afc8c-87fb-42dd-a5ce-5cf4cdfc702e",
"imageUUID": "8e3de1f7-076c-4738-b119-77e1a7fb7d40",
"imageURL": "https://im.runware.ai/image/os/a13d12/ws/2/ii/8e3de1f7-076c-4738-b119-77e1a7fb7d40.jpg",
"seed": 1719207258,
"cost": 0.09
}