# Ideogram V3 Turbo - Core.Today AI API

> The fastest and cheapest Ideogram v3 tier. V3 creates images with stunning realism, creative designs, and consistent styles.

- **Provider**: Ideogram
- **Model ID**: ideogram-ai/ideogram-v3-turbo
- **Category**: Image Generation
- **Credits**: 70 per image
- **Speed**: Fast
- **Quality**: High

## Features
- Fastest and cheapest tier of Ideogram v3
- 60+ fixed resolution presets in addition to aspect ratio
- Inpainting support via image + mask
- 60+ curated style presets and 4 broad style types
- Magic Prompt auto-optimizes and can translate prompts

## Use Cases
- High-volume, low-cost text-to-image generation
- Poster and typography-heavy design work
- Inpainting to fix or replace parts of an existing image
- Style-consistent asset sets using style_preset

## API Endpoint

Base URL: https://api.core.today/v1
Create Prediction: POST /predictions
Get Status: GET /predictions/{job_id}

## Authentication
Header: X-API-Key: YOUR_API_KEY

## Input Parameters

### Required
- **prompt**: string - Text prompt for image generation

### Optional
- **aspect_ratio**: string (default: 1:1) - Aspect ratio. Ignored if a resolution or inpainting image is given
  Options: 1:3, 3:1, 1:2, 2:1, 9:16, 16:9, 10:16, 16:10, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 1:1
- **resolution**: string (default: None) - Fixed pixel resolution. Overrides aspect_ratio. Ignored if an inpainting image is given
  Options: None, 512x1536, 576x1408, 576x1472, 576x1536, 640x1344, 640x1408, 640x1472, 640x1536, 704x1152, 704x1216, 704x1280, 704x1344, 704x1408, 704x1472, 736x1312, 768x1088, 768x1216, 768x1280, 768x1344, 800x1280, 832x960, 832x1024, 832x1088, 832x1152, 832x1216, 832x1248, 864x1152, 896x960, 896x1024, 896x1088, 896x1120, 896x1152, 960x832, 960x896, 960x1024, 960x1088, 1024x832, 1024x896, 1024x960, 1024x1024, 1088x768, 1088x832, 1088x896, 1088x960, 1120x896, 1152x704, 1152x832, 1152x864, 1152x896, 1216x704, 1216x768, 1216x832, 1248x832, 1280x704, 1280x768, 1280x800, 1312x736, 1344x640, 1344x704, 1344x768, 1408x576, 1408x640, 1408x704, 1472x576, 1472x640, 1472x704, 1536x512, 1536x576, 1536x640
- **magic_prompt_option**: string (default: Auto) - Interprets and optimizes your prompt for variety and quality; can rewrite prompts in other languages
  Options: Auto, On, Off
- **image**: string - An image file to use for inpainting. Requires a mask
- **mask**: string - A black and white image; black pixels are inpainted, white pixels are preserved
- **style_type**: string (default: None) - The overall aesthetic style of the generated image
  Options: None, Auto, General, Realistic, Design
- **style_reference_images**: array - A list of images to use as style references.
- **seed**: integer - Random seed. Set for reproducible generation
- **style_preset**: string (default: None) - Apply a predefined artistic style to the generated image (V3 models only)
  Options: None, 80s Illustration, 90s Nostalgia, Abstract Organic, Analog Nostalgia, Art Brut, Art Deco, Art Poster, Aura, Avant Garde, Bauhaus, Blueprint, Blurry Motion, Bright Art, C4D Cartoon, Children's Book, Collage, Coloring Book I, Coloring Book II, Cubism, Dark Aura, Doodle, Double Exposure, Dramatic Cinema, Editorial, Emotional Minimal, Ethereal Party, Expired Film, Flat Art, Flat Vector, Forest Reverie, Geo Minimalist, Glass Prism, Golden Hour, Graffiti I, Graffiti II, Halftone Print, High Contrast, Hippie Era, Iconic, Japandi Fusion, Jazzy, Long Exposure, Magazine Editorial, Minimal Illustration, Mixed Media, Monochrome, Nightlife, Oil Painting, Old Cartoons, Paint Gesture, Pop Art, Retro Etching, Riviera Pop, Spotlight 80s, Stylized Red, Surreal Collage, Travel Poster, Vintage Geo, Vintage Poster, Watercolor, Weird, Woodblock Print

## Examples

### Typography Portrait
A film-inspired portrait with embedded text
```json
{
  "model": "ideogram-ai/ideogram-v3-turbo",
  "input": {
    "prompt": "The text \"V3 Turbo\" in the center middle. A color film-inspired portrait of a young man looking to the side with a shallow depth of field.",
    "aspect_ratio": "3:2",
    "magic_prompt_option": "Auto"
  }
}
```

## Response Format
```json
{
  "job_id": "abc123",
  "status": "pending | processing | completed | failed",
  "result": "URL or data (when completed)"
}
```

## Usage Flow
1. POST /predictions with model and input -> receive job_id
2. GET /predictions/{job_id} -> poll until status is completed or failed
3. Result contains output URL(s)

## Tips
- Turbo is the cheapest v3 tier — use it for high-volume generation and iterate before moving to a higher-fidelity Ideogram tier
- Set resolution for exact pixel dimensions instead of aspect_ratio when you need a specific size
- Provide image + mask together for inpainting; either alone will not work
- style_preset offers 60+ curated looks, faster than describing style in the prompt text

## Documentation
https://replicate.com/ideogram-ai/ideogram-v3-turbo