# AI Bulk Image Editor (`peaceful_pushpins/ai-bulk-image-editor`) Actor AI-powered bulk photo editor for influencers, e-commerce, brands, photographers, food bloggers, real estate, and advertisers. Instantly transform up to 1000 images into professional, commercial, or artistic visuals optimized for social media, marketplaces, portfolios, and marketing campaigns. - **URL**: https://apify.com/peaceful\_pushpins/ai-bulk-image-editor.md - **Developed by:** [Wasim Safdar](https://apify.com/peaceful_pushpins) (community) - **Categories:** AI, Automation, Social media - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $1,490.00 / 1,000 standard models This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## πŸ–ΌοΈ AI Bulk Image Editor AI Bulk Image Editor is an advanced AI-powered tool that can intelligently edit up to **1,000 images in a single batch**. Instead of applying the same edits to every image, it analyzes each image individually and combines **AI recommendations** with your **custom instructions** to produce high-quality, professional results. Whether you want subtle retouching, commercial product photography, or artistic transformations, the actor automatically determines the best enhancements while still giving you full control over the editing process. It is designed for: πŸ“Έ **Professional photographers** πŸ‘©β€πŸ’Ό **Influencers and content creators** πŸ›οΈ **E-commerce businesses** πŸ” **Food bloggers and restaurants** 🏑 **Real estate agents** 🎨 **Digital artists** πŸ“± **Social media marketers** 🏒 **Marketing agencies** ### πŸ€– Intelligent AI-Powered Editing Unlike traditional batch editors that apply identical edits to every image, this actor performs individual **AI visual analysis** for each photo. For every image, the AI can: - **Detect quality issues** - **Analyze lighting, composition, colors, and overall appearance** - **Recommend the most suitable edits** - **Combine AI recommendations with your manual instructions** - **Generate an optimized editing prompt for the selected AI model** This hybrid workflow combines **human creativity** with **AI decision-making** to produce consistently professional results. ### πŸš€ Multiple AI Models Choose the AI model that best fits your project and budget. Supported models include: - **GPT Image** - **FLUX Kontext** - **Seedream 5 Lite** - **Qwen Image** - **Gemini Image** Different models excel at different tasks. Some are particularly effective for **portrait enhancement** and **influencer content**, while others produce exceptional results for **commercial product photography**, **advertising creatives**, or **artistic transformations**. The actor gives you complete freedom to select the model that matches your quality, speed, and cost requirements. ### ✨ Key Features #### Three Editing Modes It supports three editing modes **1. Professional Photo Editing** **2. Product Advertising** **3. Artistic Transformations** Other key features are: - **AI Visual Analysis** - **Commercial Product Photography** - **Professional Portrait Retouching** - **Art Style Transformations** - **AI-Generated HTML Report** - **Bulk Processing (up to 1,000 images)** - **Multiple AI Models** - **Professional Quality Scoring** - **ZIP Download of Edited Images** - **Supports JPG, JPEG & PNG** - **AI Decide Mode for automatic configuration** ### Actor's Input | Input | Type | Description | | ---------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `imageZipFile` | string | Upload a ZIP file containing images to edit (JPG, JPEG, PNG). Supports up to **1,000 images**. | | `noOfImages` | integer | Number of highest-quality images to process. | | `editingMode` | string | Editing mode. Options: `"Product Photography & Advertising"`, `"Professional Photo Editing"`, `"Artistic Style Transformation"`. | | `qualityTier` | string | AI model to use. Options include **Basic**, **Standard**, and **Premium** models such as GPT Image, FLUX Kontext, Seedream, Qwen, and Gemini. | | `targetAudiences` | array | Target audience(s). Example: `["general_social_media"]`, `["fashion","beauty"]`. Used in Professional and Product Advertising modes. | | `editingStyle` | string | Desired editing style. Options include `"Natural"`, `"Commercial"`, `"Editorial"`, `"Luxury"`, `"Vibrant"`, `"Minimalist"`, or `"AIDecide"`. | | `transformationLevel` | string | Editing intensity. Options: `"Light Touch"`, `"Moderate"`, `"Complete Makeover"`, or `"AIDecide"`. | | `targetPlatform` | string | Target platform. Options include `"instagram"`, `"tiktok"`, `"youtube"`, `"linkedin"`, `"facebook"`, `"pinterest"`, `"Unsplash"`, `"Behance"`, `"Shutterstock"`, `"Pexels"`, `"500px"`, `"Flickr"`. | | `manualOptions` | array | Additional manual editing instructions for Professional mode. | | `manualOptionsProduct` | array | Additional commercial editing instructions for Product Advertising mode. | | `productPresentation` | array | Product presentation style(s). Used in Product Advertising mode. Supports `"AIDecide"`. | | `productCategory` | array | Product category or categories. Used in Product Advertising mode. Supports `"AIDecide"`. | | `artStyle` | string | Artistic transformation style. Used only in Artistic mode. Example: `"Clay"`, `"Anime"`, `"Watercolor"`, `"Oil Painting"`, `"Cyberpunk"`. | | `backgroundColorValue` | string | Optional background color when replacing or modifying backgrounds. Enter hex codes (e.g., #FF5733) or descriptions (e.g., 'Soft teal with a hint of gold gradient'). | | `userInstructions` | string | Additional custom instructions that will be combined with AI recommendations. | ### Actor's Output | Output | Type | Description | | --------------------- | ------------- | ------------------------------------------------------------------------------------------ | | `success` | boolean | Indicates whether the actor completed successfully. | | `editingMode` | string | Editing mode used for processing. | | `qualityTier` | string | Selected AI model tier. | | `artStyle` | string | Returned for Artistic mode only. | | `imagesUploaded` | integer | Total number of images found in the uploaded ZIP file. | | `imagesSelected` | integer | Number of images selected for editing. | | `imagesEdited` | integer | Number of images successfully edited. | | `zipUrl` | string | Download URL of the ZIP archive containing all edited images and the HTML report. | | `reportUrl` | string | Download URL of the generated HTML report. | #### Example Inputs ```json { "artStyle": "Custom", "editingMode": "Product Advertising", "editingStyle": "editorial", "imageZipFile": "https://api.apify.com/v2/key-value-stores/K1mbfkLYT37h4aG89/records/food.zip", "manualOptionsProduct": [ "AI Decide (Default)" ], "noOfImages": 2, "platform": "instagram", "productCategory": [ "Food" ], "productPresentation": [ "AIDecide" ], "qualityTier": "Basic - Seedream-5.0", "targetAudiences": [ "general_social_media" ] } ```` ### πŸ“Š Professional HTML Report Every run automatically generates a comprehensive HTML report that provides a complete overview of the editing process. Instead of simply downloading the edited images, you receive a detailed report showing what was changed, why it was changed, and how each image performed. The report includes: - **Processing Summary** – Editing mode, AI model, total images processed, presentation style, product category, target audience, transformation level, Images Edited, Average AI Score, Highest AI Score, Lowest AI Score, and report generation time. - **Before & After Comparison** – Side-by-side view of the original and edited image for every processed photo. - **AI Quality Assessment** (Professional & Product Advertising modes) – Individual quality scores and detailed quality factors evaluated by AI. - **Detected Issues** – A list of problems identified in each original image, such as poor lighting, distracting backgrounds, weak composition, or low visual impact. - **Applied AI Enhancements** – Complete list of edits applied by the AI, including both AI recommendations and user-selected enhancements. - **Commercial Configuration (Product Advertising mode)** – Product presentation style, product category, and commercial editing settings used for the final output. - **Final AI Prompt** – The exact prompt sent to the selected AI model for complete transparency and reproducibility. ### Why the HTML Report Matters The generated report is more than just a summaryβ€”it serves as a **professional audit trail** for your image editing workflow. It can help: πŸ“Έ **Photographers** review retouching decisions and maintain consistent editing across client projects. πŸ›οΈ **E-commerce** teams compare product images and ensure brand consistency before publishing. 🏑 **Real estate agencies** verify image quality improvements for property listings. πŸ“± **Marketing agencies** document AI-assisted editing workflows for clients and internal reviews. 🎨 **Creative teams** understand how AI transformed each image and reproduce successful editing styles in future projects. πŸ‘₯ **Large organizations** maintain quality control and easily review hundreds of edited images without manually inspecting every file. Because every report is saved as a standalone HTML file, it can be viewed in any web browser, shared with clients or team members, archived for future reference, or included as part of project documentation. ### πŸ’° Estimated Run Costs Pricing is simple and transparent. Your total cost depends on: **The number of AI visual analyses performed.** **The number of images edited.** **The AI model tier selected.** The actor first analyzes your uploaded images, selects the best candidates (except in Artistic mode), and then edits only the requested number of images. | Tier | Launch Price | | ---------- | -----------: | | Basic | **$0.79** | | Standard ⭐ | **$1.49** | | Premium | **$2.49** | **Note:** These are approximate costs and may change as AI providers update their pricing. #### How Pricing Works **1. AI Visual Analysis** Every image is first analyzed using AI to evaluate quality, detect issues, and generate editing recommendations. **Approximately $0.20 per analyzed image** (Artistic mode skips visual analysis, reducing overall cost.) **2. AI Image Editing** Each successfully edited image is charged according to the selected model tier. **Basic Tier:** Lowest cost, fastest processing. **Standard Tier:** Best balance of quality and price. **Premium Tier:** Highest quality using state-of-the-art image generation models. **3. Actor Start & Finish Fee** A small **$0.10 fee** is charged when the actor starts and another **$0.10** when it completes successfully. These fees help cover Apify compute resources, orchestration, storage, packaging of results, and ongoing maintenance of the actor. ### πŸ“Έ Image Upload Guidelines To ensure the best editing quality, upload images that meet the following recommendations: - Use **high-resolution images** whenever possible. - Images should be **well-lit, sharp, and in focus**. - Avoid heavily compressed, blurry, or pixelated photos. - Upload images in **JPG, JPEG, or PNG** format. - Place all images inside a **single ZIP file** before uploading. - The actor supports **up to 1,000 images** in a single run. ### πŸ’Έ Payment Structure During the initial launch period (14 days), this Actor uses a **Pay-Per-Result (PPR)** pricing model. #### Launch Limits To ensure fair usage during the launch period: - You can edit **up to 10 images per run**. - A **flat promotional price of $1 per successfully edited image** applies, regardless of the AI model selected. - You are charged **only for successfully edited images**. After the initial **14-day launch period**, this Actor will transition to a **Pay-Per-Event (PPE)** pricing model and users can edit up to **1000 images** at once. At that point, users will be charged according to the selected AI model tier and the processing events described above. ### Workflow automation Integrate **AI Bulk Image Editor** with any app and automate your workflow such as "Make" \[https://www.make.com/en], "Zapier" \[https://zapier.com/], "n8n" \[https://n8n.io/], etc." If you’re looking to weave this into a larger tech stack or automate your content pipeline, you can bypass the manual interface and interact with the **AI Bulk Image Editor** via the Apify API. ### Developer Integration You can get started quickly by installing the official client libraries for your preferred environment: Node.js: Add the apify-client package via NPM. Python: Grab the apify-client package from PyPI. Check this API documentation: \[https://docs.apify.com/api/v2] ### What kind of data can be collected? We do not collect any personal user data. All inputs, uploaded and generated images, and metadata belong to the user running the actor. Each user only has access to their own dataset. ### Retention policy The retention policy of data for this actor is 31 days. ### Error Handling & Support The actor can fail due to many reasons because it rely on third party services. We tested it and always trying to improve it's performance. It is good to wait for actor to complete it's job. However, if you found any technical issue or bug you can create an issue on the Actor's Issues Tab. # Actor input Schema ## `imageZipFile` (type: `string`): Upload a .zip file containing 2-1000 images (JPEG/PNG). ## `qualityTier` (type: `string`): Select the quality tier for AI processing. Higher tiers may yield better results but take more time and resources. ## `noOfImages` (type: `integer`): Choose a number between 10 and 1000 ## `editingMode` (type: `string`): Select the AI editing mode that best matches your image editing goals. ## `productPresentation` (type: `array`): Select the product presentation style. This option is only used when Editing Mode is set to Product Photography & Advertising. ## `productCategory` (type: `array`): Select the product category. This option is only used when Editing Mode is set to Product Photography & Advertising. ## `artStyle` (type: `string`): Select your art style for image editing. It will only be enabled, if selected mode is Artistic Style Transformation otherwise ignored. ## `manualOptions` (type: `array`): Select one or more options for photo editing feature. ## `manualOptionsProduct` (type: `array`): Select additional product editing enhancements to apply. These options are only used when Editing Mode is set to Product Photography & Advertising. ## `targetAudiences` (type: `array`): Select one or more audiences. Select the audiences for your images to guide the AI's editing style. ## `editingStyle` (type: `string`): Choose an overall editing style to guide the AI's adjustments. ## `platform` (type: `string`): Select the primary platform where the edited images will be used. This helps the AI optimize edits for that platform's style and audience. ## `transformationLevel` (type: `string`): Select the level of transformation you want the AI to apply to the images. ## `backgroundColorValue` (type: `string`): Enter hex codes (e.g., #FF5733) or descriptions (e.g., 'Soft teal with a hint of gold gradient'). ## `userInstructions` (type: `string`): Optional instructions for background modifications or manual styles. ## Actor input object example ```json { "imageZipFile": "https://api.apify.com/v2/key-value-stores/QbxGhT4BoBa9N2bob/records/Product-Images.zip", "qualityTier": "Standard - FLUX Kontext Pro (Recommended)", "noOfImages": 10, "editingMode": "Product Advertising", "productPresentation": [ "AIDecide" ], "productCategory": [ "AIDecide" ], "artStyle": "Ghibli", "manualOptions": [ "cleanup" ], "manualOptionsProduct": [ "AI Decide (Default)" ], "targetAudiences": [ "general_social_media" ], "editingStyle": "AIDecide", "platform": "Facebook Marketplace", "transformationLevel": "Moderate", "backgroundColorValue": "#FFFFFF" } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "imageZipFile": "https://api.apify.com/v2/key-value-stores/QbxGhT4BoBa9N2bob/records/Product-Images.zip", "backgroundColorValue": "#FFFFFF" }; // Run the Actor and wait for it to finish const run = await client.actor("peaceful_pushpins/ai-bulk-image-editor").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "imageZipFile": "https://api.apify.com/v2/key-value-stores/QbxGhT4BoBa9N2bob/records/Product-Images.zip", "backgroundColorValue": "#FFFFFF", } # Run the Actor and wait for it to finish run = client.actor("peaceful_pushpins/ai-bulk-image-editor").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "imageZipFile": "https://api.apify.com/v2/key-value-stores/QbxGhT4BoBa9N2bob/records/Product-Images.zip", "backgroundColorValue": "#FFFFFF" }' | apify call peaceful_pushpins/ai-bulk-image-editor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=peaceful_pushpins/ai-bulk-image-editor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "AI Bulk Image Editor", "description": "AI-powered bulk photo editor for influencers, e-commerce, brands, photographers, food bloggers, real estate, and advertisers. Instantly transform up to 1000 images into professional, commercial, or artistic visuals optimized for social media, marketplaces, portfolios, and marketing campaigns.", "version": "0.0", "x-build-id": "Z01Igg8pGS6aTssAY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/peaceful_pushpins~ai-bulk-image-editor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-peaceful_pushpins-ai-bulk-image-editor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/peaceful_pushpins~ai-bulk-image-editor/runs": { "post": { "operationId": "runs-sync-peaceful_pushpins-ai-bulk-image-editor", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/peaceful_pushpins~ai-bulk-image-editor/run-sync": { "post": { "operationId": "run-sync-peaceful_pushpins-ai-bulk-image-editor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "imageZipFile": { "title": "Upload Images ZIP Archive", "type": "string", "description": "Upload a .zip file containing 2-1000 images (JPEG/PNG).", "default": "https://api.apify.com/v2/key-value-stores/QbxGhT4BoBa9N2bob/records/Product-Images.zip" }, "qualityTier": { "title": "Quality Tier", "enum": [ "Basic - Seedream-5.0", "Standard - FLUX Kontext Pro (Recommended)", "Standard - Qwen Image 2.0 Pro", "Premium GPT Image", "Premium - FLUX Kontext Max", "Premium - Gemini 3 Pro" ], "type": "string", "description": "Select the quality tier for AI processing. Higher tiers may yield better results but take more time and resources.", "default": "Standard - FLUX Kontext Pro (Recommended)" }, "noOfImages": { "title": "Select the number of images you wanted to edit", "minimum": 10, "maximum": 1000, "type": "integer", "description": "Choose a number between 10 and 1000", "default": 10 }, "editingMode": { "title": "Editing Mode", "enum": [ "Product Advertising", "Professional", "Artistic" ], "type": "string", "description": "Select the AI editing mode that best matches your image editing goals.", "default": "Product Advertising" }, "productPresentation": { "title": "Product Presentation Style (Only enabled, if Editing Mode is Product Photography & Advertising)", "type": "array", "description": "Select the product presentation style. This option is only used when Editing Mode is set to Product Photography & Advertising.", "items": { "type": "string", "enum": [ "Amazon", "Shopify", "Luxury", "Instagram", "MinimalStudio", "DarkPremium", "LifeStyle", "AIDecide" ], "enumTitles": [ "Amazon Listing", "Shopify Store", "Luxury Advertisement", "Instagram Product Ad", "Minimal Studio", "Dark Premium", "Lifestyle Product", "AI Decide (Default)" ] }, "default": [ "AIDecide" ] }, "productCategory": { "title": "Product Category (Only enabled, if Editing Mode is Product Photography & Advertising)", "type": "array", "description": "Select the product category. This option is only used when Editing Mode is set to Product Photography & Advertising.", "items": { "type": "string", "enum": [ "Jewelry", "Electronics", "Food", "Cosmetics", "Fashion", "Furniture", "Automotive", "Technology", "HomeDecor", "Sports", "Pet", "Toys", "AIDecide" ], "enumTitles": [ "Jewelry", "Electronics", "Food Photography", "Cosmetics & Beauty", "Fashion & Apparel", "Furniture & Home", "Automotive", "Technology & Gadgets", "Home Decor", "Sports & Fitness", "Pet Products", "Toys & Games", "AI Decide (Default)" ] }, "default": [ "AIDecide" ] }, "artStyle": { "title": "Art Style (Only enabled, if selected editing mode is Artistic Style Transformation)", "enum": [ "Cartoon", "Anime", "Ghibli", "Comic Book", "Watercolor", "Oil Painting", "Pencil Sketch", "Cyberpunk", "Vintage Film", "Pixar", "Clay", "3D Render", "Pop Art", "Custom" ], "type": "string", "description": "Select your art style for image editing. It will only be enabled, if selected mode is Artistic Style Transformation otherwise ignored.", "default": "Ghibli" }, "manualOptions": { "title": "Manual Photography Editing Options (Only selected, if Editing Mode is Professional Photo Editing)", "type": "array", "description": "Select one or more options for photo editing feature.", "items": { "type": "string", "enum": [ "cleanup", "background_swap", "flyaway_hair", "monochrome_retouch", "teeth_eyes_brighten", "lighting_adjustment" ], "enumTitles": [ "Object Cleanup / De-wrinkle / Skin Retouching", "Background Modification (Remove/Replace)", "Fix Flyaway Hair", "MonoChrome Retouch (B&W with AI Enhancements)", "Enhance Eyes & Teeth", "Lighting (Lighten/Darken)" ] }, "default": [ "cleanup" ] }, "manualOptionsProduct": { "title": "Manual Product Editing Options (Only selected, if Editing Mode is Product Photography & Advertising)", "type": "array", "description": "Select additional product editing enhancements to apply. These options are only used when Editing Mode is set to Product Photography & Advertising.", "items": { "type": "string", "enum": [ "Improve Lighting", "Enhance Product Sharpness", "Increase Contrast", "Improve White Balance", "Improve Color Accuracy", "Reduce Image Noise", "Remove Background", "Clean Background", "Replace Background", "Add Soft Shadow", "Add Reflection", "Create Floating Product Effect", "Remove Dust & Scratches", "Remove Fingerprints", "Remove Packaging Imperfections", "Enhance Packaging Details", "Improve Label Readability", "Enhance Branding Visibility", "Improve Product Visibility", "Center Product", "Improve Composition", "Improve Symmetry", "Enhance Material Texture", "Increase Shelf Appeal", "Luxury Commercial Finish", "Amazon Listing Optimization", "Shopify Store Optimization", "Social Media Ready", "Catalog Ready", "Advertisement Ready", "AI Decide (Default)" ] }, "default": [ "AI Decide (Default)" ] }, "targetAudiences": { "title": "Target Audiences", "type": "array", "description": "Select one or more audiences. Select the audiences for your images to guide the AI's editing style.", "items": { "type": "string", "enum": [ "general_social_media", "fashion", "beauty", "fitness", "luxury", "real_estate", "travel", "food", "ecommerce", "professional_linkedin" ], "enumTitles": [ "General Social Media", "Fashion Influencers", "Beauty Influencers", "Fitness Influencers", "Luxury Brands", "Real Estate", "Travel Content", "Food Bloggers", "E-Commerce Products", "Professional LinkedIn" ] }, "default": [ "general_social_media" ] }, "editingStyle": { "title": "Editing Style", "enum": [ "natural", "commercial", "editorial", "cinematic", "luxury", "vibrant", "moody", "minimalist", "AIDecide" ], "type": "string", "description": "Choose an overall editing style to guide the AI's adjustments.", "default": "AIDecide" }, "platform": { "title": "Target Platform", "enum": [ "instagram", "tiktok", "youtube", "linkedin", "facebook", "pinterest", "eBay", "Alibaba / AliExpress", "OLX", "Etsy", "Facebook Marketplace", "Walmart Marketplace", "Unsplash", "Pexels", "500px", "Flickr", "Behance", "Shutterstock" ], "type": "string", "description": "Select the primary platform where the edited images will be used. This helps the AI optimize edits for that platform's style and audience.", "default": "Facebook Marketplace" }, "transformationLevel": { "title": "Transformation Level", "enum": [ "Light Touch", "Moderate", "Complete Makeover" ], "type": "string", "description": "Select the level of transformation you want the AI to apply to the images.", "default": "Moderate" }, "backgroundColorValue": { "title": "Background Color", "minLength": 0, "maxLength": 300, "type": "string", "description": "Enter hex codes (e.g., #FF5733) or descriptions (e.g., 'Soft teal with a hint of gold gradient')." }, "userInstructions": { "title": "Custom User Prompt / Reference Instructions", "minLength": 0, "maxLength": 500, "type": "string", "description": "Optional instructions for background modifications or manual styles." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```