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

Headerタイプ必須説明
Authorizationstring必須Bearer YOUR_API_KEY
Content-Typestring必須application/json

Body Parameters

パラメータータイプ必須説明
modelstring必須Model identifier: "ideogram-v3"
promptstring必須Text description of the image
modelstring任意Sub-model: "ideogram-v3-turbo" (8cr), "ideogram-v3-balanced" (13cr), or "ideogram-v3-quality" (20cr) (デフォルト: ideogram-v3-turbo)
aspect_ratiostring任意Aspect ratio: 1:1, 16:9, 9:16, 4:3, 3:4 (デフォルト: 1:1)
stylestring任意Style preset: "Auto", "General", "Realistic", "Design" (デフォルト: Auto)
imagestring任意Input image URL for editing
mask_imagestring任意Mask image URL for inpainting
reference_imagesarray任意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 プレイグラウンド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 →