# Ideogram V4 Turbo - Core.Today AI API

> The fastest and cheapest model in Ideogram's v4 family, built for rapid iteration while retaining Ideogram's signature text rendering and style consistency.

- **Provider**: Ideogram
- **Model ID**: ideogram-ai/ideogram-v4-turbo
- **Category**: Image Generation
- **Credits**: 70 per image (fixed price)
- **Speed**: Fast
- **Quality**: Standard

## Features
- Fastest and lowest-cost tier in the Ideogram v4 family
- Magic Prompt auto-enhancement when using natural-language prompt
- Structured json_prompt input for precise, repeatable control
- Wide selection of fixed output resolutions across aspect ratios
- Retains Ideogram's signature text rendering accuracy at speed
- Optional post-generation copyright detection

## Use Cases
- Rapid concept drafts exploring multiple text/layout ideas
- Social media graphics and thumbnails with light text
- Generating A/B test variations at volume
- Quick logo/poster concept exploration before finalizing
- Day-to-day content production where budget and speed matter

## 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

### Optional
- **prompt**: string - Natural-language prompt. Enables Ideogram 4.0 Magic Prompt automatically.
- **json_prompt**: string - Structured Ideogram 4.0 prompt as a JSON object. Use either prompt or json_prompt, not both.
- **resolution**: string (default: None) - Output resolution. Omit to let Ideogram 4.0 choose the aspect ratio.
  Options: None, 2048x2048, 1440x2880, 2880x1440, 1664x2496, 2496x1664, 1792x2240, 2240x1792, 1440x2560, 2560x1440, 1600x2560, 2560x1600, 1728x2304, 2304x1728, 1296x3168, 3168x1296, 1152x2944, 2944x1152, 1248x3328, 3328x1248, 1280x3072, 3072x1280
- **enable_copyright_detection**: boolean (default: false) - Opt into Ideogram 4.0 post-generation copyright detection.

## Examples

### Rapid Concept Iteration
Fast, low-cost draft for exploring multiple text/layout ideas
```json
{
  "model": "ideogram-ai/ideogram-v4-turbo",
  "input": {
    "prompt": "A bold event flyer with the headline \"SUMMER BEATS FESTIVAL\" in graffiti-style lettering, neon pink and electric blue color scheme, silhouettes of a crowd at the bottom"
  }
}
```

### Quick Social Thumbnail
Fast turnaround thumbnail graphic for iterative testing
```json
{
  "model": "ideogram-ai/ideogram-v4-turbo",
  "input": {
    "prompt": "A YouTube thumbnail with the text \"10 TIPS\" in huge yellow block letters, an excited cartoon character pointing at the camera, red background",
    "resolution": "2560x1440"
  }
}
```

## 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
- Best used for rapid drafts and prompt exploration before committing to the Balanced or Quality tier
- Magic Prompt activates automatically with prompt — use json_prompt if you need exact structured control even at this tier
- Text rendering stays accurate even at this speed tier, making it usable for quick logo/poster concepts

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