# Ideogram 3.0

> Ideogram 3.0 revolutionizes content creation with photorealistic text-to-image generation and diverse aesthetic styles.


## Overview

- **Endpoint**: `https://api.segmind.com/v1/ideogram-3`
- **Model ID**: `ideogram-3`
- **Category**: Text-to-Image Generation
- **Type**: Synchronous (Direct response)

- **Average Cost**: $0.04068396226415094


## Pricing

| mode | cost |
| --- | --- |
| TURBO | 0.0375 |
| DEFAULT | 0.075 |
| QUALITY | 0.1125 |

## API Information

This model uses a **synchronous response pattern**:
1. Make a POST request with your parameters
2. Receive the output directly in the response (binary for images/videos/audio, JSON for text)
3. No polling required - response is immediate


### Input Schema

The API accepts the following input parameters:

- **`prompt`** (`string`, _required_):
  Prompt
  The prompt guides image creation; use detailed descriptions for specific results. Example: 'A futuristic cityscape at sunset.'
  - Default: `"A cinematic photograph of a dark forest scene viewed from a distance. In the center, a small patch of glowing plants and flowers is illuminated by a faint, focused glow, casting a soft reflection in a still stream below. The delicate neon-style white text 'Segmind' is softly lit, creating a striking contrast against the deep shadows and mist. The surrounding dense foliage and mist create a mysterious and moody atmosphere, with strong contrast between light and shadow, enhancing the emotional and atmospheric tone."`

- **`seed`** (`integer | null`, _optional_):
  Seed
  The seed ensures reproducibility; set it for consistent output, omit for variation.
  - Range: 100 to 999999

- **`resolution`** (`string | null`, _optional_):
  Resolution
  Resolution affects image detail; higher values for precise detail, lower for speed.
  - Default: `"1024x1024"`
  - Options: "512x1536" (512x1536), "576x1408" (576x1408), "576x1472" (576x1472), "576x1536" (576x1536), "640x1344" (640x1344), "640x1408" (640x1408), "640x1472" (640x1472), "640x1536" (640x1536), "704x1152" (704x1152), "704x1216" (704x1216), "704x1280" (704x1280), "704x1344" (704x1344), "704x1408" (704x1408), "704x1472" (704x1472), "736x1312" (736x1312), "768x1088" (768x1088), "768x1216" (768x1216), "768x1280" (768x1280), "768x1344" (768x1344), "800x1280" (800x1280), "832x960" (832x960), "832x1024" (832x1024), "832x1088" (832x1088), "832x1152" (832x1152), "832x1216" (832x1216), "832x1248" (832x1248), "864x1152" (864x1152), "896x960" (896x960), "896x1024" (896x1024), "896x1088" (896x1088), "896x1120" (896x1120), "896x1152" (896x1152), "960x832" (960x832), "960x896" (960x896), "960x1024" (960x1024), "960x1088" (960x1088), "1024x832" (1024x832), "1024x896" (1024x896), "1024x960" (1024x960), "1024x1024" (1024x1024), "1088x768" (1088x768), "1088x832" (1088x832), "1088x896" (1088x896), "1088x960" (1088x960), "1120x896" (1120x896), "1152x704" (1152x704), "1152x832" (1152x832), "1152x864" (1152x864), "1152x896" (1152x896), "1216x704" (1216x704), "1216x768" (1216x768), "1216x832" (1216x832), "1248x832" (1248x832), "1280x704" (1280x704), "1280x768" (1280x768), "1280x800" (1280x800), "1312x736" (1312x736), "1344x640" (1344x640), "1344x704" (1344x704), "1344x768" (1344x768), "1408x576" (1408x576), "1408x640" (1408x640), "1408x704" (1408x704), "1472x576" (1472x576), "1472x640" (1472x640), "1472x704" (1472x704), "1536x512" (1536x512), "1536x576" (1536x576), "1536x640" (1536x640)

