Image GenerationIdeogram
Ideogram Character
Character-consistent image generation with reference image support and tiered rendering speed.
POST /v2/images/generate — model: "ideogram-character"
Generate images with consistent character appearance using a reference image. Supports three rendering speed tiers (turbo, default, quality) that determine both generation time and credit cost.
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: "Auto", "Fiction", "Realistic" |
ideogramParams.magic_prompt_option | string | Magic prompt enhancement. Values: "Auto", "On", "Off" |
ideogramParams.rendering_speed | string | Rendering speed tier — determines quality and cost. Values: "turbo", "default", "quality" |
ideogramParams.character_reference_image | string | URL of a character reference image for consistent appearance |
ideogramParams.image | string | Image URL for inpainting (use with mask) |
ideogramParams.mask | string | Mask URL for inpainting |
Credit cost
| Rendering Speed | Credits per generation |
|---|---|
"turbo" | 10 |
"default" | 15 |
"quality" | 20 |
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 warrior character standing on a mountain cliff at sunset",
"model": "ideogram-character",
"ideogramParams": {
"aspect_ratio": "9:16",
"rendering_speed": "default",
"style_type": "Fiction",
"character_reference_image": "https://example.com/character.png"
}
}'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 warrior character standing on a mountain cliff at sunset",
"model": "ideogram-character",
"ideogramParams": {
"aspect_ratio": "9:16",
"rendering_speed": "default",
"style_type": "Fiction",
"character_reference_image": "https://example.com/character.png",
},
},
)
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 warrior character standing on a mountain cliff at sunset",
model: "ideogram-character",
ideogramParams: {
aspect_ratio: "9:16",
rendering_speed: "default",
style_type: "Fiction",
character_reference_image: "https://example.com/character.png",
},
}),
});
console.log(await response.json());Try it
POST
/v2/images/generateTry it