✦Image APIActive

ideogram-v4 API

Generate images with the Ideogram V4 API via API in One. Supports flexible sizes, rendering speed controls, PNG/JPEG/WEBP output, and fixed 12-credit pricing.

Get API Key View Docs

Model IDideogram-v4

Use this in the request body model field.

Endpoint/api/v1/images/generations

The currently implemented BFF route.

Outputimage

Input types: text

AuthBearer API key

Keys are managed by the shared dashboard.

WebhookNot required

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.

Strong typography and design output

Flexible size presets

Turbo

Turbo, Default, and Quality rendering modes

PNG

PNG, JPEG, and WEBP output

Request format

Clients call same-origin API routes; the server BFF forwards to the matching Worker.

MethodEndpointCreditsPurpose

POST/api/v1/images/generations12 credits

Ideogram V4 — high-quality text-to-image generation with strong typography, flexible sizes, and speed-quality controls.

Parameters

promptstring

Text description of the image

Required

modelstring

Use "ideogram-v4"

Required · Default ideogram-v4

sizestring

Size: 1:1, 16:9, 9:16, 3:4, 4:3, 3:2, 2:3, 9:21, 21:9

Optional · Default 1:1

rendering_speedstring

Rendering speed: TURBO, BALANCED, QUALITY

Optional · Default BALANCED

output_formatstring

Output format: png, jpeg, webp

Optional · Default png

Example 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-v4",
  "prompt": "A clean editorial poster reading \"SUMMER DESIGN WEEK\", bold typography, warm daylight, modern layout",
  "size": "1:1",
  "rendering_speed": "BALANCED",
  "output_format": "png"
}'

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/api/v1/images/generations

flux-2image · 5 credits/api/v1/images/generations

grok-imagineimage · 5 credits/api/v1/images/generations

kling-image-o1image · 6 credits/api/v1/images/generations✦ideogram-v3image · 8 credits/api/v1/images/generations🌐imagen-4image · 8 credits/api/v1/images/generations

Integration 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

12 credits per image (~$0.12)

Base cost$0.12

Credits12

BillingSuccessful requests

Use cases

These workflows are supported by the current model and backend node.

Create posters and social graphics with accurate text

Generate brand and campaign concepts

Build AI design tools with typography-friendly output

Produce multiple aspect ratios from one prompt

FAQ

How much does Ideogram V4 cost?

Ideogram V4 currently costs 12 credits per image (~$0.12) through the node63 backend.

What sizes are supported?

Supported sizes include 1:1, 16:9, 9:16, 3:4, 4:3, 3:2, 2:3, 9:21, and 21:9.

Which output formats are supported?

PNG, JPEG, and WEBP output formats are supported.