LogoAPI in One
✦

Ideogram V3 API

active

Ideogram V3 — industry-leading text-to-image generation with best-in-class typography and design capabilities.

Ideogramimage8 credits/call
Provider
Ideogram
Pricing
8–20 credits per image (~$0.016–$0.04)
Speed
3–8 seconds
Output
image

Quick Start

Send a request to the Ideogram V3 API:

bash
1curl -X POST https://apiin.one/api/v1/images/generations \
2 -H "Authorization: Bearer YOUR_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "model": "ideogram-v3-turbo",
6 "prompt": "A vintage travel poster for Tokyo with \"Visit Tokyo\" in retro lettering",
7 "aspect_ratio": "3:4",
8 "style": "Design"
9}'

API Endpoint

POST/api/v1/images/generations

Send a POST request with your API key to generate content using Ideogram V3.

Headers

Body ParametersJSON
Authorization:string

Bearer YOUR_API_KEY

Content-Type:string

application/json

Body Parameters

Body ParametersJSON
model:string

Model identifier: ideogram-v3

prompt:string

Text description of the image

model:optional string

Sub-model: ideogram-v3-turbo (8cr), ideogram-v3-balanced (13cr), or ideogram-v3-quality (20cr) Defaults to ideogram-v3-turbo.

aspect_ratio:optional string

Aspect ratio: 1:1, 16:9, 9:16, 4:3, 3:4 Defaults to 1:1.

style:optional string

Style preset: Auto, General, Realistic, Design Defaults to Auto.

image:optional string

Input image URL for editing

mask_image:optional string

Mask image URL for inpainting

reference_images:optional array

Array of reference image URLs for style guidance

Example Request

json
1{
2 "model": "ideogram-v3-turbo",
3 "prompt": "A vintage travel poster for Tokyo with \"Visit Tokyo\" in retro lettering",
4 "aspect_ratio": "3:4",
5 "style": "Design"
6}

Example Response

Successful task creation response.

1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "n63xxxx_ideogram",
6 "status": "IN_PROGRESS"
7 }
8}

Check Task Status

For asynchronous tasks, poll the status endpoint to check when your task is complete:

GET/api/v1/tasks/{task_id}

Returns the current status of a generation task. Poll until status is 'completed' or 'failed'.

bash
1curl https://apiin.one/api/v1/tasks/task_abc123 \
2 -H "Authorization: Bearer aio_your_key"

Use Cases

  • ✓Create social media graphics with embedded text
  • ✓Generate poster and flyer designs
  • ✓Build AI design tools for non-designers
  • ✓Produce brand assets with accurate typography

API Tester

Test the Ideogram V3 API directly from your browser:

Playground da APIPOST

Error Codes

1{
2 "error": {
3 "code": 400,
4 "message": "Invalid parameters",
5 "type": "invalid_request"
6 }
7}

Frequently Asked Questions

How much does Ideogram V3 cost?

Depends on sub-model: turbo costs 8 credits, balanced costs 13 credits, quality costs 20 credits per image.

What makes Ideogram V3 special?

Ideogram V3 is widely regarded as the best model for generating images with accurate text and typography.

Does it support image editing?

Yes. Provide an input image and optional mask_image for inpainting and editing.

What styles are available?

Supported styles: Auto, General, Realistic, and Design.

Why Use Ideogram V3 Through API in One?

1.Best-in-class typography rendering
2.3 quality tiers (turbo/balanced/quality)
3.Image editing with mask support
4.Reference image input for style control

Ready to use Ideogram V3?

Get Your API Key →