> ## Documentation Index
> Fetch the complete documentation index at: https://runcrate.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Ideogram 3 API — Best AI Text in Images

> Generate images with accurate text rendering using Ideogram 3 — logos, posters, social media graphics, and signage.

export const RuncrateStyles = () => {
  if (typeof document !== 'undefined' && !document.getElementById('runcrate-overrides')) {
    const s = document.createElement('style');
    s.id = 'runcrate-overrides';
    s.textContent = `
      /* Match Runcrate's rounding scale (--radius: 0.75rem) */
      .rounded-sm { border-radius: 0.5rem !important; }   /* 8px */
      .rounded-md { border-radius: 0.625rem !important; } /* 10px */
      .rounded-lg { border-radius: 0.75rem !important; }  /* 12px */
      .rounded-l-sm { border-top-left-radius: 0.5rem !important; border-bottom-left-radius: 0.5rem !important; }
      .rounded-r-sm { border-top-right-radius: 0.5rem !important; border-bottom-right-radius: 0.5rem !important; }
      .rounded-l-md { border-top-left-radius: 0.625rem !important; border-bottom-left-radius: 0.625rem !important; }
      .rounded-r-md { border-top-right-radius: 0.625rem !important; border-bottom-right-radius: 0.625rem !important; }
      .rounded-l-lg { border-top-left-radius: 0.75rem !important; border-bottom-left-radius: 0.75rem !important; }
      .rounded-r-lg { border-top-right-radius: 0.75rem !important; border-bottom-right-radius: 0.75rem !important; }

      /* Cards: never pure white in light mode */
      .card { background-color: #fcfcfc !important; border-radius: 0.75rem !important; }
      html.dark .card { background-color: #141414 !important; }

      /* Docs hero box */
      .rc-hero { background-color: #fcfcfc; border: 1px solid #e0e0e0; }
      html.dark .rc-hero { background-color: #141414; border-color: #242424; }
      html.dark .rc-hero h1 { color: #f5f5f5; }

      /* Runcrate scrollbar — thin, transparent track, hide-until-hover thumb */
      ::-webkit-scrollbar { width: 6px; height: 6px; background-color: transparent; }
      ::-webkit-scrollbar-track { background-color: transparent; }
      ::-webkit-scrollbar-thumb { background-color: rgba(155, 155, 155, 0.5); border-radius: 10px; transition: opacity 0.3s ease; opacity: 0; }
      ::-webkit-scrollbar-thumb:hover { background-color: rgba(155, 155, 155, 0.7); }
      *:hover::-webkit-scrollbar-thumb,
      *:focus::-webkit-scrollbar-thumb,
      *:active::-webkit-scrollbar-thumb { opacity: 1; }
      * { scrollbar-width: thin; scrollbar-color: rgba(155, 155, 155, 0.5) transparent; }
    `;
    document.head.appendChild(s);
  }
  return null;
};

<RuncrateStyles />

Ideogram 3 is the leading model for generating images with accurate, readable text. Logos, event posters, social media graphics — anywhere words need to render correctly inside an image.

## Why Ideogram 3

Most image models distort or misspell text. Ideogram 3.0 is purpose-built for text accuracy.

***

## Basic usage

<CodeGroup>
  ```python Python theme={"theme":"github-dark"}
  from runcrate import Runcrate

  client = Runcrate(api_key="rc_live_YOUR_API_KEY")

  image = client.models.generate_image(
      model="ideogram/ideogram-3.0",
      prompt='A modern coffee shop logo with the text "MORNING RITUAL" in clean sans-serif font, '
             'minimalist design, coffee cup icon, warm earth tones, white background',
      aspect_ratio="1:1",
  )

  image.data[0].save("coffee-logo.png")
  ```

  ```typescript TypeScript theme={"theme":"github-dark"}
  import Runcrate from '@runcrate/sdk';

  const rc = new Runcrate({ apiKey: 'rc_live_YOUR_API_KEY' });

  const image = await rc.models.generateImage({
    model: 'ideogram/ideogram-3.0',
    prompt: 'A modern coffee shop logo with the text "MORNING RITUAL" in clean sans-serif font',
    aspectRatio: '1:1',
  });

  await image.save('coffee-logo.png');
  ```

  ```bash curl theme={"theme":"github-dark"}
  curl https://api.runcrate.ai/v1/images/generations \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer rc_live_YOUR_API_KEY" \
    -d '{
      "model": "ideogram/ideogram-3.0",
      "prompt": "A coffee shop logo with text \"MORNING RITUAL\" in clean sans-serif font",
      "aspect_ratio": "1:1"
    }'
  ```
