{"version":"1","model":{"id":"fal-ai/ideogram/character","name":"Ideogram Character","kind":"image","availability":"available","available":true,"restricted":false,"api_key_only":false,"description":"Ideogram Character — generates consistent character scenes from a reference identity image.","categories":["character"],"prompt_required":true,"prompt_supported":true,"supports":{"referenceImage":true},"requires":{"referenceImage":true},"aspect_ratios":["1:1","16:9","9:16","4:3","3:4"],"resolutions":["1024"],"qualities":["low","medium","high"],"durations":[],"max_images":4,"base_credits":13,"api_gross_margin_percent":20,"added_at":"2026-05-09","popularity_rank":172,"example_prompt":"The botanist standing inside a magnificent Victorian greenhouse surrounded by towering tropical plants and exotic flowers, holding a glowing blue terrarium, warm golden light streaming through the glass ceiling, cinematic botanical illustration","preview":{"image":"https://cdn.artemotion.ai/file/artemotion-ai-bckt/model-previews/ideogram-character-sm.webp"},"schema_url":"/api/v1/models?id=fal-ai%2Fideogram%2Fcharacter","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fideogram%2Fcharacter","title":"Ideogram Character generation request","description":"Request body accepted by POST /api/v1/generate for fal-ai/ideogram/character.","type":"object","properties":{"model_id":{"type":"string","const":"fal-ai/ideogram/character","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"},"negative_prompt":{"title":"Negative Prompt","description":"Description of what to exclude from an image. Descriptions in the prompt take precedence to descriptions in the negative prompt.","default":"","type":"string"},"expand_prompt":{"title":"Expand Prompt","description":"Determine if MagicPrompt should be used in generating the request or not.","default":true,"type":"boolean"},"style":{"title":"Style","description":"The style type to generate with. Cannot be used with style_codes.","default":"AUTO","type":"string","enum":["AUTO","REALISTIC","FICTION"]},"reference_image_urls":{"title":"Character Reference Images","description":"URLs of images to use as character references. Currently only one image is supported.","type":"array","items":{"type":"string"}},"reference_mask_urls":{"title":"Character Reference Masks","description":"Masks to apply to the character references. Currently only one mask is supported.","type":"array","items":{"type":"string"}},"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_urls"],"additionalProperties":false},"parameters":[{"key":"negative_prompt","label":"Negative Prompt","type":"text","default":"","description":"Description of what to exclude from an image. Descriptions in the prompt take precedence to descriptions in the negative prompt."},{"key":"expand_prompt","label":"Expand Prompt","type":"toggle","default":true,"description":"Determine if MagicPrompt should be used in generating the request or not."},{"key":"style","label":"Style","type":"select","default":"AUTO","options":["AUTO","REALISTIC","FICTION"],"description":"The style type to generate with. Cannot be used with style_codes."},{"key":"reference_image_urls","label":"Character Reference Images","type":"string_array","description":"URLs of images to use as character references. Currently only one image is supported."},{"key":"reference_mask_urls","label":"Character Reference Masks","type":"string_array","description":"Masks to apply to the character references. Currently only one mask is supported."},{"key":"color_palette","label":"Color Palette","type":"select","options":["EMBER","FRESH","JUNGLE","MAGIC","MELON","MOSAIC","PASTEL","ULTRAMARINE"],"description":"A color palette preset to guide the colors of the generated image."},{"key":"style_codes","label":"Style Codes","type":"string_array","description":"List of 8-character hex style codes to guide the image style. Cannot be used with style or image_urls."},{"key":"image_urls","label":"Style Reference Images","type":"string_array","description":"URLs of images to use as style references (max 10MB total, JPEG/PNG/WebP). Cannot be used with style_codes."},{"key":"seed","label":"Seed","type":"seed","description":"Seed for the random number generator"}]}}