Ideogram v3 Turbo API
Fast Ideogram for quick iterations.
Integrate Ideogram v3 Turbo with a single API call — one key, one unified endpoint, and shared billing across every model on Apiframe.
model: "ideogram-v3-turbo" What's special about Ideogram v3 Turbo
- 5 aspect ratios, including 1:1, 3:4, 4:3.
- Image-to-image editing and reference-image support.
- Fast turnaround — about 15s per generation on average.
- Pay-as-you-go pricing with no Ideogram account required — you only pay for successful generations.
- One API key, unified billing, idempotency and webhooks across every Apiframe model.
Made with Ideogram v3 Turbo
A few outputs generated through the Ideogram v3 Turbo API on Apiframe.
A cinematic portrait of an astronaut in a neon-lit alley, 85mm, shallow depth of field
Cozy isometric coffee shop, warm morning light, highly detailed 3D render
A majestic snow leopard on a misty mountain ridge at golden hour
Overview
- Endpoint
- POST /v2/images/generate
- Model ID
- ideogram-v3-turbo
- Params key
- ideogramParams
- Modality
- image
- Provider
- Ideogram
- Pricing
- Pay-as-you-go
- Avg. completion
- ~15s
Capabilities
Quick start
Send a single POST /v2/images/generate request with your API key to
generate with Ideogram v3 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-v3-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-v3-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-v3-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 v3 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-v3-turbo" | "ideogram-v3-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. |
Frequently Asked Questions
Common questions about the Ideogram v3 Turbo API.
Is there an API for Ideogram v3 Turbo?
Yes. Apiframe exposes Ideogram v3 Turbo through a single REST endpoint (`POST /v2/images/generate` with `model: "ideogram-v3-turbo"`). You get one unified API, key, and billing across every supported model — no separate Ideogram account required.
How much does the Ideogram v3 Turbo API cost?
Ideogram v3 Turbo uses simple pay-as-you-go pricing on Apiframe — you only pay for successful generations. See the pricing page for plans and volume discounts.
How do I call the Ideogram v3 Turbo API?
Send a POST request to `/v2/images/generate` with your `X-API-Key` and a JSON body containing `model: "ideogram-v3-turbo"`. The call returns a `jobId`; poll `GET /v2/jobs/{id}` or use a webhook to receive the result.
What parameters does Ideogram v3 Turbo support?
Ideogram v3 Turbo accepts 6 model-specific parameters (nested under `ideogramParams`) plus the common `prompt` and `webhook_url` fields. See the input schema above for the full list with types and defaults.
Still have questions?
Start building with the Ideogram v3 Turbo API
Get your API key and integrate Ideogram v3 Turbo in minutes — Pay-as-you-go.
Questions? Join our Discord or contact sales.