</CodeGroup>

***

## Social media graphics

```python theme={"theme":"github-dark"}
from runcrate import Runcrate

client = Runcrate(api_key="rc_live_YOUR_API_KEY")

graphics = [
    {"file": "launch.png", "prompt": 'Instagram post with bold text "NOW LIVE" and "v2.0". Dark gradient, subtle confetti.', "ratio": "1:1"},
    {"file": "sale.png", "prompt": 'Banner with large text "50% OFF" and "This Weekend Only". White background, red accents.', "ratio": "16:9"},
    {"file": "quote.png", "prompt": 'Quote card with text "Ship it." in bold serif font, centered. Cream background.', "ratio": "4:3"},
]

for g in graphics:
    image = client.models.generate_image(
        model="ideogram/ideogram-3.0", prompt=g["prompt"], aspect_ratio=g["ratio"],
    )
    image.data[0].save(g["file"])
    print(f"Saved {g['file']}")
```

***

## Event posters

```python theme={"theme":"github-dark"}
from runcrate import Runcrate

client = Runcrate(api_key="rc_live_YOUR_API_KEY")

image = client.models.generate_image(
    model="ideogram/ideogram-3.0",
    prompt='Concert poster with text "JAZZ UNDER THE STARS" in elegant serif. '
           'Below: "FRIDAY JULY 18 • 8PM". Art deco style, navy and gold, saxophone silhouette.',
    aspect_ratio="9:16",
)

image.data[0].save("jazz-poster.png")
```

***

## Vercel AI SDK integration

```typescript theme={"theme":"github-dark"}
// app/api/generate-graphic/route.ts
import { runcrate } from '@runcrate/ai';
import { generateImage } from 'ai';

export async function POST(req: Request) {
  const { prompt, aspectRatio } = await req.json();

  const sizeMap: Record<string, string> = {
    '1:1': '1024x1024', '16:9': '1792x1024', '9:16': '1024x1792',
  };

  const { image } = await generateImage({
    model: runcrate.imageModel('ideogram/ideogram-3.0'),
    prompt,
    size: sizeMap[aspectRatio] || '1024x1024',
  });

  return Response.json({ image: image.base64 });
}
```

***

## Prompting tips for text accuracy

| Tip                      | Example                                               |
| ------------------------ | ----------------------------------------------------- |
| **Quote the exact text** | `'text reads "HELLO"'` not `text saying hello`        |
| **Specify font style**   | `"clean sans-serif"`, `"bold serif"`, `"handwritten"` |
| **Keep text short**      | 2–5 words renders most reliably                       |
| **Describe placement**   | `"centered at the top"`, `"bottom-right corner"`      |

***

## Tips

* **Always quote exact text** in your prompt — this is the most important factor.
* **Shorter text renders better.** 1–4 words is reliable, 5–8 usually works.
* **Seed for iteration**: lock the composition with `seed`, then adjust the prompt.
* **Not a layout tool** — for precise positioning, generate and composite in code.

## Next steps

* [Image generation reference](/models/image-generation)
* [Stable Diffusion API](/examples/stable-diffusion-api) — alternative for non-text images
* [AI Image Generation API](/examples/image-generation-api) — FLUX and multi-model guide