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
curl -X POST https://apiin.one/api/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "ideogram-v3-turbo",
  "prompt": "A vintage travel poster for Tokyo with \"Visit Tokyo\" in retro lettering",
  "aspect_ratio": "3:4",
  "style": "Design"
}'

API Endpoint

POST/api/v1/images/generations
Send a POST request with your API key to generate content using Ideogram V3.

Headers

HeaderTürGerekliAçıklama
AuthorizationstringGerekliBearer YOUR_API_KEY
Content-TypestringGerekliapplication/json

Body Parameters

ParametreTürGerekliAçıklama
modelstringGerekliModel identifier: "ideogram-v3"
promptstringGerekliText description of the image
modelstringİsteğe BağlıSub-model: "ideogram-v3-turbo" (8cr), "ideogram-v3-balanced" (13cr), or "ideogram-v3-quality" (20cr) (Varsayılan: ideogram-v3-turbo)
aspect_ratiostringİsteğe BağlıAspect ratio: 1:1, 16:9, 9:16, 4:3, 3:4 (Varsayılan: 1:1)
stylestringİsteğe BağlıStyle preset: "Auto", "General", "Realistic", "Design" (Varsayılan: Auto)
imagestringİsteğe BağlıInput image URL for editing
mask_imagestringİsteğe BağlıMask image URL for inpainting
reference_imagesarrayİsteğe BağlıArray of reference image URLs for style guidance

Example Request

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

Example Response

Successful task creation response.

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n63xxxx_ideogram",
    "status": "IN_PROGRESS"
  }
}

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
curl https://apiin.one/api/v1/tasks/task_abc123 \
  -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:

API AlanıPOST

Error Codes

{
  "error": {
    "code": 400,
    "message": "Invalid parameters",
    "type": "invalid_request"
  }
}

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?

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

Ready to use Ideogram V3?

Get Your API Key →