Nano Banana Actor

An Apify Actor that edits images using AI-powered image editing technology. Simply provide a text prompt describing the edits you want, along with an image, and the Actor will apply the changes and return the edited image.

What This Tool Does

This Actor connects to the MultipleWords image editing API to modify images based on text prompts. It accepts a descriptive prompt about the image edits you want to make, processes the request through the API, and returns the edited image along with detailed metadata.

Key Features:

🎨 Edit images from text descriptions 🚀 Fast and automated image editing 📦 Structured output with image URLs and metadata 🔄 Reliable error handling and validation 📊 Complete editing details and timestamps 📤 Support for file uploads via base64 encoding 🌐 HTTP API for real-time image editing

Purpose & Use Cases

This tool is designed to help individuals, businesses, and developers automate image editing for various purposes:

Personal Use

• Edit personal photos with simple text prompts
• Change clothing colors, backgrounds, or objects in images
• Remove or add elements to photos
• Create variations of existing images

E-commerce & Retail

• Generate product image variations
• Edit product photos for different color options
• Create marketing materials from existing images
• Batch process product images

Content Creation

• Edit images for social media posts
• Create variations of images for A/B testing
• Modify images for blog posts and articles
• Generate thumbnail variations

Development & Automation

• Integrate image editing into automated workflows
• Batch edit images for multiple projects
• Create image editing pipelines via API integration
• Automate image processing tasks

Design Agencies

• Quickly apply edits to client images
• Create multiple variations of designs
• Streamline the image editing workflow
• Prototype image edits before final production

Input Parameters

The Actor requires the following input:

prompt (Required)

Type: String
Description: A text description of the image edits you want to make. Be as specific as possible about what changes you want.

Example: "change the t shirt color of this person."

Best Practices:

• Be specific about what you want to change (colors, objects, backgrounds, etc.)
• Mention the target of your edit (person, object, background, etc.)
• Describe the desired outcome clearly
• Use simple, clear language

user_id (Required)

Type: Integer
Description: User ID for the API request.
Default: 663559

isPro (Optional)

Type: Integer
Description: Pro user flag (0 or 1).
Default: 1

image_url (Conditional)

Type: String
Description: URL of the image to edit. Either image_url or file_base64 must be provided.

Example: "https://example.com/image.jpg"

file_base64 (Conditional)

Type: String
Description: Base64-encoded image data. Either image_url or file_base64 must be provided.

Example: Base64-encoded string of image data

file_name (Optional, used with file_base64)

Type: String
Description: Name of the file when uploading via base64.
Default: image-{timestamp}.jpg

file_content_type (Optional, used with file_base64)

Type: String
Description: MIME type of the uploaded file.
Default: image/jpeg

Output Structure

The Actor returns structured data containing the edited image information:

{
  "status": 1,
  "edited_image_url": "https://multiplewords.nyc3.cdn.digitaloceanspaces.com/edit_image_from_text/edited_image_1769509641.png",
  "text_response": "change the t shirt color of this person.",
  "details": {
    "id": 509049,
    "image_url": "https://multiplewords.nyc3.cdn.digitaloceanspaces.com/edit_image_from_text/edited_image_1769509641.png",
    "image_description": "change the t shirt color of this person.",
    "image_name": "Edit Image From Text - change the t shirt color of this person.",
    "image_created_at": "2026-01-27T10:27:22.771846Z",
    "image_updated_at": "2026-01-27T10:27:22.771872Z",
    "engine": 5,
    "url_slug": "edit-image-from-text-450176",
    "source_image_url": "https://multiplewords.nyc3.cdn.digitaloceanspaces.com/edit_image_from_text/joyfulhandsomemanscreamfromjoypointingfingersupshowingadvertisementtopcopyspacestandingtshirtagainstwhitebackground20250717103339-2026-01-27-10-26-28.jpg",
    "rating": 0,
    "feedback": "",
    "job_key": "0",
    "job_status": 0,
    "extra_1": null,
    "extra_2": null,
    "extra_3": null,
    "extra_4": null,
    "extra_5": null,
    "extra_6": null,
    "attempts": 3,
    "is_public": false,
    "isIndexed": false,
    "is_active": true,
    "user_id": 12763,
    "image_category_id": 22,
    "language_id": 49,
    "dreambooths_project_id": 1,
    "dreambooth_inference_category_id": 4
  }
}

Output Fields Explained

