Image
Ideogram v3 Reframe
Credit-based pricing. Supports reference images, batch up to 4.

Output
image
Aspect ratio
1:1, 16:9, 9:16, 4:3, 3:4
Resolution
1024
Max batch
4
Inputs
- Reference image (required)
- Batch up to 4 per request
Example prompt
Expand this portrait into a wide cinematic landscape — reveal the fox is sitting at the edge of a vast ancient forest at golden hour, towering oak trees stretching into the distance, drifting autumn leaves filling the air, a misty valley visible through the trees, epic nature photographyTry this prompt →
LLM-ready
API & LLM schema
Exact request contract for this model. Agents can fetch it from /api/v1/models?id=fal-ai/ideogram/v3/reframe.
POST
/api/v1/generate18 fields · 3 required| Field | Type | Requirement | Contract |
|---|---|---|---|
model_id | constant | Required | ArtEmotion model identifier. |
extra | object | Optional | Model-specific settings may also be nested here. |
max_credits | number | Optional | Reject before submission if the estimated list price exceeds this cap. · Range: 1–… |
webhook_url | string | Optional | Format: uri |
webhook_secret | string | Optional | Optional model input. |
folder_id | string | Optional | Optional model input. |
prompt | string | Required | Optional model input. |
style_preset | string | Optional | Style preset for generation. The chosen style preset will guide the generation. · Allowed: 80S_ILLUSTRATION, 90S_NOSTALGIA, ABSTRACT_ORGANIC, ANALOG_NOSTALGIA, ART_BRUT, ART_DECO, ART_POSTER, AURA, AVANT_GARDE, BAUHAUS, BLUEPRINT, BLURRY_MOTION, BRIGHT_ART, C4D_CARTOON, CHILDRENS_BOOK, COLLAGE, COLORING_BOOK_I, COLORING_BOOK_II, CUBISM, DARK_AURA, DOODLE, DOUBLE_EXPOSURE, DRAMATIC_CINEMA, EDITORIAL, EMOTIONAL_MINIMAL, ETHEREAL_PARTY, EXPIRED_FILM, FLAT_ART, FLAT_VECTOR, FOREST_REVERIE, GEO_MINIMALIST, GLASS_PRISM, GOLDEN_HOUR, GRAFFITI_I, GRAFFITI_II, HALFTONE_PRINT, HIGH_CONTRAST, HIPPIE_ERA, ICONIC, JAPANDI_FUSION, JAZZY, LONG_EXPOSURE, MAGAZINE_EDITORIAL, MINIMAL_ILLUSTRATION, MIXED_MEDIA, MONOCHROME, NIGHTLIFE, OIL_PAINTING, OLD_CARTOONS, PAINT_GESTURE, POP_ART, RETRO_ETCHING, RIVIERA_POP, SPOTLIGHT_80S, STYLIZED_RED, SURREAL_COLLAGE, TRAVEL_POSTER, VINTAGE_GEO, VINTAGE_POSTER, WATERCOLOR, WEIRD, WOODBLOCK_PRINT |
style | string | Optional | The style type to generate with. Cannot be used with style_codes. · Allowed: AUTO, GENERAL, REALISTIC, DESIGN |
color_palette | string | Optional | A color palette preset to guide the colors of the generated image. · Allowed: EMBER, FRESH, JUNGLE, MAGIC, MELON, MOSAIC, PASTEL, ULTRAMARINE |
style_codes | array<string> | Optional | List of 8-character hex style codes to guide the image style. Cannot be used with style or image_urls. |
image_urls | array<string> | Optional | URLs of images to use as style references (max 10MB total, JPEG/PNG/WebP). Cannot be used with style_codes. |
seed | integer | Optional | Seed for the random number generator |
aspect_ratio | string | Optional | Allowed: 1:1, 16:9, 9:16, 4:3, 3:4 |
resolution | string | Optional | Allowed: 1024 |
quality | string | Optional | Allowed: low, medium, high |
num_images | integer | Optional | Range: 1–4 |
reference_image_url | string | Required | Format: uri |
Minimal request example
{
"model_id": "fal-ai/ideogram/v3/reframe",
"prompt": "Expand this portrait into a wide cinematic landscape — reveal the fox is sitting at the edge of a vast ancient forest at golden hour, towering oak trees stretching into the distance, drifting autumn leaves filling the air, a misty valley visible through the trees, epic nature photography",
"reference_image_url": "https://example.com/reference_image"
}Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fideogram%2Fv3%2Freframe",
"title": "Ideogram v3 Reframe generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/ideogram/v3/reframe.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/ideogram/v3/reframe",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"style_preset": {
"title": "Style Preset",
"description": "Style preset for generation. The chosen style preset will guide the generation.",
"type": "string",
"enum": [
"80S_ILLUSTRATION",
"90S_NOSTALGIA",
"ABSTRACT_ORGANIC",
"ANALOG_NOSTALGIA",
"ART_BRUT",
"ART_DECO",
"ART_POSTER",
"AURA",
"AVANT_GARDE",
"BAUHAUS",
"BLUEPRINT",
"BLURRY_MOTION",
"BRIGHT_ART",
"C4D_CARTOON",
"CHILDRENS_BOOK",
"COLLAGE",
"COLORING_BOOK_I",
"COLORING_BOOK_II",
"CUBISM",
"DARK_AURA",
"DOODLE",
"DOUBLE_EXPOSURE",
"DRAMATIC_CINEMA",
"EDITORIAL",
"EMOTIONAL_MINIMAL",
"ETHEREAL_PARTY",
"EXPIRED_FILM",
"FLAT_ART",
"FLAT_VECTOR",
"FOREST_REVERIE",
"GEO_MINIMALIST",
"GLASS_PRISM",
"GOLDEN_HOUR",
"GRAFFITI_I",
"GRAFFITI_II",
"HALFTONE_PRINT",
"HIGH_CONTRAST",
"HIPPIE_ERA",
"ICONIC",
"JAPANDI_FUSION",
"JAZZY",
"LONG_EXPOSURE",
"MAGAZINE_EDITORIAL",
"MINIMAL_ILLUSTRATION",
"MIXED_MEDIA",
"MONOCHROME",
"NIGHTLIFE",
"OIL_PAINTING",
"OLD_CARTOONS",
"PAINT_GESTURE",
"POP_ART",
"RETRO_ETCHING",
"RIVIERA_POP",
"SPOTLIGHT_80S",
"STYLIZED_RED",
"SURREAL_COLLAGE",
"TRAVEL_POSTER",
"VINTAGE_GEO",
"VINTAGE_POSTER",
"WATERCOLOR",
"WEIRD",
"WOODBLOCK_PRINT"
]
},
"style": {
"title": "Style",
"description": "The style type to generate with. Cannot be used with style_codes.",
"type": "string",
"enum": [
"AUTO",
"GENERAL",
"REALISTIC",
"DESIGN"
]
},
"color_palette": {
"title": "Color Palette",
"description": "A color palette preset to guide the colors of the generated image.",
"type": "string",
"enum": [
"EMBER",
"FRESH",
"JUNGLE",
"MAGIC",
"MELON",
"MOSAIC",
"PASTEL",
"ULTRAMARINE"
]
},
"style_codes": {
"title": "Style Codes",
"description": "List of 8-character hex style codes to guide the image style. Cannot be used with style or image_urls.",
"type": "array",
"items": {
"type": "string"
}
},
"image_urls": {
"title": "Style Reference Images",
"description": "URLs of images to use as style references (max 10MB total, JPEG/PNG/WebP). Cannot be used with style_codes.",
"type": "array",
"items": {
"type": "string"
}
},
"seed": {
"title": "Seed",
"description": "Seed for the random number generator",
"type": "integer"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
},
"quality": {
"type": "string",
"enum": [
"low",
"medium",
"high"
]
},
"num_images": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"reference_image_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"model_id",
"prompt",
"reference_image_url"
],
"additionalProperties": false
}FAQ
How much does Ideogram v3 Reframe cost on ArtEmotion?
Credit-based pricing. You pay in ArtEmotion credits — every plan and top-up converts USD to credits at a fixed rate.
Do I get my credits back if Ideogram v3 Reframe fails?
Yes — failed generations are never charged. The credits are released back to your balance automatically.
Can I call Ideogram v3 Reframe from the API?
Yes. Use POST /api/v1/generate with model_id: "fal-ai/ideogram/v3/reframe". See the API reference for the full schema.
Where are my generations stored?
Every output is saved to your personal Library. You can export or delete everything any time from Privacy & deletion.
Ready to generate with Ideogram v3 Reframe?
Start now →No commitment. New accounts get 50 free credits on signup. See pricing.