IdeogramMediumHigh

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.

140 credits

per image (fixed price)

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

Run it right now

Test this model instantly in the Console Playground — no code required

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

llms.txtllms.txt ↗

Quick Start

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "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"
  }
}'

Parameters

Parameter	Type	Required	Default	Description
`prompt`	string	No	-	Natural-language prompt. Enables Ideogram 4.0 Magic Prompt automatically.
`json_prompt`	string	No	-	Structured Ideogram 4.0 prompt as a JSON object. Use either prompt or json_prompt, not both.
`resolution`	string	No	None	Output resolution. Omit to let Ideogram 4.0 choose the aspect ratio. None2048x20481440x28802880x14401664x24962496x16641792x22402240x17921440x25602560x14401600x25602560x16001728x23042304x17281296x31683168x12961152x29442944x11521248x33283328x12481280x30723072x1280
`enable_copyright_detection`	boolean	No	false	Opt into Ideogram 4.0 post-generation copyright detection.

Common Parameters

Common parameters used when calling POST /v1/predictions.

Parameter	Type	Required	Default	Description
`model`	string	Yes	-	Model identifier
`input`	object	Yes	-	Object containing the model-specific parameters from the table above
`output_folder`	string	No	-	Folder path for output files (max 256 chars, '..' not allowed)
`webhook_url`	string	No	-	Webhook URL to call on completion
`is_public`	boolean	No	false	If true, output files are also available via permanent public URLs

Examples

Everyday Marketing Graphic

Social media promo graphic balancing quality and turnaround

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "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

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "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"
  }
}'