# Ideogram v3

> Generate high-quality images, posters, and logos with Ideogram V3. Features exceptional typography handling and realistic outputs optimized for commercial and creative use.

## Overview

- **Endpoint**: `https://api.runflow.io/v1/run/ideogram/v3`
- **Model ID**: `ideogram/v3`
- **Provider**: Ideogram
- **License**: commercial
- **Last Updated**: 2026-04-06

## Pricing

- **Base price**: $0.03/image
- **Note**: Usage-based, per image
## Input Schema

### `prompt` (string, required)



### `num_images` (integer, optional)

Number of images to generate.
- **Default**: `1`
- **Min**: 1
- **Max**: 8

### `image_size` (string, optional)

The resolution of the generated image
- **Default**: `square_hd`

### `style` (string, optional)

The style type to generate with. Cannot be used with style_codes.

### `style_preset` (string, optional)

Style preset for generation. The chosen style preset will guide the generation.

### `expand_prompt` (boolean, optional)

Determine if MagicPrompt should be used in generating the request or not.
- **Default**: `true`

### `rendering_speed` (string, optional)

The rendering speed to use.
- **Default**: `BALANCED`
- **Options**: `TURBO`, `BALANCED`, `QUALITY`

### `sync_mode` (boolean, optional)

If `True`, the media will be returned as a data URI and the output data won't be available in the request history.
- **Default**: `false`

### `color_palette` (string, optional)

A color palette for generation, must EITHER be specified via one of the presets (name) or explicitly via hexadecimal representations of the color with optional weights (members)

### `style_codes` (string, optional)

A list of 8 character hexadecimal codes representing the style of the image. Cannot be used in conjunction with style_reference_images or style

### `seed` (integer, optional)

Seed for the random number generator

### `image_urls` (array, optional)

A set of images to use as style references (maximum total size 10MB across all style references). The images should be in JPEG, PNG or WebP format

### `negative_prompt` (string, optional)

Description of what to exclude from an image. Descriptions in the prompt take precedence to descriptions in the negative prompt.
- **Default**: ``

## Usage Examples

### cURL

```bash
curl -X POST https://api.runflow.io/v1/run/ideogram/v3 \
  -H "Authorization: Bearer $RUNFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A professional headshot, soft studio lighting"
  }'
```

### Python

```python
import requests

response = requests.post(
    "https://api.runflow.io/v1/run/ideogram/v3",
    headers={"Authorization": "Bearer RUNFLOW_API_KEY"},
    json={
        "prompt": "A professional headshot, soft studio lighting",
    },
)

data = response.json()
print(data["images"][0]["url"])
```

### JavaScript

```javascript
const response = await fetch(
  "https://api.runflow.io/v1/run/ideogram/v3",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer RUNFLOW_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      prompt: "A professional headshot, soft studio lighting",
    }),
  }
);

const data = await response.json();
console.log(data.images[0].url);
```

## Additional Resources

- [Playground](https://www.runflow.io/models/ideogram/v3)
- [API Reference](https://www.runflow.io/models/ideogram/v3/api)
- [Documentation](https://www.runflow.io/docs)