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 →