Apiframe Logo Apiframe
Ideogram v4 Turbo icon
Image by Ideogram

Ideogram v4 Turbo API

The fastest, most affordable tier of Ideogram 4.0, built for rapid drafts, iteration, and high-volume work while keeping the model's improved text rendering and prompt alignment.

Integrate Ideogram v4 Turbo with a single API call — one key, one unified endpoint, and shared billing across every model on Apiframe.

Get API Key Use in Apiframe Studio View Ideogram v4 Turbo API Docs
model: "ideogram-v4-turbo"

What's special about Ideogram v4 Turbo

Speed and low cost first

Turbo is the quickest and cheapest tier in the v4 family, at around $0.03 per image, which makes it well suited to high-volume and iterative workflows.

Sharper text than v3

Ideogram 4.0 improves typography and image-prompt alignment over 3.0, so even quick drafts keep text inside images readable.

Built for iteration

It is ideal for brainstorming and testing ideas fast, where results may look rougher than the Balanced or Quality tiers but arrive much sooner.

Style control included

You can guide it with up to three reference images, reuse looks with style presets, and pick across Realistic, General, Design, and Auto style types.

Higher resolutions

Version 4 adds support for higher output resolutions, so Turbo drafts can be framed at the same shape you intend to ship.

Easy to upgrade from

It shares the v4 family’s Magic Prompt rewriting, so you can draft on Turbo and switch to Balanced or Quality for the final version without changing your setup.

Made with Ideogram v4 Turbo

A few outputs generated through the Ideogram v4 Turbo API on Apiframe.

Sample coming soon

A cinematic portrait of an astronaut in a neon-lit alley, 85mm, shallow depth of field

Sample coming soon

Cozy isometric coffee shop, warm morning light, highly detailed 3D render

Sample coming soon

A majestic snow leopard on a misty mountain ridge at golden hour

Overview

Endpoint
POST /v2/images/generate
Model ID
ideogram-v4-turbo
Params key
ideogramParams
Modality
Image
Provider
Ideogram
Avg. completion
~15s

Capabilities

Aspect ratios1:1, 3:4, 4:3, 9:16, 16:9
Image inputSupported
Avg. time~15s

Quick start

Send a single POST /v2/images/generate request with your API key to generate with Ideogram v4 Turbo. The call returns a jobId you can poll or receive via webhook. 

curl -X POST https://api.apiframe.ai/v2/images/generate \
  -H "X-API-Key: afk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
        "prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
        "model": "ideogram-v4-turbo",
        "ideogramParams": {
            "style_type": "AUTO",
            "magic_prompt_option": "Auto",
            "image": "https://example.com/input.jpg",
            "negative_prompt": "What you do NOT want to see…"
        }
    }'
import requests

response = requests.post(
    "https://api.apiframe.ai/v2/images/generate",
    headers={
        "X-API-Key": "afk_your_api_key_here",
        "Content-Type": "application/json",
    },
    json={
        "prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
        "model": "ideogram-v4-turbo",
        "ideogramParams": {
            "style_type": "AUTO",
            "magic_prompt_option": "Auto",
            "image": "https://example.com/input.jpg",
            "negative_prompt": "What you do NOT want to see…"
        }
    },
)
print(response.json())  # { "jobId": "...", "status": "QUEUED" }
const response = await fetch("https://api.apiframe.ai/v2/images/generate", {
  method: "POST",
  headers: {
    "X-API-Key": "afk_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
    "model": "ideogram-v4-turbo",
    "ideogramParams": {
      "style_type": "AUTO",
      "magic_prompt_option": "Auto",
      "image": "https://example.com/input.jpg",
      "negative_prompt": "What you do NOT want to see…"
    }
  }),
});
const { jobId } = await response.json();
console.log(jobId);

Response & job lifecycle

Generation is asynchronous. A successful submission returns 202 Accepted with a jobId. Poll GET /v2/jobs/{id} (or supply a webhook_url) until the status is COMPLETED; the result field then holds the output URL(s).

