# Ideogram V4 Balanced

> 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**: replicate
- **Model ID**: ideogram-ai/ideogram-v4-balanced
- **Category**: image_generation
- **Credits**: 140 per request
- **Pricing Type**: fixed

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `prompt` (string, optional): Natural-language prompt. Enables Ideogram 4.0 Magic Prompt automatically.
- `json_prompt` (string, optional): Structured Ideogram 4.0 prompt as a JSON object. Use either prompt or json_prompt, not both.
- `resolution` (string, optional): Output resolution. Omit to let Ideogram 4.0 choose the aspect ratio. (Default: `None`; 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, optional): Opt into Ideogram 4.0 post-generation copyright detection. (Default: `False`)

## Example Request

```json
{
  "model": "ideogram-ai/ideogram-v4-balanced",
  "input": {
    "prompt": "your prompt here"
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "replicate",
  "model": "black-forest-labs/flux-schnell",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Output Type

url

## Tags

ideogram, text-to-image, image-generation, typography, realistic

## Documentation

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