Image GenerationIdeogram
Ideogram V3 Balanced
Third-generation Ideogram model balancing quality and speed, with style presets and style references.
POST /v2/images/generate — model: "ideogram-v3-balanced"
Third-generation Ideogram model offering a balanced trade-off between quality and speed. Supports style presets and style reference images for fine-grained creative control.
See Image Generation overview for common request fields, response format, and error codes.
Model-specific parameters
| Parameter | Type | Description |
|---|---|---|
ideogramParams.aspect_ratio | string | Aspect ratio. Values: "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "16:10", "10:16", "3:1", "1:3" |
ideogramParams.resolution | string | Image resolution (e.g. "1024x1024"). Use "None" for default |
ideogramParams.seed | integer | Random seed for reproducible generation |
ideogramParams.style_type | string | Style type. Values: "None", "Auto", "General", "Realistic", "Design" |
ideogramParams.magic_prompt_option | string | Magic prompt enhancement. Values: "Auto", "On", "Off" |
ideogramParams.style_preset | string | Artistic style preset (e.g. "Pop Art", "Watercolor", "Art Deco", "Bauhaus", "80s Illustration", and many more) |
ideogramParams.style_reference_images | string[] | Array of up to 3 image URLs to use as style references |
ideogramParams.image | string | Image URL for inpainting (use with mask) |
ideogramParams.mask | string | Mask URL for inpainting |
Credit cost
| Credits per generation |
|---|
| 11 |
Example result
Once the job is COMPLETED, the result object on GET /v2/jobs/:id looks like:
{
"images": [
"https://cdn2.apiframe.ai/images/a1b2c3d4-e5f6-7890-abcd-ef1234567890-1.png"
]
}See Result format for field details.
Code examples
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 serene Japanese garden with cherry blossoms",
"model": "ideogram-v3-balanced",
"ideogramParams": {
"aspect_ratio": "16:9",
"style_type": "Realistic",
"style_preset": "Watercolor"
}
}'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 serene Japanese garden with cherry blossoms",
"model": "ideogram-v3-balanced",
"ideogramParams": {
"aspect_ratio": "16:9",
"style_type": "Realistic",
"style_preset": "Watercolor",
},
},
)
print(response.json())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 serene Japanese garden with cherry blossoms",
model: "ideogram-v3-balanced",
ideogramParams: {
aspect_ratio: "16:9",
style_type: "Realistic",
style_preset: "Watercolor",
},
}),
});
console.log(await response.json());Try it
POST
/v2/images/generateTry it