gemini-image-edit

Edit images with text prompts via the fal.ai Gemini 3 Pro API.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/bluewaves-creations/bluewaves-skills --skill gemini-image-edit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gemini-image-edit
Source: https://github.com/bluewaves-creations/bluewaves-skills/tree/main/plugins/fal-media/skills/gemini-image-edit
Command: npx skills add https://github.com/bluewaves-creations/bluewaves-skills --skill gemini-image-edit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Editing existing visuals can be time consuming and requires multiple tools. This Skill enables users to modify images quickly by describing changes with natural language prompts, leveraging fal.ai Gemini 3 Pro for automated edits.

Core Features & Use Cases

  • Text-guided image edits: modify attributes, objects, backgrounds, or styles based on a prompt.
  • Multi-image context: supports editing with multiple input images to preserve context.
  • Use case: a designer wants to alter the color grade of a product photo or remove an unwanted object across a batch of images.

Quick Start

Ensure FAL_KEY is set in your environment. Then call the Falcon API with a prompt and one or more image URLs, e.g. curl --request POST --url https://fal.run/fal-ai/gemini-3-pro-image-preview/edit --header "Authorization: Key $FAL_KEY" --header "Content-Type: application/json" --data '{"prompt":"Change the background to blue sky","image_urls":["https://example.com/image1.jpg"]}'.

Frequently Asked Questions about gemini-image-edit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I edit an existing image using text prompts?

To edit an existing image using text prompts, you can use the fal.ai Gemini 3 Pro API endpoint. You submit a POST request containing your natural language prompt and image URLs to modify attributes, objects, or backgrounds without manual editing tools.

Can I apply text-guided image edits to a batch of images at once?

Yes, you can apply text-guided image edits to a batch of images at once. The fal.ai Gemini 3 Pro endpoint accepts an array of image URLs, allowing you to preserve context and apply modifications like color changes across multiple input images simultaneously.

Do I need an API key to use fal.ai Gemini 3 Pro for image editing?

Yes, you need an API key to use fal.ai Gemini 3 Pro for image editing. You must configure a valid FAL_KEY environment variable in your system to authenticate your POST requests to the fal.run API endpoint.

What output parameters can I control when modifying images with Gemini 3 Pro?

When modifying images with Gemini 3 Pro, you can control output parameters like num_images, aspect_ratio, and output_format. These optional parameters are included in your JSON payload alongside the text prompt and image URLs.

What are the limitations of using text prompts for image refinement?

A limitation of using text prompts for image refinement is that it requires existing image URLs hosted online. The fal.ai API processes images via URLs, so you cannot directly upload local image files through this specific API endpoint.