psnanobanana
AI Scripts for Photoshop

Support & Documentation

Everything you need to get started with Nano Banana AI Photoshop plugin. Installation guides, troubleshooting, and pro tips.

🚀 Quick Installation Guide

1

Download the plugin file

Download the plugin file by clicking the button above

2

Install using Adobe Creative Cloud

Double-click the .ccx file to install using Adobe Creative Cloud

3

Open Photoshop

Open Photoshop and find the Nano Banana panel open or under the "Plugins" menu

4

Create your Astria account

Create your free Astria account to get API access

5

Start creating!

Enter your API key in the plugin and start creating!

Latest Updates

12/Sept Update

New version with SeeDream 4.0 - 4K edits and layer masking available

09/Sept Update

New CCX/UXP panel version of the plugin added

🚀 Features

Multi Reference Images

Use multiple reference images to guide the AI how to edit the image.

Nano Banana (Gemini 2.5 Flash)

Fast generation with extras like Use Foreground Color and Reference Image (now available on both Windows and macOS 🎉)

Flux Kontext (Pro & Max)

Context-aware edits, typography, lighting

💡 Usage Tips

Keep prompts short and specific

Mention material, color, lighting. Prompts in Flux Kontext need to be more specific than Nano Banana.

Make selections slightly larger

Make selections slightly larger or softer to give the models more context.

Try both Flux Kontext versions

Try both Flux Kontext Pro and Max: Pro for most cases, Max for typography

Sketch to reality

Try drawing a sketch, and then let Nano Banana make something out of it. Very impressive results!

Use Upscale for better results

Use Upscale if the generated area feels too small or soft.

🔧 Troubleshooting

Cannot install plugin

Rename the CCX file to ZIP, then extract it into a directory "ee0f4287_PS", and copy it to Photoshop Plugins directory.

Network request failed

Windows firewall or Antivirus blocking requests - adjust settings to allow Astria API.

Additionally make sure your Photoshop version is 26+ in the Photoshop About page.

Installation errors

Update Creative Cloud & Photoshop, restart computer, then try installing again

Other installation issues

For more installation issues - some users have reported uninstall Photoshop and then install from scratch resolved the problem

Still need help?

Our support team is here to help you get up and running quickly.

Contact Support

💻 System Requirements

Windows

  • • Windows 10 or later
  • • Adobe Photoshop 2023 (v24) or later
  • • Adobe Creative Cloud installed
  • • Internet connection for API access
  • • Minimum 8GB RAM recommended

macOS

  • • macOS 10.15 (Catalina) or later
  • • Adobe Photoshop 2023 (v24) or later
  • • Adobe Creative Cloud installed
  • • Internet connection for API access
  • • Minimum 8GB RAM recommended

Frequently Asked Questions

How much does each edit cost?

Each Nano Banana edit costs approximately 4¢ through your Astria account. Flux Kontext pricing varies by model (Pro/Max/Dev).

Do I need an Adobe subscription?

Yes, you need an active Adobe Photoshop subscription. The plugin runs inside Adobe Photoshop and requires Photoshop 2023 (v24) or later.

What's the difference between Nano Banana and Flux Kontext?

Nano Banana (Gemini 2.5 Flash) is faster and great for natural edits with reference images. Flux Kontext (Pro/Max/Dev) excels at context-aware edits, typography, and complex lighting scenarios.

Can I use reference images on both Windows and macOS?

Yes! Reference image support is now available on both Windows and macOS. You can use multiple reference images to guide the AI editing process.

What if the plugin doesn't appear in Photoshop?

Make sure you've installed the .ccx file through Adobe Creative Cloud. If it still doesn't appear, try restarting Photoshop or look under Window > Extensions > Nano Banana.

Are my images sent to external servers?

Yes, selected image areas are sent to Astria's secure servers for AI processing. Images are processed and then deleted according to Astria's privacy policy. No images are stored permanently.

Can I cancel my Astria subscription anytime?

Astria works on a pay-per-use basis, not a subscription. You only pay for the edits you generate. You can add credits to your account as needed.

What's the maximum image resolution supported?

With SeeDream 4.0, you can now process 4K images. The plugin automatically handles different resolutions and optimizes for the best results.

🎥 Video Tutorials

Learn advanced techniques and get the most out of your plugin

🎬

Advanced Reference Image Techniques

Mastering Reference Images

Learn how to use multiple reference images effectively for complex edits.

🎨

Flux Kontext Pro Tips

Context-Aware Editing

Advanced techniques for lighting and material-aware edits with Flux Kontext.