# Ideogram V4 Balanced - Core.Today AI API

> A middle-ground tier in Ideogram's v4 family, balancing generation speed and output quality. Delivers strong typography and photorealism at a lower cost than the Quality tier.

- **Provider**: Ideogram
- **Model ID**: ideogram-ai/ideogram-v4-balanced
- **Category**: Image Generation
- **Credits**: 140 per image (fixed price)
- **Speed**: Medium
- **Quality**: High

## Features
- Balanced speed and quality within 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
- Optional post-generation copyright detection
- Strong typography and photorealistic rendering at lower cost than Quality

## Use Cases
- Everyday logos and brand marks requiring legible text
- Posters and social graphics where speed and cost both matter
- Bulk marketing content production at a specific resolution
- Photorealistic product and lifestyle images at a reasonable cost
- Iterative workflows reviewing multiple drafts before finalizing

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

### Everyday Marketing Graphic
Social media promo graphic balancing quality and turnaround
```json
{
  "model": "ideogram-ai/ideogram-v4-balanced",
  "input": {
    "prompt": "A bright Instagram promo graphic for a summer sale with the headline \"UP TO 40% OFF\" in bold rounded typography, tropical leaf pattern background in coral and teal",
    "resolution": "2048x2048"
  }
}
```

### Structured JSON Prompt Poster
Using json_prompt for repeatable, structured control over layout
```json
{
  "model": "ideogram-ai/ideogram-v4-balanced",
  "input": {
    "json_prompt": "{\"subject\": \"product bottle poster\", \"text\": \"NEW ARRIVAL\", \"style\": \"clean editorial\", \"palette\": [\"cream\", \"forest green\"]}",
    "resolution": "1728x2304"
  }
}
```

## 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
- Good default tier for most production work — cheaper than Quality while still handling text-heavy layouts well
- Use json_prompt for repeatable batch generation instead of relying on prompt wording alone
- Drop down to the Turbo tier for cheap draft iterations, then finalize in Balanced or Quality

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