# Ideogram 3.0 Text to Image API

> 3.0 is Ideogram's advanced text-to-image AI model. Create photorealistic images, illustrations, and concept art from natural language descriptions with exceptional detail and prompt adherence.

Source: https://www.sandbase.ai/models/ideogram-ai/ideogram-v3
API reference: https://www.sandbase.ai/models/ideogram-ai/ideogram-v3/docs

## Facts

- Provider: Ideogram
- Type: Image model
- Model ID: `ideogram-ai/ideogram-v3`
- Price: From $0.06 per run
- Capabilities: text to image
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

- Unified Run API: `POST https://api.sandbase.ai/v1/run`

```bash
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "ideogram-ai/ideogram-v3",
  "prompt": "The Bone Forest stretched across the horizon, its trees fashioned from the ossified remains of ancient leviathans that once swam through the sky. Shamans with antlers growing from their shoulders and eyes that revealed the true nature of any being they beheld conducted rituals to commune with the spirits that still inhabited the calcified grove. In sky writes \"Ideogram V3 in router.ai\"",
  "rendering_speed": "BALANCED"
}'
```

The response returns a run id; poll `GET https://api.sandbase.ai/v1/run/{id}` until the status is `completed` or `failed`.

## FAQ

### How do I call Ideogram 3.0 Text to Image through SandBase?

Create a SandBase API key, then send requests with the model ID "ideogram-ai/ideogram-v3" to Unified Run API (/v1/run) at https://api.sandbase.ai. The request examples on this page show the exact payload.

### Do I need a separate Ideogram account?

No. One SandBase API key and balance gives you access to Ideogram 3.0 Text to Image and the other models in the catalog; you do not need to sign up with Ideogram separately.

## README

### Ideogram 3.0 Text to Image

Ideogram 3.0 text-to-image with strong typography, at three rendering speeds.

#### Fields

| Field | Type | Default | Notes |
|---|---|---|---|
| `prompt` | string, required | — | Text instruction. |
| `images` | image URL[] | — | Optional style references. |
| `aspect_ratio` | `21:9` / `16:9` / `3:2` / `4:3` / `5:4` / `1:1` / `4:5` / `3:4` / `2:3` / `9:16` | — | Output shape. |
| `seed` | integer | random | Fix it to compare prompt changes. |
| `rendering_speed` | `TURBO` / `BALANCED` / `QUALITY` | `BALANCED` | Sets the per-image rate. |

#### Billing

Per image: $0.03 Turbo, $0.06 Balanced, $0.09 Quality.

| Speed | Price |
|---|---|
| TURBO | $0.03 |
| BALANCED | $0.06 |
| QUALITY | $0.09 |

Failed runs are not charged.

#### Prompting

- Quote all text that must appear.

#### Also on SandBase

Related: `ideogram/4.5` (newer).