Ideogram Character

{
  "model_id": "fal-ai/ideogram/character",
  "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",
  "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",
  "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
}