1. Submission response (202)

{
  "jobId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
  "status": "QUEUED"
}

2. Poll for the result

curl https://api.apiframe.ai/v2/jobs/JOB_ID \
  -H "X-API-Key: afk_your_api_key_here"
import requests, time

while True:
    job = requests.get(
        "https://api.apiframe.ai/v2/jobs/JOB_ID",
        headers={"X-API-Key": "afk_your_api_key_here"},
    ).json()
    if job["status"] in ("COMPLETED", "FAILED"):
        break
    time.sleep(2)
print(job["result"])
let job;
do {
  await new Promise((r) => setTimeout(r, 2000));
  job = await fetch("https://api.apiframe.ai/v2/jobs/JOB_ID", {
    headers: { "X-API-Key": "afk_your_api_key_here" },
  }).then((r) => r.json());
} while (job.status !== "COMPLETED" && job.status !== "FAILED");
console.log(job.result);

Input schema

Request parameters accepted by the Ideogram v4 Turbo endpoint. Model-specific options are nested under the params object shown below.

Parameter Type Required Default Allowed / range Description
prompt string required — — Text description of what to generate.
model string required "ideogram-v4-turbo" "ideogram-v4-turbo" The model identifier for this endpoint.
ideogramParams.style_type string optional "AUTO" "AUTO", "GENERAL", "REALISTIC", "DESIGN" Style
ideogramParams.magic_prompt_option string optional "Auto" "Auto", "On", "Off" Let Ideogram rewrite your prompt for better results.
ideogramParams.image string (URL) optional — — Reference image (URL)
ideogramParams.negative_prompt string optional — — Negative prompt
ideogramParams.rendering_speed string optional "default" "default", "turbo", "quality" Rendering speed
ideogramParams.seed number optional — step 1 Reuse a number to reproduce the same result.

Related models

Ideogram v3 Balanced iconIdeogram v3 Balanced

Strong typography and posters; balanced speed/quality.

Ideogram v3 Balanced API →
Ideogram v3 Quality iconIdeogram v3 Quality

Highest-quality Ideogram tier.

Ideogram v3 Quality API →
Ideogram v3 Turbo iconIdeogram v3 Turbo

Fast Ideogram for quick iterations.

Ideogram v3 Turbo API →
Ideogram v4 Balanced iconIdeogram v4 Balanced

Fourth-gen Ideogram; balanced speed and quality with sharper text.

Ideogram v4 Balanced API →
Ideogram v4 Quality iconIdeogram v4 Quality

Highest-quality Ideogram v4 tier for production-ready images.

Ideogram v4 Quality API →
Ideogram Character iconIdeogram Character

Generate consistent characters from a reference image.

Ideogram Character API →

Frequently Asked Questions

Common questions about the Ideogram v4 Turbo API.

What is Ideogram v4 Turbo?

The fastest and most affordable tier of Ideogram 4.0, built for rapid drafts and high-volume generation.

How is it different from Balanced and Quality?

Turbo is the quickest and cheapest at about $0.03 per image, Balanced is the everyday standard at about $0.06, and Quality is the slowest and most detailed at about $0.10.

How does v4 compare to v3?

Ideogram 4.0 improves on 3.0’s image-prompt alignment, photorealism, and text rendering, and adds support for higher resolutions.

What is it best for?

Brainstorming, rapid iteration, batch jobs, and cost-sensitive, high-volume work.

How do you get accurate text in an image?

Wrap the words you want in quotation marks within your prompt, and keep the text short for the most reliable results.

Still have questions?

Contact Support Join Discord

Start building with the Ideogram v4 Turbo API

Get your API key and integrate Ideogram v4 Turbo in minutes — Pay-as-you-go.

Free credits to start
One API for every model
Webhooks, SDKs & idempotency
No provider account required
Get Started Free Read Documentation

Questions? Join our Discord or contact sales.