PuLID

{
  "model_id": "fal-ai/pulid",
  "prompt": "The same person as a heroic knight in shining armor, standing at the gates of a medieval castle at sunset, cinematic lighting, ultra detailed",
  "reference_image_urls": []
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fpulid",
  "title": "PuLID generation request",
  "description": "Request body accepted by POST /api/v1/generate for fal-ai/pulid.",
  "type": "object",
  "properties": {
    "model_id": {
      "type": "string",
      "const": "fal-ai/pulid",
      "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"
    },
    "num_inference_steps": {
      "title": "Steps",
      "description": "Number of denoising steps.",
      "default": 4,
      "type": "number",
      "minimum": 1,
      "maximum": 12,
      "multipleOf": 1
    },
    "id_scale": {
      "title": "ID Scale",
      "description": "Strength of identity preservation. Higher = closer to the reference face.",
      "default": 0.8,
      "type": "number",
      "minimum": 0,
      "maximum": 5
    },
    "guidance_scale": {
      "title": "Guidance Scale",
      "description": "Classifier-free guidance scale.",
      "default": 1.2,
      "type": "number",
      "minimum": 1,
      "maximum": 1.5,
      "multipleOf": 0.05
    },
    "mode": {
      "title": "Mode",
      "description": "Fidelity preserves facial features closely; extreme style allows stronger artistic transformation.",
      "default": "fidelity",
      "type": "string",
      "enum": [
        "fidelity",
        "extreme style"
      ]
    },
    "id_mix": {
      "title": "ID Mix",
      "description": "Enable to blend identity from two reference images instead of one.",
      "default": false,
      "type": "boolean"
    },
    "negative_prompt": {
      "title": "Negative Prompt",
      "description": "Elements to exclude from the generated image.",
      "default": "flaws in the eyes, flaws in the face, flaws, lowres, non-HDRi, low quality, worst quality,artifacts noise, text, watermark, glitch, deformed, mutated, ugly, disfigured, hands, low resolution, partially rendered objects,  deformed or partially rendered eyes, deformed, deformed eyeballs, cross-eyed,blurry",
      "type": "string"
    },
    "seed": {
      "title": "Seed",
      "description": "Random seed for reproducibility.",
      "type": "integer"
    },
    "aspect_ratio": {
      "type": "string",
      "enum": [
        "1:1",
        "16:9",
        "9:16",
        "4:3",
        "3:4"
      ]
    },
    "resolution": {
      "type": "string",
      "enum": [
        "1024"
      ]
    },
    "num_images": {
      "type": "integer",
      "minimum": 1,
      "maximum": 4
    },
    "reference_image_urls": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      },
      "maxItems": 4
    }
  },
  "required": [
    "model_id",
    "prompt",
    "reference_image_urls"
  ],
  "additionalProperties": false
}