jlamoreaux/image-in-image

Intelligently composite one generated image into another with natural lighting and perspective matching, perfect for creating mockups and visualizations.

Public

2 runs

Run with an API

Pricing

Playground API Examples README

Run jlamoreaux/image-in-image with an API

Use one of our client libraries to get started quickly. Clicking on a library will take you to the Playground tab where you can tweak different inputs, see the results, and copy the corresponding code to use in your own project.

Input schema

The fields you can use to run this model with an API. If you don't give a value for a field its default value will be used.

Field	Type	Default value	Description
composition_type	None	billboard	Type of image composition to create
scene_description	string		Describe the main scene (e.g., 'desert highway', 'person holding photo', 'living room wall')
overlay_content	string		What should be in the overlaid image (e.g., 'band photo', 'advertisement', 'artwork')
overlay_image	string		Custom image to use as overlay (leave empty to generate from overlay_content)
style	None	realistic	Overall style of the composition
integration_quality	None	high	Quality level of AI integration (higher = more processing time)
main_aspect_ratio	None	16:9	Aspect ratio for the final composition
lighting_match	boolean	True	Match lighting between main scene and overlay
perspective_correction	boolean	True	Apply perspective correction to overlay
seed	integer		Random seed for reproducible generation

{
  "type": "object",
  "title": "Input",
  "required": [
    "scene_description",
    "overlay_content"
  ],
  "properties": {
    "seed": {
      "type": "integer",
      "title": "Seed",
      "x-order": 9,
      "nullable": true,
      "description": "Random seed for reproducible generation"
    },
    "style": {
      "enum": [
        "realistic",
        "cinematic",
        "vintage",
        "modern",
        "artistic",
        "dramatic",
        "bright",
        "moody"
      ],
      "type": "string",
      "title": "style",
      "description": "Overall style of the composition",
      "default": "realistic",
      "x-order": 4
    },
    "overlay_image": {
      "type": "string",
      "title": "Overlay Image",
      "format": "uri",
      "x-order": 3,
      "nullable": true,
      "description": "Custom image to use as overlay (leave empty to generate from overlay_content)"
    },
    "lighting_match": {
      "type": "boolean",
      "title": "Lighting Match",
      "default": true,
      "x-order": 7,
      "description": "Match lighting between main scene and overlay"
    },
    "overlay_content": {
      "type": "string",
      "title": "Overlay Content",
      "x-order": 2,
      "description": "What should be in the overlaid image (e.g., 'band photo', 'advertisement', 'artwork')"
    },
    "composition_type": {
      "enum": [
        "billboard",
        "photograph_in_hands",
        "poster_on_wall",
        "screen_display",
        "book_cover",
        "magazine_cover",
        "album_artwork",
        "product_placement",
        "artwork_in_frame",
        "billboard_digital",
        "window_reflection",
        "custom"
      ],
      "type": "string",
      "title": "composition_type",
      "description": "Type of image composition to create",
      "default": "billboard",
      "x-order": 0
    },
    "main_aspect_ratio": {
      "enum": [
        "1:1",
        "16:9",
        "21:9",
        "3:2",
        "2:3",
        "4:5",
        "5:4",
        "9:16",
        "9:21"
      ],
      "type": "string",
      "title": "main_aspect_ratio",
      "description": "Aspect ratio for the final composition",
      "default": "16:9",
      "x-order": 6
    },
    "scene_description": {
      "type": "string",
      "title": "Scene Description",
      "x-order": 1,
      "description": "Describe the main scene (e.g., 'desert highway', 'person holding photo', 'living room wall')"
    },
    "integration_quality": {
      "enum": [
        "basic",
        "high",
        "ultra"
      ],
      "type": "string",
      "title": "integration_quality",
      "description": "Quality level of AI integration (higher = more processing time)",
      "default": "high",
      "x-order": 5
    },
    "perspective_correction": {
      "type": "boolean",
      "title": "Perspective Correction",
      "default": true,
      "x-order": 8,
      "description": "Apply perspective correction to overlay"
    }
  }
}

Output schema

The shape of the response you’ll get when you run this model with an API.

Schema

{
  "type": "object",
  "title": "Output",
  "required": [
    "main_image",
    "composite_image",
    "enhanced_main_prompt",
    "enhanced_overlay_prompt",
    "overlay_image"
  ],
  "properties": {
    "main_image": {
      "type": "string",
      "title": "Main Image",
      "format": "uri"
    },
    "overlay_image": {
      "type": "string",
      "title": "Overlay Image",
      "format": "uri"
    },
    "composite_image": {
      "type": "string",
      "title": "Composite Image",
      "format": "uri"
    },
    "enhanced_main_prompt": {
      "type": "string",
      "title": "Enhanced Main Prompt"
    },
    "enhanced_overlay_prompt": {
      "type": "string",
      "title": "Enhanced Overlay Prompt"
    }
  }
}