Ideogram Image Transformation Routing

Overview

Map a requested image change to the narrowest current Ideogram operation. Keep edit, remix, structured description, prompt assistance, and outcome-focused tools distinct so rights, uploaded bytes, model control, and output review remain visible.

Prerequisites

• Proven rights to process the input and an approved purpose, destination, and retention period.
• Input validation for supported image type, size, dimensions, and any required mask.
• A server-side key, positive credit, content policy, and durable asset store.

Current Contract

Current surfaces include V4 edit with prompt, V4 remix, V4 describe into a structured JSON prompt, V4 magic prompt, V3 edit/remix, and tools for background removal or replacement, object or logo removal, reframe, ad resize, colorways, material swap, upscale, and text layerization. Outcome-focused tools may choose the model; use model endpoints when direct model control is required.

Authentication

Send IDEOGRAM_API_KEY as Api-Key only from a trusted server to https://api.ideogram.ai. Do not log the key, source image, mask, prompt, structured description, output URL, or generated bytes.