✦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.

Real routes1Real endpoint rows linked to this model.

Endpoint models11Live models sharing this endpoint.

Base cost8 credits$0.08 · 3–8 seconds

Endpoint familyImage API/api/v1/images/generations

Get API Key View Docs

Model IDideogram-v3

Use this in the request body model field.

Endpoint/api/v1/images/generations

The currently implemented BFF route.

Outputimage

Input types: text, image

AuthBearer API key

Keys are managed by the shared dashboard.

WebhookNot required

This route does not require webhook handling.

Service highlights

Marketplace-style signals backed by the current live route, without copying external SLA, discount, login, or payment claims.

Live production route

This page only shows endpoints implemented under /api/v1. /api/v1/images/generations

Synchronous response

This model returns directly without creating a media task.

Shared billing system

Top-up, orders, credit balance, and profile continue through the existing shared console.

Managed provider credentials

Your browser only holds an API in One key; provider calls stay server-side.

Call contract

Use these fields to integrate the current live model route.

Base URL: https://apiin.one
Authorization: Authorization: Bearer <API_KEY>
Model field: ideogram-v3
Result path: /api/v1/tasks/{task_id}
Billing path: /billing/credits

Runtime behavior

This model creates an async task, returns a task_id, then resolves through the real status route.

Client request/api/v1/images/generationstask_id -> result

View usage logs

API Console

Switch between real models on this endpoint, choose a live route, and generate request examples from the current catalog payload.

Live model11 live models

Endpoint1 Routes

ProviderIdeogramhttps://n63.gogloai.com

Current cost8 credits · $0.088–20 credits per image (~$0.08–$0.20)

RuntimeAsync taskAsync jobs return task_id, then use status polling.

Input / outputtext + image -> imageThis model returns directly without creating a media task.

Backend nodenode63Your browser only holds an API in One key; provider calls stay server-side.

Request previewPOST /api/v1/images/generations

curl --request POST \
  --url https://apiin.one/api/v1/images/generations \
  --header 'Authorization: Bearer <API_KEY>'
  --header '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"
}'

Result path/api/v1/tasks/{task_id}

Open docs

Endpoint decision panel

Evaluate cost, provider coverage, and production integration behavior across live models on this implemented endpoint.

Endpoint models11These models share the same BFF route and switch through the model field.

Provider coverage10Real provider sources currently exposed by this endpoint.

Cost range4-25 credits$0.04-$0.25 · Based on the current live catalog base credit cost.

Webhook coverage5/11Models on this endpoint that support callback_url.

Current model position5/11

Sorted by base credits from low to high.

Lowest-cost route in this endpointcogview-4

Zhipu AI / WaveSpeed · 4 credits · $0.04

Production patternAsync task + status polling

Async media and tool jobs use /api/v1/tasks/{task_id}; chat models return a direct response.

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)

Image editing with mask support

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 credits

Ideogram V3 — industry-leading text-to-image generation with best-in-class typography and design capabilities.

Parameters

promptstring

Text description of the image

Required

modelstring

Sub-model: "ideogram-v3-turbo" (8cr), "ideogram-v3-balanced" (13cr), or "ideogram-v3-quality" (20cr)

Optional · Default ideogram-v3-turbo

aspect_ratiostring

Aspect ratio: 1:1, 16:9, 9:16, 4:3, 3:4

Optional · Default 1:1

stylestring

Style preset: "Auto", "General", "Realistic", "Design"

Optional · Default Auto

imagestring

Input image URL for editing

Optional

mask_imagestring

Mask image URL for inpainting

Optional

reference_imagesarray

Array of reference image URLs for style guidance

Optional

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-v3-turbo",
  "prompt": "A vintage travel poster for Tokyo with \"Visit Tokyo\" in retro lettering",
  "aspect_ratio": "3:4",
  "style": "Design"
}'