Ideogram V4.5
Integrate
ideogram/v4.5
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/ideogram/v4.5?wait=20" \
-H "Authorization: Bearer $DOITONG_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Vintage travel poster for an imaginary island, bold art-deco lettering at the top that reads \"ISLA SERENA\", turquoise sea, white cliffs and a small sailboat, warm sunset gradient sky, screen-printed paper texture, the words \"Summer 1936\" at the bottom."
}'
# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
-H "Authorization: Bearer $DOITONG_API_KEY"
const API = "https://api.doitong.com/v1";
const headers = {
"Authorization": "Bearer " + process.env.DOITONG_API_KEY,
"Content-Type": "application/json",
};
// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/ideogram/v4.5?wait=20", {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "Vintage travel poster for an imaginary island, bold art-deco lettering at the top that reads \"ISLA SERENA\", turquoise sea, white cliffs and a small sailboat, warm sunset gradient sky, screen-printed paper texture, the words \"Summer 1936\" at the bottom."
}),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);
// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");
import os
import requests
API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}
payload = {
"prompt": "Vintage travel poster for an imaginary island, bold art-deco lettering at the top that reads \"ISLA SERENA\", turquoise sea, white cliffs and a small sailboat, warm sunset gradient sky, screen-printed paper texture, the words \"Summer 1936\" at the bottom.",
}
# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/ideogram/v4.5", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])
# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])
# 1. Connect once (Claude Code; Cursor, VS Code, Claude Desktop: https://doitong.com/en-US/developers/docs/mcp)
claude mcp add --transport http doitong-models https://api.doitong.com/v1/mcp \
--header "Authorization: Bearer $DOITONG_API_KEY"
# 2. Your agent calls the "run" tool with:
{
"model_id": "ideogram/v4.5",
"input": {
"prompt": "Vintage travel poster for an imaginary island, bold art-deco lettering at the top that reads \"ISLA SERENA\", turquoise sea, white cliffs and a small sailboat, warm sunset gradient sky, screen-printed paper texture, the words \"Summer 1936\" at the bottom."
}
}
Call the Ideogram V4.5 model (ideogram/v4.5) through the Doitong API. Docs for agents: https://doitong.com/en-US/developers/models/ideogram/v4.5.md
POST https://api.doitong.com/v1/run/ideogram/v4.5?wait=20
Authorization: Bearer $DOITONG_API_KEY
Content-Type: application/json
{
"prompt": "Vintage travel poster for an imaginary island, bold art-deco lettering at the top that reads \"ISLA SERENA\", turquoise sea, white cliffs and a small sailboat, warm sunset gradient sky, screen-printed paper texture, the words \"Summer 1936\" at the bottom."
}
If the response status is "queued" or "running", poll GET https://api.doitong.com/v1/requests/REQUEST_ID?wait=20 until it is "succeeded"; the files are in outputs[].url. POST https://api.doitong.com/v1/quote/ideogram/v4.5 with the same body returns the exact price before the run.
This request: $0.06 60 API credits Run it on this page
Your new API key. It is shown only now and is already in the code and in the API key field below. Keep it secret: never put it in code that runs in a browser.
Examples
Build a request
Controls are generated from the model schema. The code and the price update as you change them.
/run/ideogram/v4.5?wait=20
quote → $0.06
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/ideogram/v4.5?wait=20" \
-H "Authorization: Bearer $DOITONG_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Vintage travel poster for an imaginary island, bold art-deco lettering at the top that reads \"ISLA SERENA\", turquoise sea, white cliffs and a small sailboat, warm sunset gradient sky, screen-printed paper texture, the words \"Summer 1936\" at the bottom."
}'
# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
-H "Authorization: Bearer $DOITONG_API_KEY"
const API = "https://api.doitong.com/v1";
const headers = {
"Authorization": "Bearer " + process.env.DOITONG_API_KEY,
"Content-Type": "application/json",
};
// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/ideogram/v4.5?wait=20", {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "Vintage travel poster for an imaginary island, bold art-deco lettering at the top that reads \"ISLA SERENA\", turquoise sea, white cliffs and a small sailboat, warm sunset gradient sky, screen-printed paper texture, the words \"Summer 1936\" at the bottom."
}),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);
// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");
import os
import requests
API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}
payload = {
"prompt": "Vintage travel poster for an imaginary island, bold art-deco lettering at the top that reads \"ISLA SERENA\", turquoise sea, white cliffs and a small sailboat, warm sunset gradient sky, screen-printed paper texture, the words \"Summer 1936\" at the bottom.",
}
# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/ideogram/v4.5", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])
# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "run",
"arguments": {
"model_id": "ideogram/v4.5",
"input": {
"prompt": "Vintage travel poster for an imaginary island, bold art-deco lettering at the top that reads \"ISLA SERENA\", turquoise sea, white cliffs and a small sailboat, warm sunset gradient sky, screen-printed paper texture, the words \"Summer 1936\" at the bottom."
},
"wait_seconds": 20
}
}
}
Run this request
Your key stays in this browser: it is sent only to the Doitong API and saved (localStorage) only if you tick Remember. Get an API key
About Ideogram V4.5
Ideogram V4.5 is one of the most dependable models for exact lettering: logos, shop signs, posters and social graphics with the words spelled right. Low, medium and high quality trade speed and price for detail; image size does not change the price. Optional prompt expansion, a seed, and up to eight images per request.
Parameters
Send either the canonical name or the native name, not both. Canonical names
promptrequired
image_sizeoptional
qualityoptional
enable_prompt_expansionoptional
num_imagesoptional
num_outputs
seedoptional
Output
{
"id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
"object": "request",
"model": "ideogram/v4.5",
"status": "succeeded",
"created_at": "2026-10-20T12:00:00Z",
"started_at": "2026-10-20T12:00:02Z",
"completed_at": "2026-10-20T12:00:09Z",
"queue_position": null,
"cost": {
"credits": 60,
"usd": "0.06",
"charged": 60,
"refunded": 0
},
"input": {
"prompt": "A colorful storefront with a neon sign reading \"Night Owl Coffee\", rainy street reflections",
"quality": "medium",
"image_size": "landscape_4_3"
},
"output": {
"images": [
{
"url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
"content_type": "image/jpeg",
"file_name": "0-output.jpeg",
"file_size": 1843200
}
],
"seed": 42
},
"outputs": [
{
"type": "image",
"url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
"content_type": "image/jpeg",
"file_size": 1843200,
"width": 1024,
"height": 768,
"stored": true
}
],
"error": null,
"metrics": {
"inference_seconds": 6.8
},
"urls": {
"self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
"cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
}
}
Fields of output
- images
- array of object {url, content_type, file_name, file_size}
- seed
- integerSeed value used for random number generation.
Other Ideogram v4.5 variants
More models: Text to Image
For AI agents: this page as Markdown is at https://doitong.com/en-US/developers/models/ideogram/v4.5.md. All models and guides: https://doitong.com/developers/llms.txt







