ideogram-ai/ideogram-v3
3.0 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.
PNG, JPEG, WebP, or GIF · 20 MiB maximum each
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-v3Input Schema
5 parameters · 1 required · 4 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
prompt | string | Required | — |
seed | integer | Optional | Seed for the random number generator |
images | string[] | Optional | A set of images to use as style references (maximum total size 10MB across all style references). The images should be in JPEG, PNG or WebP format |
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 |
rendering_speed | string | Optional | The rendering speed to use. · Options: TURBO, BALANCED, QUALITY · Default: "BALANCED" TURBOBALANCEDQUALITY |
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-v3",
"prompt": "The Bone Forest stretched across the horizon, its trees fashioned from the ossified remains of ancient leviathans that once swam through the sky. Shamans with antlers growing from their shoulders and eyes that revealed the true nature of any being they beheld conducted rituals to commune with the spirits that still inhabited the calcified grove. In sky writes \"Ideogram V3 in router.ai\"",
"rendering_speed": "BALANCED"
}'
# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
-H "Authorization: Bearer YOUR_API_KEY"API README
Ideogram 3.0
Ideogram 3.0 is a prompt-led image model built for visually polished compositions and reliable text rendering. It can generate posters, advertising concepts, editorial graphics, product visuals, illustrations, and other assets where the relationship between imagery, layout, and written elements matters.
Optional style-reference images guide the aesthetic without turning the request into a conventional source-image edit. Combine a precise brief with the desired canvas, rendering mode, and seed; describe exact wording, hierarchy, placement, materials, lighting, and finish when the design contains typography.
Highlights
- Typography-centered generation. Creates compositions where requested words and visual design are planned together.
- Optional style references. Uses supplied reference images to guide aesthetic direction without requiring a source image to edit.
- Design-aware composition. Coordinates hierarchy, spacing, subject placement, and graphic balance for production-oriented layouts.
- Rendering-mode choice. Offers Turbo, Balanced, and Quality modes so teams can choose an iteration or final-output workflow.
Pricing
| Configuration | Billing unit | Price |
|---|---|---|
| TURBO | Per request | $0.03 |
| BALANCED | Per request | $0.06 |
| QUALITY | Per request | $0.09 |
When to Use
| ✅ Good fit | ❌ Consider alternatives |
|---|---|
| The project needs creating a prompt-led image | The goal is a different media task or endpoint |
| The available inputs match the required local schema | Required source media or permissions are unavailable |
| The brief can specify subject, composition, style, and delivery | The result must be deterministic at pixel or sample level |
| The supported formats and controls match final placement | Delivery requires unsupported dimensions, codecs, or duration |
| An asynchronous generated result fits the workflow | A live, frame-synchronous, or real-time response is mandatory |
Prompt Guide
Write the request as a production brief: identify the main subject or source material, state the intended transformation, describe composition or timing, and finish with style, atmosphere, and delivery constraints. Keep preservation requirements separate from requested changes, and use only fields exposed by this route.
{
"prompt": "A cinematic, precisely directed scene with clear subject action, camera movement, lighting, and atmosphere",
"seed": 1,
"images": [
"https://example.com/reference.jpg"
],
"aspect_ratio": "21:9"
}
Technical Specs
| Spec | Value |
|---|---|
| Model ID | ideogram-ai/ideogram-v3 |
| Input fields | seed (integer)<br>images (array)<br>prompt (string)<br>aspect_ratio (string; 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16)<br>rendering_speed (string; TURBO, BALANCED, QUALITY) |
| Required input | prompt |
| Output fields | url, content_type |
| Execution | Asynchronous job |
Related Models
ideogram-ai/ideogram-v3/editideogram-ai/ideogram-v3/remixideogram-ai/ideogram-v3/reframe