- **`aspect_ratio`** (`string | null`, _optional_):
  Aspect ratio
  Aspect ratio formats your image; select '1x1' for square, '16x9' for widescreen.
  - Options: "1x3" (1x3), "3x1" (3x1), "1x2" (1x2), "2x1" (2x1), "9x16" (9x16), "16x9" (16x9), "10x16" (10x16), "16x10" (16x10), "2x3" (2x3), "3x2" (3x2), "3x4" (3x4), "4x3" (4x3), "4x5" (4x5), "5x4" (5x4), "1x1" (1x1)

- **`rendering_speed`** (`string | null`, _optional_):
  Rendering speed
  Rendering speed affects time taken; 'TURBO' for faster, 'QUALITY' for detailed results.
  - Default: `"DEFAULT"`
  - Options: "TURBO" (TURBO), "DEFAULT" (DEFAULT), "QUALITY" (QUALITY)

- **`magic_prompt`** (`string | null`, _optional_):
  Magic prompt
  Magic Prompt helps enhance descriptions; use 'ON' for complex scenes, 'OFF' for simplicity.
  - Default: `"AUTO"`
  - Options: "AUTO" (AUTO), "ON" (ON), "OFF" (OFF)

- **`negative_prompt`** (`string | null`, _optional_):
  Negative prompt
  Exclude elements by specifying negatives; e.g., 'No people, cars'.
  - Default: `"No people, no animals."`

- **`style_codes`** (`array`, _optional_):
  Style codes
  Style codes customize look; use predefined codes for specific styles.
  - Item type: string

- **`style_type`** (`string | null`, _optional_):
  Style type
  Style type influences art style; choose 'REALISTIC' for lifelike, 'DESIGN' for artistic.
  - Default: `"GENERAL"`
  - Options: "AUTO" (AUTO), "GENERAL" (GENERAL), "REALISTIC" (REALISTIC), "DESIGN" (DESIGN)

- **`color_palette`** (`object`, _optional_):
  Color Palette
  A color palette for generation


**Required Parameters Example**:

```json
{
  "prompt": "A cinematic photograph of a dark forest scene viewed from a distance. In the center, a small patch of glowing plants and flowers is illuminated by a faint, focused glow, casting a soft reflection in a still stream below. The delicate neon-style white text 'Segmind' is softly lit, creating a striking contrast against the deep shadows and mist. The surrounding dense foliage and mist create a mysterious and moody atmosphere, with strong contrast between light and shadow, enhancing the emotional and atmospheric tone."
}
```


**Full Example**:

```json
{
  "prompt": "A cinematic photograph of a dark forest scene viewed from a distance. In the center, a small patch of glowing plants and flowers is illuminated by a faint, focused glow, casting a soft reflection in a still stream below. The delicate neon-style white text 'Segmind' is softly lit, creating a striking contrast against the deep shadows and mist. The surrounding dense foliage and mist create a mysterious and moody atmosphere, with strong contrast between light and shadow, enhancing the emotional and atmospheric tone.",
  "seed": null,
  "resolution": "1024x1024",
  "aspect_ratio": null,
  "rendering_speed": "DEFAULT",
  "magic_prompt": "AUTO",
  "negative_prompt": "No people, no animals.",
  "style_codes": [],
  "style_type": "GENERAL"
}
```


### Output Schema

The API returns a synchronous response based on the model type:

**For Image/Video/Audio Models**:
- Response contains binary data (image/png, video/mp4, audio/mp3)
- Content-Type header indicates the media type
- Save the response body directly to a file

**For Text Models**:
- Response is JSON with the generated text
- Structure varies by model

**HTTP Response Codes**:
- **200 - OK**: Request successful, output in response body
- **400 - Bad Request**: Invalid parameters
- **401 - Unauthorized**: Invalid or missing API key
- **404 - Not Found**: Model not found
- **406 - Not Acceptable**: Insufficient credits
- **429 - Too Many Requests**: Rate limit exceeded
- **500 - Server Error**: Internal server error


