Instant Background V2

Action ID: instant_background_v2

Description

Instantly create stunning AI-generated scene backgrounds for your product images with one click, offering commercial-grade quality and a diverse style selection for every need

Connection

Name	Description	Required	Category
PixelML Connection	The PixelML connection to call PixelML API.	True	pixelml

Input Schema

{
  "description": "instant background v2 node input.",
  "properties": {
    "image_url": {
      "title": "Image url",
      "type": "string"
    },
    "prompt": {
      "title": "Describe the new background you want to add to the image.",
      "type": "string"
    },
    "negative_prompt": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Negative prompt"
    },
    "padding_top": {
      "anyOf": [
        {
          "maximum": 512,
          "minimum": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Padding top"
    },
    "padding_bottom": {
      "anyOf": [
        {
          "maximum": 512,
          "minimum": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Padding bottom"
    },
    "padding_left": {
      "anyOf": [
        {
          "maximum": 512,
          "minimum": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Padding left"
    },
    "padding_right": {
      "anyOf": [
        {
          "maximum": 512,
          "minimum": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Padding right"
    }
  },
  "required": [
    "image_url",
    "prompt",
    "negative_prompt",
    "padding_top",
    "padding_bottom",
    "padding_left",
    "padding_right"
  ],
  "title": "InstantbackgroundV2NodeInput",
  "type": "object"
}

Output Schema

{
  "description": "instant background v2 node output.",
  "properties": {
    "image": {
      "title": "Image output",
      "type": "string"
    }
  },
  "required": [
    "image"
  ],
  "title": "InstantbackgroundV2NodeOutput",
  "type": "object"
}

How It Works

This node uses PixelML's AI to automatically remove the existing background from your product image and replace it with a stunning AI-generated scene based on your text prompt. The AI intelligently detects the main subject, preserves its details and lighting, and seamlessly composites it onto the new background. You can control canvas expansion using padding parameters to add space around your subject, and use negative prompts to exclude unwanted elements from the generated background.

Usage Examples

Example 1: Product Photography with Natural Background

Input:

image_url: "https://example.com/watch-product.jpg"
prompt: "Luxury wooden desk with soft natural sunlight, elegant minimalist office setting"
negative_prompt: "cluttered, messy, dark, blurry"
padding_top: 100
padding_bottom: 100
padding_left: 150
padding_right: 150

Output:

image: "https://pixelml.com/output/watch-elegant-desk-bg.jpg"

Example 2: E-Commerce Fashion with Studio Background

Input:

image_url: "https://example.com/sneaker.png"
prompt: "Professional photography studio with white seamless backdrop, studio lighting setup, commercial product shoot"
negative_prompt: "outdoor, natural, shadows, reflections"
padding_top: 50
padding_bottom: 50
padding_left: 50
padding_right: 50

Output:

image: "https://pixelml.com/output/sneaker-studio-bg.jpg"

Example 3: Lifestyle Scene for Social Media

Input:

image_url: "https://example.com/coffee-mug.jpg"
prompt: "Cozy coffee shop interior, warm ambient lighting, wooden table with plants, instagram aesthetic"
negative_prompt: "people, faces, text, logos"
padding_top: 200
padding_bottom: 100
padding_left: 200
padding_right: 200

Output:

image: "https://pixelml.com/output/coffee-lifestyle-bg.jpg"

Common Use Cases

• E-Commerce Product Photography: Create professional product images with various background styles for online stores without expensive photoshoots

• Social Media Marketing: Generate eye-catching product images with lifestyle backgrounds for Instagram, Facebook, and other platforms

• A/B Testing: Quickly create multiple background variations of the same product to test which performs best with your audience

• Seasonal Campaigns: Transform product images with holiday-themed or seasonal backgrounds without reshooting inventory

• Brand Consistency: Maintain consistent background styles across your entire product catalog for professional presentation

• Cost Reduction: Eliminate the need for expensive studio rentals, professional photographers, and multiple photoshoots

• Rapid Prototyping: Visualize products in different environments before committing to physical photoshoots

Error Handling

Error Type	Cause	Solution
Invalid Image Format	Image format not supported (not PNG, JPEG, JPG, or WebP)	Convert your image to PNG, JPG, JPEG, or WebP format before processing
Image URL Not Accessible	Image URL is broken or not publicly accessible	Ensure the image URL is valid and publicly accessible without authentication
Subject Detection Failed	AI cannot identify the main subject in the image	Use images with clear, well-defined subjects and good contrast with the background
Padding Exceeds Limit	Padding values exceed maximum of 512 pixels	Reduce padding values to 512 pixels or less per side
Negative Padding	Padding values are negative numbers	Use positive integer values (0-512) for all padding parameters
Empty Prompt	Prompt field is empty or null	Provide a descriptive text prompt explaining the desired background scene
PixelML Connection Error	Invalid or missing PixelML API credentials	Verify your PixelML connection is properly configured with valid API key

Notes

• Image Quality: Use high-resolution product images (minimum 1000px on the longest side) for best results and commercial-grade output

• Subject Clarity: Images with clear subject separation from the background produce better results than busy or complex compositions

• Padding Control: Use padding to add breathing room around your subject and create professional composition with the new background

• Prompt Specificity: Detailed prompts produce more accurate backgrounds. Include lighting, style, mood, and setting details

• Negative Prompts: Use negative prompts to prevent unwanted elements like people, text, or clutter from appearing in the background

• Processing Time: Complex backgrounds may take 30-60 seconds to generate depending on image size and prompt complexity

• Commercial Use: PixelML-generated backgrounds are suitable for commercial use in e-commerce and marketing materials

• Batch Processing: Process multiple products with the same background prompt to maintain consistency across your catalog