Image GenerationIdeogram
Ideogram V2
High-quality text-to-image generation with superior typography and design capabilities.
POST /v2/images/generate — model: "ideogram-v2"
High-quality text-to-image generation by Ideogram with superior text rendering and typography. Excels at producing images with accurate, readable text elements.
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", "3:2", "2:3", "4:3", "5:4", "3:5", "10:16", "16:10", "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", "Render_3d", "Anime" |
ideogramParams.magic_prompt_option | string | Magic prompt enhancement. Values: "Auto", "On", "Off" |
ideogramParams.negative_prompt | string | Things to avoid in the generation |
ideogramParams.image | string | Image URL for inpainting (use with mask) |
ideogramParams.mask | string | Mask URL for inpainting |
Credit cost
| Credits per generation |
|---|
| 8 |
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 vintage poster with the text \"HELLO WORLD\" in bold retro letters",
"model": "ideogram-v2",
"ideogramParams": {
"aspect_ratio": "3:2",
"style_type": "Design"
}
}'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 vintage poster with the text \"HELLO WORLD\" in bold retro letters",
"model": "ideogram-v2",
"ideogramParams": {
"aspect_ratio": "3:2",
"style_type": "Design",
},
},
)
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 vintage poster with the text \"HELLO WORLD\" in bold retro letters",
model: "ideogram-v2",
ideogramParams: { aspect_ratio: "3:2", style_type: "Design" },
}),
});
console.log(await response.json());Try it
POST
/v2/images/generateTry it