## Usage Examples

### cURL

```bash
curl -X POST "https://api.segmind.com/v1/ideogram-3" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "A cinematic photograph of a dark forest scene viewed from a distance. In the center, a small patch of glowing plants and flowers is illuminated by a faint, focused glow, casting a soft reflection in a still stream below. The delicate neon-style white text 'Segmind' is softly lit, creating a striking contrast against the deep shadows and mist. The surrounding dense foliage and mist create a mysterious and moody atmosphere, with strong contrast between light and shadow, enhancing the emotional and atmospheric tone.",
  "seed": null,
  "resolution": "1024x1024",
  "aspect_ratio": null,
  "rendering_speed": "DEFAULT",
  "magic_prompt": "AUTO",
  "negative_prompt": "No people, no animals.",
  "style_codes": [],
  "style_type": "GENERAL"
}'
```

### Python

```python
import requests
import json

api_key = "YOUR_API_KEY"
url = "https://api.segmind.com/v1/ideogram-3"

data = {
  "prompt": "A cinematic photograph of a dark forest scene viewed from a distance. In the center, a small patch of glowing plants and flowers is illuminated by a faint, focused glow, casting a soft reflection in a still stream below. The delicate neon-style white text 'Segmind' is softly lit, creating a striking contrast against the deep shadows and mist. The surrounding dense foliage and mist create a mysterious and moody atmosphere, with strong contrast between light and shadow, enhancing the emotional and atmospheric tone.",
  "seed": null,
  "resolution": "1024x1024",
  "aspect_ratio": null,
  "rendering_speed": "DEFAULT",
  "magic_prompt": "AUTO",
  "negative_prompt": "No people, no animals.",
  "style_codes": [],
  "style_type": "GENERAL"
}

response = requests.post(
    url,
    json=data,
    headers={
        'x-api-key': api_key,
        'Content-Type': 'application/json'
    }
)

if response.status_code == 200:
    # For image/video/audio models, response.content contains the binary data
    with open('output.png', 'wb') as f:
        f.write(response.content)
    print('Generation complete, saved to output.png')
else:
    print(f"Error: {response.status_code}")
    print(response.text)
```

### JavaScript

```javascript
const apiKey = 'YOUR_API_KEY';
const url = 'https://api.segmind.com/v1/ideogram-3';

const data = {
  "prompt": "A cinematic photograph of a dark forest scene viewed from a distance. In the center, a small patch of glowing plants and flowers is illuminated by a faint, focused glow, casting a soft reflection in a still stream below. The delicate neon-style white text 'Segmind' is softly lit, creating a striking contrast against the deep shadows and mist. The surrounding dense foliage and mist create a mysterious and moody atmosphere, with strong contrast between light and shadow, enhancing the emotional and atmospheric tone.",
  "seed": null,
  "resolution": "1024x1024",
  "aspect_ratio": null,
  "rendering_speed": "DEFAULT",
  "magic_prompt": "AUTO",
  "negative_prompt": "No people, no animals.",
  "style_codes": [],
  "style_type": "GENERAL"
};

const response = await fetch(url, {
  method: 'POST',
  headers: {
    'x-api-key': apiKey,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(data),
});

if (response.ok) {
  // For image/video/audio models, response contains binary data
  const blob = await response.blob();
  const downloadUrl = URL.createObjectURL(blob);

  // Create download link
  const a = document.createElement('a');
  a.href = downloadUrl;
  a.download = 'output.png';
  a.click();

  console.log('Generation complete');
}
```


## Additional Resources

### Documentation

- [Model Playground](https://www.segmind.com/models/ideogram-3)
- [API Documentation](https://www.segmind.com/models/ideogram-3/api)
- [Pricing Details](https://www.segmind.com/models/ideogram-3/pricing)
- [Platform Documentation](https://docs.segmind.com/)

### Tags

No tags available