Ideogram V4.6 Text-to-Image API

ideogram-ai/ideogram-v4.6

Ideogram V4.6 Text-to-Image generates images from written prompts with output up to 4K and optional transparent backgrounds for posters, packaging concepts, logos and other design work. Available through the WaveSpeed REST API.

Text to Image
Input

Idle

A premium fashion magazine cover featuring a striking young Western male model, photographed from the waist up in a confident three-quarter pose. He wears a dramatic white tailored editorial outfit with a sculptural silhouette, combining high-fashion elegance and modern masculine styling. Natural skin texture with visible pores, realistic hair strands, refined facial structure, polished editorial lighting, clean warm-gray studio background.
Large elegant masthead at the top reads exactly:
“MODERN”
Main headline:
“THE NEW LANGUAGE OF STYLE”
Secondary cover lines:
“FASHION / DESIGN / CULTURE”
“25 NEW IDEAS FOR 2027”
“THE FUTURE FEELS HUMAN”
Sophisticated Swiss-inspired editorial layout, strong typographic hierarchy, elegant serif and clean sans-serif typography, premium international fashion magazine aesthetic, realistic photography, sharp readable text, polished print design.

$0.06per run·~16 / $1

ExamplesView all

A premium fashion magazine cover featuring a striking young Western male model, photographed from the waist up in a confident three-quarter pose. He wears a dramatic white tailored editorial outfit with a sculptural silhouette, combining high-fashion elegance and modern masculine styling. Natural skin texture with visible pores, realistic hair strands, refined facial structure, polished editorial lighting, clean warm-gray studio background.
Large elegant masthead at the top reads exactly:
“MODERN”
Main headline:
“THE NEW LANGUAGE OF STYLE”
Secondary cover lines:
“FASHION / DESIGN / CULTURE”
“25 NEW IDEAS FOR 2027”
“THE FUTURE FEELS HUMAN”
Sophisticated Swiss-inspired editorial layout, strong typographic hierarchy, elegant serif and clean sans-serif typography, premium international fashion magazine aesthetic, realistic photography, sharp readable text, polished print design.

A premium fashion magazine cover featuring a striking young Western male model, photographed from the waist up in a confident three-quarter pose. He wears a dramatic white tailored editorial outfit with a sculptural silhouette, combining high-fashion elegance and modern masculine styling. Natural skin texture with visible pores, realistic hair strands, refined facial structure, polished editorial lighting, clean warm-gray studio background. Large elegant masthead at the top reads exactly: “MODERN” Main headline: “THE NEW LANGUAGE OF STYLE” Secondary cover lines: “FASHION / DESIGN / CULTURE” “25 NEW IDEAS FOR 2027” “THE FUTURE FEELS HUMAN” Sophisticated Swiss-inspired editorial layout, strong typographic hierarchy, elegant serif and clean sans-serif typography, premium international fashion magazine aesthetic, realistic photography, sharp readable text, polished print design.

A vintage travel poster of a lighthouse on a rocky coast at sunset, with the title "CAPE AURORA" in bold art-deco lettering at the top and "VISIT THE NORTHERN SHORE" at the bottom

A vintage travel poster of a lighthouse on a rocky coast at sunset, with the title "CAPE AURORA" in bold art-deco lettering at the top and "VISIT THE NORTHERN SHORE" at the bottom

A cinematic technology launch poster featuring a stylish young Western male presenter standing beside a sleek translucent AI device. Dark graphite stage, subtle cyan-white lighting, realistic skin, brushed metal, glass, and LED reflections.
Large headline:
“WAVESPEEDAI”
Subheadline:
“INTELLIGENCE, REIMAGINED.”
Three clean feature labels:
“VISION”
“VOICE”
“CREATION”
Bottom information:
“NOVEMBER 28”
“10:00 AM PT”
“LIVE WORLDWIDE”
Premium technology keynote visual design, precise grid layout, clean modern sans-serif typography, strong visual hierarchy, realistic commercial photography, perfectly readable text.

A cinematic technology launch poster featuring a stylish young Western male presenter standing beside a sleek translucent AI device. Dark graphite stage, subtle cyan-white lighting, realistic skin, brushed metal, glass, and LED reflections. Large headline: “WAVESPEEDAI” Subheadline: “INTELLIGENCE, REIMAGINED.” Three clean feature labels: “VISION” “VOICE” “CREATION” Bottom information: “NOVEMBER 28” “10:00 AM PT” “LIVE WORLDWIDE” Premium technology keynote visual design, precise grid layout, clean modern sans-serif typography, strong visual hierarchy, realistic commercial photography, perfectly readable text.

Related Models

README

Ideogram V4.6

Ideogram V4.6 generates images from text, with output up to 4K and an optional transparent background. It is well suited to posters, packaging, advertising, logos, brand assets and any design where readable text matters.

Why Choose This?

  • Typography-focused generation — Create concepts for headlines, labels, signs and packaging text.
  • Native 4K — Choose 1k, 2k or 4k (4096 px on the long side).
  • Transparent background — Set background to transparent for a PNG with an alpha channel, ready for logos and stickers.
  • Color guidance — Describe a palette or include color values in the prompt.
  • Four quality tiers — very_low, low, medium or high.

Parameters

ParameterRequiredDescription
promptYesText description of the image to generate (1–10000 characters).
resolutionNo1k, 2k or 4k. Default: 1k.
aspect_ratioNo1:1, 4:3, 3:4, 3:2, 2:3, 16:9 or 9:16. Default: 1:1.
qualityNovery_low, low, medium or high. Default: medium. very_low is available up to 2k.
backgroundNoopaque or transparent. Default: opaque.