• status: Success indicator (1 = success)
• edited_image_url: Direct URL to download the edited image
• text_response: Echo of your input prompt
• details: Complete metadata about the image editing
  • id: Unique identifier for the edited image
  • image_url: URL of the edited image
  • image_description: Description of the edit
  • image_name: Name of the edited image
  • image_created_at: Timestamp when the image was created
  • image_updated_at: Timestamp when the image was updated
  • engine: AI engine used for editing
  • source_image_url: URL of the original source image
  • job_status: Status of the editing job
  • user_id: User ID associated with the edit

How to Use

Running Locally

1. Install dependencies:

   $npm install
   

2. Run the Actor:

   $apify run
   

3. Provide input when prompted, or create an input file in storage/key_value_stores/default/INPUT.json:

   {
     "prompt": "change the t shirt color of this person.",
     "user_id": 663559,
     "isPro": 1,
     "image_url": "https://example.com/image.jpg"
   }
   

Deploy to Apify Platform

1. Login to Apify:

   $apify login
   

2. Deploy the Actor:

   $apify push
   

3. Run on Apify Console:

   • Go to Actors -> My Actors
   • Select your Nano Banana Actor
   • Enter your prompt and image URL in the input form
   • Click "Start" to edit your image

Using via API

Once deployed, you can call the Actor via Apify API:

curl -X POST "https://api.apify.com/v2/acts/YOUR_USERNAME~nano-banana/run-sync" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "change the t shirt color of this person.",
    "user_id": 663559,
    "isPro": 1,
    "image_url": "https://example.com/image.jpg"
  }'

Using with File Upload (Base64)

You can upload images directly by encoding them in base64:

import { ApifyClient } from 'apify-client';
import { readFileSync } from 'fs';

const client = new ApifyClient({
    token: 'YOUR_API_TOKEN',
});

// Read file and convert to base64
const fileBuffer = readFileSync('path/to/image.jpg');
const fileBase64 = fileBuffer.toString('base64');

const run = await client.actor('YOUR_USERNAME/nano-banana').call({
    prompt: 'change the t shirt color of this person.',
    user_id: 663559,
    isPro: 1,
    file_base64: fileBase64,
    file_name: 'image.jpg',
    file_content_type: 'image/jpeg'
});

Using HTTP API (Standby Mode)

When running in standby mode, the Actor exposes an HTTP server that accepts POST requests:

curl -X POST http://localhost:8080/ \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "change the t shirt color of this person.",
    "user_id": 663559,
    "isPro": 1,
    "image_url": "https://example.com/image.jpg"
  }'

Integration Examples

With Make (Integromat)

• Connect the Actor to your Make workflows
• Automatically edit images when new files are uploaded
• Send edited images to storage services or email
• Create image editing automation workflows

With Zapier

• Trigger image editing from form submissions
• Automatically process images from Google Drive or Dropbox
• Send edited images via email or Slack
• Create automated image processing pipelines

With Custom Applications

• Integrate via Apify API into your web applications
• Batch edit images for multiple clients
• Create automated image editing workflows
• Build image editing services into your platform

With Node.js Applications

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({
    token: 'YOUR_API_TOKEN',
});

async function editImage(prompt, imageUrl) {
    const run = await client.actor('YOUR_USERNAME/nano-banana').call({
        prompt: prompt,
        user_id: 663559,
        isPro: 1,
        image_url: imageUrl
    });
    
    const { items } = await client.dataset(run.defaultDatasetId).listItems();
    return items[0];
}

// Usage
const result = await editImage(
    'change the t shirt color of this person.',
    'https://example.com/image.jpg'
);
console.log('Edited image URL:', result.edited_image_url);

Technical Details

• Runtime: Node.js 18+
• Dependencies: Apify SDK v3.5.2+
• API Endpoint: https://shorts.multiplewords.com/mwvideos/api/edit_image_from_text
• Request Method: POST
• Content Type: multipart/form-data
• Standby Mode: Enabled (HTTP server on port 8080)
• Input Schema: JSON with validation
• Output: Dataset with structured JSON

Error Handling

The Actor includes comprehensive error handling:

• ✅ Validates input parameters before processing
• ✅ Handles API errors gracefully
• ✅ Provides detailed error messages in logs
• ✅ Returns appropriate HTTP status codes
• ✅ Validates file uploads and image URLs
• ✅ Handles missing or invalid parameters

Resources

• Apify SDK Documentation
• Apify Platform Documentation
• Apify Academy - Node.js Tutorials
• Join Apify Developer Community

Support

For issues, questions, or feature requests, please refer to the Apify documentation or community forums.

---

Built with ❤️ using Apify SDK