HiDream Edit

{
  "model_id": "fal-ai/hidream-i1-full/image-to-image",
  "prompt": "Transform her into a Victorian-era aristocrat wearing an elaborate emerald green silk gown with gold embroidery and a pearl necklace, ornate upswept hair adorned with jeweled pins, standing in a grand 19th century parlour with velvet drapes, gilded mirrors, and candlelit chandeliers, oil painting realism",
  "reference_image_url": "https://example.com/reference_image"
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fhidream-i1-full%2Fimage-to-image",
  "title": "HiDream Edit generation request",
  "description": "Request body accepted by POST /api/v1/generate for fal-ai/hidream-i1-full/image-to-image.",
  "type": "object",
  "properties": {
    "model_id": {
      "type": "string",
      "const": "fal-ai/hidream-i1-full/image-to-image",
      "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 inference steps. More = higher quality, slower.",
      "default": 50,
      "type": "number",
      "minimum": 1,
      "maximum": 50,
      "multipleOf": 1
    },
    "guidance_scale": {
      "title": "Guidance Scale",
      "description": "How closely to follow the prompt. Higher = more faithful, less creative.",
      "default": 5,
      "type": "number",
      "minimum": 0,
      "maximum": 20,
      "multipleOf": 0.1
    },
    "strength": {
      "title": "Strength",
      "description": "Denoising strength. 0 = identical to input, 1 = full transformation.",
      "default": 0.75,
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "multipleOf": 0.01
    },
    "negative_prompt": {
      "title": "Negative Prompt",
      "description": "Elements to exclude from the image — colors, objects, styles, or qualities to avoid.",
      "default": "",
      "type": "string"
    },
    "enable_safety_checker": {
      "title": "Safety Checker",
      "description": "Filter potentially unsafe content from the output.",
      "default": true,
      "type": "boolean"
    },
    "lora_path": {
      "title": "LoRA Path",
      "description": "URL or Hugging Face path to LoRA weights (e.g. username/repo or https://…).",
      "type": "string"
    },
    "lora_scale": {
      "title": "LoRA Scale",
      "description": "Strength of the LoRA effect. 1 = default weight, higher = stronger influence.",
      "default": 1,
      "type": "number",
      "minimum": 0,
      "maximum": 4,
      "multipleOf": 0.05
    },
    "lora_weight_name": {
      "title": "LoRA Weight Name",
      "description": "Safetensors filename within the HuggingFace repo (only needed if the repo has multiple .safetensors files).",
      "type": "string"
    },
    "lora_path_2": {
      "title": "LoRA Path 2",
      "description": "URL or Hugging Face path to a second set of LoRA weights.",
      "type": "string"
    },
    "lora_scale_2": {
      "title": "LoRA Scale 2",
      "description": "Strength of the second LoRA.",
      "default": 1,
      "type": "number",
      "minimum": 0,
      "maximum": 4,
      "multipleOf": 0.05
    },
    "lora_weight_name_2": {
      "title": "LoRA Weight Name 2",
      "description": "Safetensors filename for the second LoRA repo (optional).",
      "type": "string"
    },
    "lora_path_3": {
      "title": "LoRA Path 3",
      "description": "URL or Hugging Face path to a third set of LoRA weights.",
      "type": "string"
    },
    "lora_scale_3": {
      "title": "LoRA Scale 3",
      "description": "Strength of the third LoRA.",
      "default": 1,
      "type": "number",
      "minimum": 0,
      "maximum": 4,
      "multipleOf": 0.05
    },
    "lora_weight_name_3": {
      "title": "LoRA Weight Name 3",
      "description": "Safetensors filename for the third LoRA repo (optional).",
      "type": "string"
    },
    "output_format": {
      "title": "Output Format",
      "description": "The format of the generated image.",
      "default": "jpeg",
      "type": "string",
      "enum": [
        "jpeg",
        "png"
      ]
    },
    "seed": {
      "title": "Seed",
      "description": "The same seed and the same prompt will output the same image every time.",
      "type": "integer"
    },
    "aspect_ratio": {
      "type": "string",
      "enum": [
        "1:1",
        "16:9",
        "9:16",
        "4:3",
        "3:4"
      ]
    },
    "resolution": {
      "type": "string",
      "enum": [
        "1024",
        "2048"
      ]
    },
    "num_images": {
      "type": "integer",
      "minimum": 1,
      "maximum": 4
    },
    "reference_image_url": {
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "model_id",
    "prompt",
    "reference_image_url"
  ],
  "additionalProperties": false
}