Ideogram

Ideogram V4.5

ideogram-v4.5/text-to-image

An image generation and editing model excelling at clear typography and precise multi-turn local edits, with native 2K output, ideal for posters, logos, and packaging design

ideogram-v4.5/image-to-image ideogram-v4.5/text-to-image

Try ideogram-v4.5/text-to-image

Input

Showcases

View all showcases

Output

image

Fill in the parameters and run — results show up here.

Pricing

ideogram-v4.5/text-to-image per image

Specifications	Unit Price
low	$0.043
medium	$0.086
high	$0.3145

Positioning Overview

The text-to-image route of Ideogram V4.5 is designed for development scenarios that require stable text layout and controllable image quality. Enter a prompt to generate an image, with six size presets ranging from square to ultra-wide landscape and three quality tiers (low, medium, and high); the random seed can be fixed to reproduce results, and a prompt auto-expansion toggle is provided. Text rendering within images is its standout capability, making it suitable for producing layout-centric assets such as posters, banners, and logo sketches, and for developers who want to integrate image generation into marketing or design pipelines.

Core Highlights

Stable, legible text rendering within images — In assets centered on copy layout, such as posters, logos, and packaging, titles and short text phrases are rendered clearly and reliably.
Quality tiers and size presets — Three quality tiers (low, medium, high) combined with six size presets let you trade off output between draft and final stages.
Reproducible results via seed — Fixing the seed reproduces the same composition, making it easy to compare parameters and run version regressions during batch generation.

Capability Description

Text- and layout-oriented image generation: Prompts can be up to 10,000 characters, making it easy to specify headline copy, font styles, and layout requirements and produce layout-centric visual assets.

Multi-size preset output: Six presets are available — square, square HD, portrait 4:3 and 16:9, and landscape 4:3 and 16:9 — directly matching common formats such as posters, banners, and social images.

Quality tier adjustment: Three quality tiers are adjustable (low, medium, high), with medium as the default, so batch drafts and final outputs can use different tiers.

Prompt auto-expansion: Prompt expansion is enabled by default and can turn a brief description into a complete scene description; disable it when images must strictly follow the original wording.

Seed reproduction: The seed can be specified explicitly; with the same prompt and parameters, results are reproducible, which facilitates controlled parameter tuning.

Use Cases

Marketing design: poster and banner headline copy — Developers or design teams enter prompts containing explicit headline copy and produce landscape or portrait marketing images for direct use in ad placements and campaign pages.
Brand design: logo and mark sketch exploration — Use short prompts to batch-generate logo sketches and variants as candidate assets for early-stage brand visual exploration, then refine them manually.
Product images: packaging and text-layout materials — Enter product names and selling-point copy to produce packaging mockups or product hero images that require text layout, for use in proposal reviews and product-page drafts.
Interactive products: an image-generation interface for design tools — Integrate this route into your own design or content tools, using fixed seeds and size presets for batch generation to support templated asset production.

Limitations and Selection Advice

This route is pure text-to-image and does not accept source image input; editing needs such as inpainting or reference-guided edits should use the image-to-image route in the same family. Each request outputs exactly one image, so batch production requires looping on the caller side. Image quality depends on the selected quality tier: low is suitable for drafts, and medium or high is recommended for final output. Prompt expansion is enabled by default; disable it explicitly when images must strictly follow the original wording. For scenarios involving long-text layout or multi-round iterative retouching, it is advisable to validate results with a small batch first.

What's new

View changelog →

Feature change Ideogram 4.5 text-to-image model ID is now ideogram-v4.5/tex… Oct 21, 2026
New model Added ideogram-v4.5 text-to-image and ideogram-v4.5/image-to… Oct 16, 2026

Frequently asked questions

View all FAQs →

What edits can Ideogram 4.5 Edit do?

Four kinds: prompt edits, reference restyles, mask inpainting and Precise Edit. They can be combined.
Which fields are required?

prompt and image_url. Add reference_image_urls, mask_url, edit_precision, quality, image_size, num_images and seed as needed.
How do regular and Precise Edit differ?

Use Precise Edit for text changes and small fixes, and regular for recolors and restyles. edit_precision=high is Precise Edit and restores unedited pixels; regular is freer.
Do both precisions share quality tiers?

No. regular offers very_low, low, medium and high; Precise Edit offers low, medium and high.

Create a generation task

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

Headers

AuthorizationstringRequired

Account API key. Required on every request. Example: Bearer YOUR_HIAPI_API_KEY. Get your API key

Content-TypestringOptional

The request body is always parsed as JSON; when sent, only application/json (optionally with charset) is accepted — any other value returns 415. Example: application/json.

