# Gemini 3 Pro Image

> Run Gemini 3 Pro Image by google online or via API. From $0.134 per image, no setup.

**URL:** https://inference.sh/apps/google/gemini-3-pro-image
**Last updated:** 2026-05-29

---

Gemini 3 Pro Image (NanoBanana Pro) via Vertex AI - Advanced image generation model powered by Google Cloud

- app: `google/gemini-3-pro-image`
- maker: [google](https://inference.sh/apps/google.md)
- category: [image](https://inference.sh/apps/category/image.md)
- input → output: text → image
- tasks: [text to image](https://inference.sh/apps/tag/text-to-image.md), [image editing](https://inference.sh/apps/tag/image-editing.md)
- price: $0.134/image (1K/2K), $0.24/image (4K), +$0.0011/input image, +$0.014/search
- runs via: api, javascript and python sdk, belt cli, mcp

## gemini-3-pro-image API Guide

### About
gemini 3 pro image (nanobanana pro) via vertex ai - advanced image generation model powered by google cloud

### 1. Calling the API

#### Install the Client

```bash
pip install inferencesh
```

#### Setup Your API Key
Set `INFERENCE_API_KEY` as an environment variable. Get your key from settings → api keys.

```bash
export INFERENCE_API_KEY="inf_your_key"
```

#### Run and Get Result

```python
import os
from inferencesh import inference

client = inference(api_key=os.environ["INFERENCE_API_KEY"])


result = client.run({
        "app": "google/gemini-3-pro-image@68xxjd3q",
        "input": {
            "prompt": "prompt"
        }
    })

print(result["output"])
```

#### Stream Live Updates

```python
import os
from inferencesh import inference

client = inference(api_key=os.environ["INFERENCE_API_KEY"])


## stream=True yields updates as they arrive
for update in client.run({
        "app": "google/gemini-3-pro-image@68xxjd3q",
        "input": {
            "prompt": "prompt"
        }
    }, stream=True):
    if update.get("progress"):
        print(f"progress: {update['progress']}%")
    if update.get("output"):
        print(f"output: {update['output']}")
```

### 2. Authentication
The API uses API keys for authentication. See the authentication docs for detailed setup instructions.

### 3. Files

#### Automatic Upload

```python
## local file paths are automatically uploaded
result = client.run({
    "app": "google/gemini-3-pro-image@68xxjd3q",
    "input": {
        "image": "/path/to/local/image.png",  # detected & uploaded
        "audio": "https://example.com/audio.mp3",  # url passed through
    }
})
```

#### Manual Upload

```python
## upload and get a hosted URL
file = client.files.upload("/path/to/file.png")
print(file.uri)  # https://cloud.inference.sh/...
```

### 4. Schema

#### Input
- **prompt** (string) *required*: The prompt for image generation or editing. Describe what you want to create or change.
- **images** (array): Optional list of input images for editing (up to 14 images). When provided, the model will edit these images based on the prompt. When not provided, the model will generate new images from the text prompt. Supported formats: JPEG, PNG, WebP
- **num_images** (integer): Number of images to generate.
- **aspect_ratio** (string): Aspect ratio for the output image. Use 'auto' to automatically match the first input image's aspect ratio. Default: 1:1
- **resolution** (string): Output resolution. Options: 1K, 2K, 4K. Default: 1K
- **output_format** (string): Output format for the generated images.
- **enable_google_search** (boolean): Enable Google Search grounding for real-time information (weather, news, etc.)
- **safety_tolerance** (string): Safety filter threshold. Options: BLOCK_NONE, BLOCK_LOW_AND_ABOVE, BLOCK_MEDIUM_AND_ABOVE, BLOCK_ONLY_HIGH
- **retry_count** (integer): Number of automatic retries on 429 rate limit errors using exponential backoff with jitter. Set to 0 to disable retries. Example: retry_count=2 means up to 3 total attempts (1 initial + 2 retries).

#### Output
- **description** (string): Text description or response from the model
- **images** (array): The generated or edited images

## other image apps

- [Gemini Nano Banana 2.1](https://inference.sh/apps/google/gemini-nano-banana-2-1.md): $1.50/M input, $0.0336–$0.1134/image (1K–4K), +$0.014/query Google Search
- [Grok Imagine Image 2.0](https://inference.sh/apps/xai/grok-imagine-image-2-0.md): $0.04/img low 1k, $0.06/img low 2k, $0.06/img med 1k, $0.08/img med 2k; $0.01/source img (edits)
- [GPT Image 2.5 Sunburst](https://inference.sh/apps/openai/gpt-image-2-5-sunburst.md): $0.006-$0.21 per 1024x1024 image: low $0.006, medium $0.013, high $0.053, xhigh $0.094, max $0.21. Larger sizes cost more; edits add ~$0.008 per reference image.
- [GPT Image 2.5 Flare](https://inference.sh/apps/openai/gpt-image-2-5-flare.md): $0.006-$0.21/image at 1024x1024: low $0.0059, medium $0.0132, high $0.0527, xhigh $0.0937, max $0.2107. Larger sizes cost more; edits add ~$0.0083 per reference image.
- [Image Resize & Crop](https://inference.sh/apps/eval/resize.md): from $0.00000277/sec

## faq

### how much does Gemini 3 Pro Image cost?

$0.134/image (1K/2K), $0.24/image (4K), +$0.0011/input image, +$0.014/search. you pay per run from your inference shell credits. no subscription is required.

### how do I run Gemini 3 Pro Image via api?

call google/gemini-3-pro-image with the javascript or python sdk, the rest api, or `belt app run google/gemini-3-pro-image` from a terminal. the api reference on this page lists every input.

### who makes Gemini 3 Pro Image?

Gemini 3 Pro Image is made by google and runs on inference shell. every google app is listed at https://inference.sh/apps/google.

### can my agent use Gemini 3 Pro Image?

yes. agents call it as a tool through the inference shell mcp server (https://api.inference.sh/mcp), the belt cli or the sdk, and pay per run like you do.

### what are the alternatives to Gemini 3 Pro Image?

other image apps on inference shell include Gemini Nano Banana 2.1, Grok Imagine Image 2.0, GPT Image 2.5 Sunburst, GPT Image 2.5 Flare. they run through the same api, so switching is a one-line change.