ideogram/4.0/instant

Name: V4.0q [instant]
Author: Ideogram

4.0 Instant is Ideogram's advanced text-to-image AI model. Create photorealistic images, illustrations, and concept art from natural language descriptions with exceptional detail and prompt adherence.

Input

Prompt(string)

The prompt to generate an image from.

Aspect Ratio(string)

The aspect ratio of the generated image. Allowed values: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16.

Output Format(string)

The format of the generated image. Allowed values: jpeg, png.

Seed(integer)

The seed to use for generation. If not provided, a random seed will be used.

Expansion Model(string)

Which model expands the prompt. 'None' disables expansion; 'Medium' uses the fast magic prompt model. Allowed values: None, Medium.

Idle

Example output — click Run to generate your own

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDideogram/4.0/instant

Input Schema

5 parameters · 1 required · 4 optional

Parameter	Type	Required	Description
`prompt`	string	Required	The prompt to generate an image from.
`seed`	integer	Optional	The seed to use for generation. If not provided, a random seed will be used.
`aspect_ratio`	string	Optional	The aspect ratio of the generated image. · Options: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16 21:916:93:24:35:41:14:53:42:39:16
`output_format`	string	Optional	The format of the generated image. · Options: jpeg, png · Default: "jpeg" jpegpng
`expansion_model`	string	Optional	Which model expands the prompt. 'None' disables expansion; 'Medium' uses the fast magic prompt model. · Options: None, Medium · Default: "Medium" NoneMedium

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Async Workflow

This model uses asynchronous execution. Submit a request and poll for the result.

Submit — POST to /v1/run, receive an id
Poll — GET /v1/run/{id} until status is completed, failed, or timeout
Retrieve — Read outputs from the completed response

Code Examples

Ready-to-run snippets

# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "ideogram/4.0/instant",
  "prompt": "A red panda perched on a mossy branch in a misty forest at sunrise",
  "output_format": "jpeg",
  "expansion_model": "Medium"
}'

# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
  -H "Authorization: Bearer YOUR_API_KEY"

← Back to V4.0q [instant]

API README

PRICED DRAFT — MANUAL REVIEW REQUIRED exact_model_mode: ideogram/v4/instant original_unit: Your request will cost $0.0075 per megapixel. For example, a 2048 x 2048 image will cost $0.03. method: generated-image megapixel price using metered output dimensions result_base_price: 0.03 result_price_formula: ((usage.width ?? 2048) * (usage.height ?? 2048) / 1048576) * 0.0075 review_status: pending; model remains disabled checked_at: 2026-08-16