Ideogram Character (Edit)

{
  "model_id": "fal-ai/ideogram/character/edit",
  "prompt": "Place the silver-haired warrior standing before the grand throne, her cobalt and gold armor gleaming in the stained glass light, red cape flowing, hand resting on her sword hilt, commanding and regal presence, high fantasy illustration",
  "mask_url": "your_mask_url",
  "reference_image_urls": []
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fideogram%2Fcharacter%2Fedit",
  "title": "Ideogram Character (Edit) generation request",
  "description": "Request body accepted by POST /api/v1/generate for fal-ai/ideogram/character/edit.",
  "type": "object",
  "properties": {
    "model_id": {
      "type": "string",
      "const": "fal-ai/ideogram/character/edit",
      "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"
    },
    "expand_prompt": {
      "title": "Expand Prompt",
      "description": "Determine if MagicPrompt should be used in generating the request or not.",
      "default": true,
      "type": "boolean"
    },
    "mask_url": {
      "title": "Mask Url",
      "description": "Handled by the canvas mask editor.",
      "type": "string"
    },
    "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",
        "format": "uri"
      },
      "minItems": 2,
      "maxItems": 4
    },
    "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 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
    }
  },
  "required": [
    "model_id",
    "prompt",
    "mask_url",
    "reference_image_urls"
  ],
  "additionalProperties": false
}