ideogram/v4.5/text-to-imageIdeogram 4.5 Text to Image turns written prompts into posters, wordmarks and text-rich images, with three quality tiers and 1–8 images per request. It keeps headlines and short copy legible while you pick the aspect ratio or one of 36 exact pixel sizes.
Get API KeyEstimated cost: 44 credits · $0.2200
Credits are reserved when the task is submitted and refunded in full if it fails.
A centered wordmark on warm off-white paper reading exactly "KILN & CLAY" in a rounded serif with a small hand-drawn vase icon above the text. Subtle paper grain, single terracotta ink colour, crisp letter spacing, plenty of empty space around the mark. No brand names, logos, watermark, split screen or comparison panels.
A wide illustrated banner of a mountain hiking trail at sunrise, layered blue ridgelines, a dotted trail line with three numbered markers. A wooden sign on the right reads exactly "SUMMIT 4.2 KM". Soft gouache style, mist in the valleys, calm morning light. No brand names, logos, watermark, split screen or comparison panels.
REST API
This flow submits one valid Ideogram 4.5 Text to Image request, captures its task_id, and reads result file URLs after the asynchronous task ends.
Create an API key, keep it on the server, and send it as Authorization: Bearer VIDGO_API_KEY.
https://api.vidgo.ai/api/generate/submitSend the current model ID and an input object to the unified submit endpoint. input may only contain the fields listed for this endpoint; any other field returns 400.
curl --request POST \
--url "https://api.vidgo.ai/api/generate/submit" \
--header "Authorization: Bearer $VIDGO_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "ideogram/v4.5/text-to-image",
"input": {
"prompt": "A vertical event poster for a riverside night market. Warm paper lanterns strung over a wooden footbridge, a food stall with steam rising, deep teal evening sky. At the top, large hand-lettered headline reading exactly \"NIGHT MARKET\" in cream letters; below it a smaller line reading exactly \"FRIDAY 7 PM\". Clean layout with generous margins, flat print texture, restrained teal, amber and cream palette. No brand names, logos, watermark, split screen or comparison panels.",
"quality": "high",
"size": "9:16",
"n": 1
}
}'Read data.task_id and poll only while status is not_started or running. Stop on both finished and failed.
GET https://api.vidgo.ai/api/generate/status/{task_id}Poll every 2–5 seconds and back off on 429/5xx. Or provide top-level callback_url to receive a terminal-state callback.
not_startedrunningfinishedfailed{
"code": 200,
"data": {
"task_id": "task-example",
"status": "not_started",
"created_time": "2026-11-03T08:00:00"
}
}{
"code": 200,
"data": {
"task_id": "task-example",
"status": "finished",
"created_time": "2026-11-03T08:00:00",
"progress": 100,
"files": [
{
"file_url": "https://example.com/result.png",
"file_type": "image"
}
]
}
}Expand for the same payload end to end, including business-code, missing-task-ID, failed-state, unexpected-state, and network-error handling.
set -euo pipefail
: "${VIDGO_API_KEY:?Set VIDGO_API_KEY in your environment}"
REQUEST_BODY=$(cat <<'JSON'
{
"model": "ideogram/v4.5/text-to-image",
"input": {
"prompt": "A vertical event poster for a riverside night market. Warm paper lanterns strung over a wooden footbridge, a food stall with steam rising, deep teal evening sky. At the top, large hand-lettered headline reading exactly \"NIGHT MARKET\" in cream letters; below it a smaller line reading exactly \"FRIDAY 7 PM\". Clean layout with generous margins, flat print texture, restrained teal, amber and cream palette. No brand names, logos, watermark, split screen or comparison panels.",
"quality": "high",
"size": "9:16",
"n": 1
}
}
JSON
)
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
--request POST \
--url "https://api.vidgo.ai/api/generate/submit" \
--header "Authorization: Bearer $VIDGO_API_KEY" \
--header "Content-Type: application/json" \
--data "$REQUEST_BODY")
TASK_ID=$(printf '%s' "$SUBMIT_RESPONSE" | jq -r '.data.task_id // .task_id // empty')
if [ -z "$TASK_ID" ]; then
printf 'Submit response did not include task_id:
%s
' "$SUBMIT_RESPONSE" >&2
exit 1
fi
while true; do
STATUS_RESPONSE=$(curl --silent --show-error --fail-with-body \
--url "https://api.vidgo.ai/api/generate/status/$TASK_ID" \
--header "Authorization: Bearer $VIDGO_API_KEY")
STATUS=$(printf '%s' "$STATUS_RESPONSE" | jq -r '.data.status // .status // empty')
case "$STATUS" in
finished)
printf '%s' "$STATUS_RESPONSE" | jq -r '(.data.files // .files // [])[]?.file_url'
break
;;
failed)
printf '%s' "$STATUS_RESPONSE" | jq -r '.data.error_message // .error_message // "Generation failed"' >&2
exit 1
;;
not_started|running)
sleep 2
;;
*)
printf 'Unexpected task status: %s
' "$STATUS" >&2
exit 1
;;
esac
doneThis table lists only public fields inside input. See Quick Start for top-level model and optional callback_url usage.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| input.prompt | string | Yes | – | Non-blank text, up to 10,000 characters. Put any wording that must appear in the image inside quotes. |
| input.quality | string | No | medium | low, medium or high. Sets the price per image. |
| input.size | string | No | 1:1 HD | Preset 1:1, 1:1 HD, 4:3, 3:4, 16:9 or 9:16, or one of 36 exact sizes such as 1024x1024, 1280x720, 1440x2560, 2048x2048, 2560x1440, 3072x1024 or 3328x1248. |
| input.n | integer | No | 1 | Number of images, integer 1–8. |
The submit response identifies the task. The status response supplies result files or failure details at a terminal state.
| Field | Type | Description |
|---|---|---|
| code | integer | Business response code; 0 or 200 indicates success. |
| message | string | Optional human-readable response message. |
| data.task_id | string | Unique task ID used for status queries after submission. |
| data.status | string | not_started, running, finished, or failed. |
| data.created_time | string | Task creation timestamp. |
| data.progress | integer | Progress from 0–100 in status responses. |
| data.files[] | array | Generated files in returned order when finished. |
| data.files[].file_url | string | Direct URL of the generated file (.png). |
| data.files[].file_type | string | Result files are identified as image. |
| data.error_message | string | null | Readable failure reason for failed tasks. |
Only the first two states may be polled again. finished and failed are terminal.
not_startedAccepted and queued; wait before checking again.
runningGeneration is in progress; continue polling.
finishedSuccessful terminal state; validate files and read file URLs.
failedFailure terminal state; read error_message and stop. Reserved credits are refunded in full.
| Specification | Value | Details |
|---|---|---|
| Model | ideogram/v4.5/text-to-image | Ideogram 4.5 Text to Image |
| Input | prompt | Text only, up to 10,000 characters |
| Output | PNG image × n (1–8) | Raster image URLs in files[] |
| quality | low / medium / high | 6 / 12 / 44 credits per image |
| size | 6 presets + 36 pixel sizes | Default 1:1 HD |
Ideogram 4.5 Text to Image is an Ideogram model for generating images from written prompts. It renders posters, logos and text-rich graphics at low, medium or high quality, returning one to eight images per request in six preset ratios or 36 exact pixel sizes. Its layout handling keeps quoted headlines and short lines of copy legible inside the composition. You can call it programmatically or try it from the playground above.
Each output image costs 6 credits ($0.03) at low, 12 credits ($0.06) at medium and 44 credits ($0.22) at high. The total is the rate multiplied by n, and the output size does not change the price.
Put the words that must appear inside quotation marks and keep them short, for example a headline and a date line. Describe where the text sits and what style it uses.
The default is 1:1 HD. You can also use 1:1, 4:3, 3:4, 16:9 or 9:16, or one of 36 exact pixel sizes ranging from 720x1280 to 2048x2048, 3072x1024 and 3328x1248.
Set n from 1 to 8. Every image in the batch is billed at the selected quality rate.
low is suited to quick layout exploration, medium is the default balance, and high is intended for final renders. Only the per-image price changes between them.
No. This endpoint accepts a prompt only. To work from an existing picture, use Ideogram 4.5 Edit, which takes one source image plus optional reference images and a mask.
It returns raster images. When you need a scalable vector file, use Ideogram Vector 1.0 Text to Vector, which outputs SVG.
