Price Quotes
Add dry_run=true to a request and the Ideogram API returns its price instead of running it. The request is validated and priced, but nothing is generated, stored or billed, and no safety review is performed. Send exactly the request you would send to generate, so the quote reflects the same options.
Request a quote
dry_run is a query parameter. Everything else stays the same as the real request:
The response is a PriceQuote object in place of the endpoint’s usual response. This one was returned on November 11, 2026:
Prices change. See API pricing for current rates.
The PriceQuote fields
Money is in millionths of a dollar so you can compare a quote with usage_cost_usd_micros and your balance without rounding.
How a quote relates to the final charge
- An
exactquote is the price of that request at current prices. The price is fixed when Ideogram accepts the real request, so a price change between the quote and the request changes the charge. - An
estimateis for products whose final quantity is known only after the work runs. The final charge uses the actual quantity, up toupper_bound_usd_micros. - A quote doesn’t check your account. It doesn’t look at your balance or your in-flight requests, so the real request can still return
402or429. See Errors and billing and Rate limits.
After a request completes, compare the quote with what you were charged: usage_cost_usd_micros on GET /v2/generations/{generation_id} (present when the request uses variable usage-based pricing) and GET /v2/account/usage.
Estimate a batch
Quote one representative request, then multiply. For 10,000 requests like the one above, each quoted at usd_micros: 60000:
10,000 × 60,000 = 600,000,000 millionths of a dollar, or $600.
This is arithmetic, not a commitment. Requests with different options have different prices, so quote each kind of request you plan to send.
Endpoints without dry_run
These operations don’t take dry_run:
GETendpoints, such asGET /v2/generations/{generation_id}and the account endpointsPOST /v2/image/describe/ideogram-3andPOST /v2/image/describe/ideogram-4POST /v2/tool/ad-variations,POST /v2/tool/model-pose-variantsandPOST /v2/tool/sketch-to-render
An endpoint that takes dry_run can still answer 400 with “Price quotes are not available” for some requests. Each endpoint’s reference lists its parameters.