Pricing

Quality1k / 2k4k
very_low$0.008—
low$0.03$0.06
medium$0.06$0.12
high$0.10$0.20

A default request (1k, medium) costs $0.06 per image. aspect_ratio and background do not change the price.

Best Use Cases

  • Posters and advertising — Campaign visuals where the headline and hierarchy matter.
  • Logos and stickers — Explore designs with transparent backgrounds.
  • Packaging concepts — Product design concepts with typography and a specified color palette.
  • Large-format output — Native 4K for print and hero images.

Pro Tips

  • Put the exact text to render inside quotation marks.
  • Name the desired colors or include hex values, then review the generated colors.
  • Explore with very_low or low, then render the final at high or 4k.

Notes

  • very_low quality supports 1k and 2k; choose low, medium or high for 4k.
  • Transparent output is provided as PNG. Use a viewer that supports transparency when checking the background.
  • Review spelling, layout, colors and fine details before using the result, especially for text-heavy or branded designs.

Related Models

Note:This website uses AI models provided by third parties. Documentation prices are for reference and may be outdated. The Generate button shows an estimate; the final task charge prevails.

Ideogram v4.6 API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/ideogram-ai/ideogram-v4.6 with your input as JSON. The endpoint returns a prediction id. Start polling the result endpoint around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. On completed, read output values from data.outputs. Examples for Ideogram v4.6 below.

HTTP example
set -euo pipefail

: "${WAVESPEED_API_KEY:?Set WAVESPEED_API_KEY}"

REQUEST_BODY=$(cat <<'JSON'
{
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "resolution": "1k",
    "aspect_ratio": "1:1",
    "quality": "medium",
    "background": "opaque",
    "enable_prompt_expansion": false
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/ideogram-ai/ideogram-v4.6" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d "$REQUEST_BODY")

TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
    -H "Authorization: Bearer $WAVESPEED_API_KEY")
  RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
  STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
  case "$STATUS" in
    completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
    failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
    *) sleep 2 ;;
  esac
done
Node.js example
const submitUrl = "https://api.wavespeed.ai/api/v3/ideogram-ai/ideogram-v4.6";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');

async function requestJson(url, options = {}) {
  const response = await fetch(url, options);
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "resolution": "1k",
        "aspect_ratio": "1:1",
        "quality": "medium",
        "background": "opaque",
        "enable_prompt_expansion": false
}),
});
const task = body.data ?? body;
if (!task.id) throw new Error("Submission response did not contain a prediction id");
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;

// 2. Poll until the prediction finishes.
while (true) {
  const resultBody = await requestJson(resultUrl, {
    headers: { "Authorization": `Bearer ${apiKey}` },
  });
  const result = resultBody.data ?? resultBody;
  if (result.status === "completed") {
    console.log(result.outputs);
    break;
  }
  if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
  await new Promise(resolve => setTimeout(resolve, 2000));
}
Python example
import json
import os
import time
from urllib.request import Request, urlopen

api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "resolution": "1k",
    "aspect_ratio": "1:1",
    "quality": "medium",
    "background": "opaque",
    "enable_prompt_expansion": False
}

def request_json(url, data=None):
    request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
    with urlopen(request) as response:
        return json.load(response)

# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/ideogram-ai/ideogram-v4.6", json.dumps(payload).encode())
task = body.get("data", body)
if not task.get("id"):
    raise RuntimeError("Submission response did not contain a prediction id")
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"

# 2. Poll until the prediction finishes.
while True:
    result_body = request_json(result_url)
    result = result_body.get("data", result_body)
    status = result.get("status")
    if status == "completed":
        print(result.get("outputs", []))
        break
    if status in {"failed", "cancelled", "timeout", "deleted"}:
        raise RuntimeError(result)
    time.sleep(2)

Ideogram v4.6 API — Frequently asked questions

What is the Ideogram v4.6 API?

Ideogram v4.6 is a Ideogram model for image generation, exposed as a REST API on WaveSpeedAI. Ideogram V4.6 Text-to-Image generates images from written prompts with output up to 4K and optional transparent backgrounds for posters, packaging concepts, logos and other design work. Available through the WaveSpeed REST API. You can call it programmatically or try it from the playground above.

How do I call the Ideogram v4.6 API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID. Poll the result endpoint starting around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. The playground generates Python, JavaScript, and cURL examples for submitting requests and polling results. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/ideogram-ai/ideogram-v4.6.

How much does Ideogram v4.6 cost per run or per second?

Ideogram v4.6 starts at $0.06 per run or per second. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Ideogram v4.6 accept?

Key inputs: `prompt`, `aspect_ratio`, `resolution`, `background`, `enable_prompt_expansion`, `quality`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/ideogram-ai/ideogram-v4.6.

How do I get started with the Ideogram v4.6 API?

Sign up for a free WaveSpeedAI account to claim starter credits, copy your API key from /accesskey, then call the endpoint shown in the API tab of the playground. The playground also auto-generates a code sample in Python, JavaScript, or cURL for the parameters you've set.

Can I use Ideogram v4.6 outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (Ideogram). Check the provider's applicable terms and WaveSpeedAI's Terms of Service before commercial use.

llms.txt — ideogram-ai/ideogram-v4.6 for AI agents and LLMs