Ideogram 4.5 Text to Image API

POST Base URL: https://api.hiapi.ai /v1/tasks

Image, video, and audio models are called through theUnified Async API POST /v1/tasks endpoint; only the input fields differ (see input parameters below).

Model summary

Model name	ideogram-v4.5
Type	Image generation (text-to-image)
Endpoint	POST /v1/tasks
Pricing	See HiAPI Pricing

Ideogram 4.5 text-to-image is built for typography-led images such as logos, wordmarks, posters, and signage, with low, medium, and high quality tiers and 1–8 outputs.

Production guidance

For production, pass callback.url at the top level so HiAPI can notify your service when the task reaches a terminal state.
GET /v1/tasks/:id is useful for local debugging, low-volume jobs, or reconciliation after a missed callback.
Both success and fail are terminal states; deduplicate handling by taskId.

Best suited for

Typography-led brand visuals

Use it for logos, wordmarks, posters, and signage that need clear in-image text.

promptquality

Three quality tiers

Choose low, medium, or high for exploration, everyday work, or final detail.

quality

Batch outputs

Request 1–8 images in one task to compare composition directions.

num_images

Request parameters

POST https://api.hiapi.ai/v1/tasks

# Create an async task — returns taskId immediately (generation runs async)
# Replace YOUR_API_KEY with your account API key
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "ideogram-v4.5",
  "input": {
    "prompt": "Minimal modern brand poster for a design conference. Huge bold headline text \"DESIGN FORWARD\" centered, smaller subtitle \"Typography Summit 2026\" below, clean Swiss grid layout, warm orange and deep navy palette, geometric shapes, crisp sharp lettering",
    "quality": "low",
    "image_size": "landscape_16_9",
    "num_images": 1
  }
}'

import requests, json

# Business params — fields vary by model (see the model page)
payload = json.loads(r'''
{
  "model": "ideogram-v4.5",
  "input": {
    "prompt": "Minimal modern brand poster for a design conference. Huge bold headline text \"DESIGN FORWARD\" centered, smaller subtitle \"Typography Summit 2026\" below, clean Swiss grid layout, warm orange and deep navy palette, geometric shapes, crisp sharp lettering",
    "quality": "low",
    "image_size": "landscape_16_9",
    "num_images": 1
  }
}
''')

# Create an async task — returns taskId immediately (generation runs async)
resp = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"},
    json=payload,
)
print(resp.json())  # Returns { code, message, data: { taskId } }

// Create an async task — returns taskId immediately (generation runs async)
// Replace YOUR_API_KEY with your account API key
const resp = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "ideogram-v4.5",
  "input": {
    "prompt": "Minimal modern brand poster for a design conference. Huge bold headline text \"DESIGN FORWARD\" centered, smaller subtitle \"Typography Summit 2026\" below, clean Swiss grid layout, warm orange and deep navy palette, geometric shapes, crisp sharp lettering",
    "quality": "low",
    "image_size": "landscape_16_9",
    "num_images": 1
  }
}),
});
console.log(await resp.json()); // Returns { code, message, data: { taskId } }

model string required

Fixed value ideogram-v4.5.

example ideogram-v4.5

input object required

Business parameters for Ideogram 4.5 text-to-image.

prompt string required

Describe the image and spell out any text that should appear. Length: 1–10,000 characters.

quality enum optional

Output quality tier. Use low for quick exploration and high for more detailed final images.

default medium enum: lowmediumhigh

image_size enum optional

Output size preset. Text-to-image uses square_hd when omitted.

default square_hd enum: squaresquare_hdportrait_4_3landscape_4_3portrait_16_9landscape_16_9

enable_prompt_expansion boolean optional

Whether to expand the prompt with additional visual detail.

default true

num_images integer optional

Number of images to generate in one task, from 1 to 8.

default 1

seed integer optional

Optional random seed that can help reproduce a result with the same input.

callback object optional

Optional callback configuration. When set, HiAPI notifies your service when the task reaches a terminal state.

url string required

Required when callback is set; HTTPS URL that receives terminal task notifications.

example https://your-domain.com/hiapi/callback

when enum optional

Callback trigger timing. Use final.

default final enum: final

Example requests

Design conference poster

Low tier, landscape 16:9, with a clear headline and subtitle hierarchy.

Request body

{
  "model": "ideogram-v4.5",
  "input": {
    "prompt": "Minimal modern brand poster for a design conference. Huge bold headline text \"DESIGN FORWARD\" centered, smaller subtitle \"Typography Summit 2026\" below, clean Swiss grid layout, warm orange and deep navy palette, geometric shapes, crisp sharp lettering",
    "quality": "low",
    "image_size": "landscape_16_9",
    "num_images": 1
  }
}

Coffee shop wordmark

Low tier, square, a hand-drawn serif wordmark with a tagline.

Request body

{
  "model": "ideogram-v4.5",
  "input": {
    "prompt": "Elegant wordmark logo for a specialty coffee shop called \"Ember & Oak\", hand-drawn serif lettering with a small coffee bean emblem, tagline \"Small Batch Roasters\" beneath, cream background, dark brown ink, centered, vector style",
    "quality": "low",
    "image_size": "square_hd",
    "num_images": 1
  }
}

Getting the result

The response returns a taskId immediately.
In production, prefer callback.url for terminal notifications; poll GET /v1/tasks/:id for local debugging.
When status=success, download the image from output[].url.
When status=fail, fix the request from the returned error.

FAQ

What is Ideogram 4.5 text-to-image good for?

It is suited to logos, wordmarks, posters, signage, and other images that need clear in-image text.

How should I choose quality?

Use low for quick exploration, medium for everyday work, and high when the final image needs more detail.