Use this in the request body model field.
Image APIActive
ideogram-v3 API
Generate stunning images with perfect typography using the Ideogram V3 API via API in One. 3 sub-models: turbo (8 credits), balanced (13), quality (20). Supports image editing and reference images.
The currently implemented BFF route.
Input types: text, image
Keys are managed by the shared dashboard.
This route does not require webhook handling.
Live capabilities
These capabilities come from the current model config and backend route. Unreleased APIs are not listed.
Best
Best-in-class typography rendering
3 quality tiers (turbo/balanced/quality)
3 quality tiers (turbo/balanced/quality)
Image editing with mask support
Image editing with mask support
Reference image input for style control
Reference image input for style control
Request format
Clients call same-origin API routes; the server BFF forwards to the matching Worker.
MethodEndpointCreditsPurpose
POST/api/v1/images/generations8 creditsIdeogram V3 — industry-leading text-to-image generation with best-in-class typography and design capabilities.
Parameters
promptstringText description of the image
RequiredmodelstringSub-model: "ideogram-v3-turbo" (8cr), "ideogram-v3-balanced" (13cr), or "ideogram-v3-quality" (20cr)
Optional · Default ideogram-v3-turboaspect_ratiostringAspect ratio: 1:1, 16:9, 9:16, 4:3, 3:4
Optional · Default 1:1stylestringStyle preset: "Auto", "General", "Realistic", "Design"
Optional · Default AutoimagestringInput image URL for editing
Optionalmask_imagestringMask image URL for inpainting
Optionalreference_imagesarrayArray of reference image URLs for style guidance
OptionalExample request
curl -X POST https://apiin.one/api/v1/images/generations \
-H "Authorization: Bearer aio_your_api_key" \
-H "Content-Type: application/json" \
--data-raw '{
"model": "ideogram-v3-turbo",
"prompt": "A vintage travel poster for Tokyo with \"Visit Tokyo\" in retro lettering",
"aspect_ratio": "3:4",
"style": "Design"
}'Models on the same endpoint
These live models use the same implemented BFF endpoint and can be switched by changing the model field.
🧠cogview-4image · 4 credits
flux-2image · 5 credits
grok-imagineimage · 5 credits
kling-image-o1image · 6 credits
/api/v1/images/generationsflux-2image · 5 credits/api/v1/images/generationsgrok-imagineimage · 5 credits/api/v1/images/generationskling-image-o1image · 6 credits/api/v1/images/generations🌐imagen-4image · 8 credits/api/v1/images/generations🤖gpt-image-1.5-officialimage · 10 credits/api/v1/images/generationsIntegration flow
These steps use the current live route and shared account system; login, payment, orders, credits, and profile remain shared.
Create a shared API key
Create a key in the existing dashboard. Top-up, orders, credit balance, and profile stay in the shared console.
Call the real endpoint
Send a request with the endpoint, model id, and parameters shown on this page. /api/v1/images/generations
Poll task status
Async media and tool jobs use /api/v1/tasks/{task_id}; chat models return a direct response.
Task status route
After creating image, video, audio, or tool tasks, poll the real task endpoint for results.
GET/api/v1/tasks/{task_id}Check generation task status and result.Pricing
8–20 credits per image (~$0.08–$0.20)
Base cost$0.08
Credits8
BillingSuccessful requests
Use cases
These workflows are supported by the current model and backend node.
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
FAQ
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.