Idempotency-KeystringOptional

Idempotency key, up to 255 bytes. Retries with the same key from the same account create the task only once; replays return the original taskId.

Idempotency key

On network timeouts or client retries, the same key creates the task only once — no double charges (scope: the API key's account). Use a business-unique identifier as the key (e.g. "order-42"); replays return the original taskId, and keys expire 24 hours after the first request. See the Unified Async API overview for the full scenario matrix.

Body

modelstringRequired

Current fixed value: ideogram-v4.5/text-to-image

routestringOptional

Current fixed value: default

inputobjectRequired

Business parameters for ideogram-v4.5/text-to-image and route default — see the parameter table below.

seedintegerOptional

Random seed used to control the randomness of the generation results; when left empty, the system selects one automatically.

promptstringRequiredminLength 1maxLength 10000

Generation prompt, used to describe the image content you want to generate.

qualitystringOptionalDefault: "medium"

Image quality level for text-to-image generation, default is medium.

Options:lowmediumhigh

image_sizestringOptionalDefault: "square_hd"

Size preset for the output image, default is square_hd.

Options:square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9

num_imagesintegerOptionalDefault: 1min 1max 1

Number of images to generate per request; this parameter must be 1, default is 1.

enable_prompt_expansionbooleanOptionalDefault: true

Whether to enable the prompt expansion provided by the partner, enabled by default.

callbackobjectOptional

Terminal-state notification config. When omitted, no callback is delivered — poll the task yourself. See the callback note below.

Callbacks (Webhook)

Provide callback.url when creating a task and HiAPI POSTs to your service once the task reaches a terminal state — no polling needed. The callback payload mirrors the task detail structure; signature verification, delivery retries and idempotency are documented on the Unified Async API overview page.

urlstringRequired

Required when callback is present. A POST is sent to this URL once the task reaches a terminal state; must be a valid http(s) URL.

whenstringOptionalDefault: "final"

Only final is supported today — notified on both success and fail.

Options:final

storagestringOptionalDefault: "temp"

Artifact storage tier: temp (default, retained about 7 days) or persistent (long-term, billed by size). Insufficient balance or exceeding the storage cap silently downgrades to temp; the effective tier is shown in the task detail response.

Options:temppersistent

Request examples

# Submit an async task; returns a taskId immediately (no waiting for generation)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "ideogram-v4.5/text-to-image",
  "input": {
    "prompt": "…",
    "quality": "medium",
    "image_size": "square_hd",
    "num_images": 1,
    "enable_prompt_expansion": true
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "ideogram-v4.5/text-to-image",
    input: {
      "prompt": "…",
      "quality": "medium",
      "image_size": "square_hd",
      "num_images": 1,
      "enable_prompt_expansion": true
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "ideogram-v4.5/text-to-image",
        "input": {
          "prompt": "…",
          "quality": "medium",
          "image_size": "square_hd",
          "num_images": 1,
          "enable_prompt_expansion": True
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Get task detail

GET https://api.hiapi.ai/v1/tasks/:id

Response fields

taskIdstringRequired

Task ID, always prefixed with tk-hiapi-.

modelstringRequired

Resolved full model name. Tasks submitted with the route parameter return base@route (e.g. gpt-image-2/text-to-image@ext); otherwise identical to the name passed at creation.

routestringOptional

Present only when the task was submitted with an explicit route parameter; echoes the submitted value.

statusstringRequired

Task status.

Status values

queued Queued, not started yet. handling Being processed. archiving Processing finished, artifacts being prepared. success Terminal: completed, artifacts available (output returned). fail Terminal: failed (error returned). After submission, check status: success and fail are terminal, everything else is non-terminal. Poll every 1–3 seconds until terminal. On success, download artifacts from output[].url and transfer them before expireAt; pass storage: "persistent" at creation time when long-term retention is needed.

creatednumberRequired

Task creation time (Unix seconds).

completednumberRequired

Unix seconds when the task reached a terminal state; fixed to 0 while not terminal.

outputarrayOptional

Present only when status == success. Artifact list — always an array; a single task may return multiple types at once (e.g. video + first_frame).

Array [ object ]

Array items

urlstringRequired

Artifact URL, directly downloadable.

typestringRequired

Current possible values: video, image, audio, first_frame, last_frame, thumbnail; more may be added later.

expireAtnumberRequired

Unix seconds until which the artifact remains accessible; download or transfer before it expires.

errorobjectOptional

Present only when status == fail.

codestringRequired

Business error code.

messagestringRequired

Error description.

Response examples

Success

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

Processing (non-terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Failed

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}