ideogram-ai/ideogram-v2
Ideogram V2 is ideogram-ai's advanced text-to-image AI model. Create photorealistic images, illustrations, and concept art from natural language descriptions with exceptional detail and prompt adherence.
Example output — click Run to generate your own
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
https://api.sandbase.ai/v1/runideogram-ai/ideogram-v2Input Schema
3 parameters · 1 required · 2 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
prompt | string | Required | — |
seed | integer | Optional | Seed for the random number generator |
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 · Default: "16:9" 21:916:93:24:35:41:14:53:42:39:16 |
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, ortimeout - Retrieve — Read
outputsfrom 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-ai/ideogram-v2",
"prompt": "A comic style illustration of a skeleton sitting on a toilet in a bathroom. The bathroom has a Halloween decoration with a pumpkin jack-o-lantern and bats flying around. There is a text above the skeleton that says \"Just Waiting for Halloween with Ideogram 2.0 at fal.ai\"",
"aspect_ratio": "16:9"
}'
# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
-H "Authorization: Bearer YOUR_API_KEY"API README
Ideogram V2
Ideogram V2 is a text-to-image model built for visual ideas in which composition and written language must work together. It turns a natural-language brief into a finished image and is especially useful for posters, branding concepts, editorial graphics, merchandise, and other layouts where text is part of the artwork rather than an overlay added later.
Beyond typography, V2 supports realistic imagery, graphic design, illustration, and three-dimensional visual treatments while maintaining strong prompt adherence. That combination lets creators describe a communication goal, exact wording, hierarchy, subject, environment, and finish in one brief and explore a coherent design direction without supplying a source image.
Highlights
Typography inside the image. Renders legible words and integrates them into posters, signs, logos, and designed layouts.
Strong prompt adherence. Follows detailed subject, composition, wording, and stylistic direction in one generation brief.
Photorealistic output. Produces realistic people, objects, materials, lighting, and environments when the brief calls for photography.
Diverse design language. Supports graphic design, illustration, 3D treatments, and stylized artwork as well as realistic scenes.
Pricing
| Billing unit | Price |
|---|---|
| Per request | $0.08 |
When to Use
| ✅ Good fit | ❌ Consider alternatives |
|---|---|
| The model's named workflow matches the source material and intended output | A different input modality or model route is required |
| A managed asynchronous result is suitable for the production pipeline | A synchronous, interactive editor is essential |
| The documented controls cover the required duration, framing, or format | The project needs controls outside this endpoint's schema |
| Creative iteration benefits from a repeatable request structure | Exact deterministic pixels, frames, geometry, or samples are mandatory |
| A finished downloadable media asset is the desired deliverable | Editable source layers or a native project file are required |
Prompt Guide
For generation, state the intended result first, then add the subject or source treatment, progression, style, and delivery constraints. Keep one creative variable per phrase, use the documented field names for controls, and change one setting at a time when comparing results.
{
"aspect_ratio": "16:9",
"prompt": "A comic-style Halloween illustration of a skeleton waiting beside a glowing pumpkin, with legible title text above the character."
}
Technical Specs
| Spec | Value |
|---|---|
| Model ID | ideogram-ai/ideogram-v2 |
| Inputs | aspect_ratio, prompt, seed |
| Required inputs | prompt |
| Output fields | content_type, url |
| Execution | Async (submit, then poll for result) |
| Aspect Ratio | 21:9 / 16:9 / 3:2 / 4:3 / 5:4 / 1:1 / 4:5 / 3:4 / 2:3 / 9:16 |
Related Models
ideogram-ai/ideogram-v2/edit— Compare a nearby route in the same local model family.ideogram-ai/ideogram-v2/remix— Compare a nearby route in the same local model family.ideogram-ai/ideogram-v2/turbo— Compare a nearby route in the same local model family.