Ideogram 2a
Image model · Available upstream
Fast text to image generation for design and photography
Generation is available through the published Meldport configurations below. Review the exact quote before submitting.
- Model ID
ideogram-2a- Released
- Feb 27, 2025
- Billing unit
- Generated output
Meldport generation prices
Ideogram 2a
ddd6721e-8d9a-4c07-b639-c9f9319fb6bbtext to image
Default · 1 output
API request and parameters
Use images:generate on your API key. This configuration runs text to image and returns image/jpeg.
This configuration does not require an uploaded image. Choose a different configuration ID to change the workflow or output settings. Send only options listed below.
These output settings are included in this configuration. Select another configuration ID to change them. Do not add them to options.
{
"width": 1024,
"height": 1024
}This configuration has no additional request options.
Replace the prompt and set a unique MELDPORT_IDEMPOTENCY_KEY for this operation. The example quotes the request and then creates one paid job. Read the billing rules before accepting variable charges.
const api = "https://api.meldport.com";
const key = process.env.MELDPORT_API_KEY;
const idempotencyKey = process.env.MELDPORT_IDEMPOTENCY_KEY;
if (!key || !idempotencyKey) throw new Error("Set your API key and a unique operation ID first.");
async function post(path, body) {
const response = await fetch(api + path, {method: "POST",
headers: {Authorization: `Bearer ${key}`, "Content-Type": "application/json"},
body: JSON.stringify(body)});
const result = await response.json();
if (!response.ok) throw new Error(JSON.stringify(result.error));
return result;
}
const request = {
"configuration_id": "ddd6721e-8d9a-4c07-b639-c9f9319fb6bb",
"prompt": "Replace with your prompt or speech script.",
"options": {},
"input_asset_ids": []
};
const {data: quote} = await post("/v1/media/quotes", request);
console.log("Quote:", quote);
const result = await post("/v1/media/jobs", {
...request, idempotency_key: idempotencyKey,
accepted_customer_price_microusd: quote.customer_price_microusd,
accepted_maximum_reservation_microusd: quote.maximum_reservation_microusd,
...(quote.billing_policy_version === "actual-cost-v1"
? {billing_policy_version: "actual-cost-v1"} : {}),
});
console.log(result.job);
// Poll GET /v1/media/jobs/<job.id> with the same API key.
// Keep this operation ID for retries. A new ID requests another generation.Poll the returned job ID. Download only after state is succeeded and billing_state is settled. Polling and download example.
About this model
Ideogram 2a is a fast text to image model built for layouts that need clear structure and legible text. It improves prompt following, spatial control, and subject placement. Use it for graphic design workflows, product shots, logos, posters, and quick visual iterations through the API.