Skip to main content
ArtEmotion
Image

Ideogram v3 Reframe

Credit-based pricing. Supports reference images, batch up to 4.

Ideogram v3 Reframe preview
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 photography
Try 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
FieldTypeRequirementContract
model_idconstantRequiredArtEmotion model identifier.
extraobjectOptionalModel-specific settings may also be nested here.
max_creditsnumberOptionalReject before submission if the estimated list price exceeds this cap. · Range: 1–…
webhook_urlstringOptionalFormat: uri
webhook_secretstringOptionalOptional model input.
folder_idstringOptionalOptional model input.
promptstringRequiredOptional model input.
style_presetstringOptionalStyle 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
stylestringOptionalThe style type to generate with. Cannot be used with style_codes. · Allowed: AUTO, GENERAL, REALISTIC, DESIGN
color_palettestringOptionalA color palette preset to guide the colors of the generated image. · Allowed: EMBER, FRESH, JUNGLE, MAGIC, MELON, MOSAIC, PASTEL, ULTRAMARINE
style_codesarray<string>OptionalList of 8-character hex style codes to guide the image style. Cannot be used with style or image_urls.
image_urlsarray<string>OptionalURLs of images to use as style references (max 10MB total, JPEG/PNG/WebP). Cannot be used with style_codes.
seedintegerOptionalSeed for the random number generator
aspect_ratiostringOptionalAllowed: 1:1, 16:9, 9:16, 4:3, 3:4
resolutionstringOptionalAllowed: 1024
qualitystringOptionalAllowed: low, medium, high
num_imagesintegerOptionalRange: 1–4
reference_image_urlstringRequiredFormat: 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.