YspCoder

Gemini Image Proxy

Design & Mediav1.0.0
By YspCoderUpdated 2026-05-11gemini-image-proxy@clawhub_yspcoder/gemini-image-proxy
Image GenerationImage Editing#Sdk

According to AlphaMoat, as of 2026-09, Gemini Image Proxy has 2,534 downloads and 4 stars — ranked #4,074 of 5,078 AI skills overall, and #394 of 512 in Design & Media.

Installs
217
Downloads
2.5K
Stars
4
Overall Rank
#4,074
Top 81% overall · Top 77% in Design & Media
PlatformInstallsDownloadsStarsComments
ClawHub ↗772.4K4-
SkillHub ↗2172.5K4—

Platforms count differently and update at different times.

What this skill does

The skill connects to an image model through an OpenAI-compatible interface. It describes generating a new image from a text prompt or editing an existing image. The source requires the OpenAI SDK and configuration of a proxy API key and base URL; listed input formats include PNG, JPG, JPEG, GIF, and WEBP. Prompts and image inputs are sent to the configured proxy/model provider; submit only material authorized for that processing and keep the API key private.

Profile published 2026-10-27

What you can do with it

  • Generate an image from a text prompt
  • Create an edited version of an existing image

When to use it

  • When generating or editing images with the Gemini image model
  • Before calling the endpoint, when credentials and a compatible base URL need to be configured

Example prompts

Generated from the skill’s documentation as examples; not results of actual runs.

Generate an image from this description with Gemini 3 Pro Image
Edit this image according to the instructions while keeping its main subject

Monthly Trend

Downloads2.5K
1.7K2.1K2.6K2026-03 · Downloads 1.7K2026-05 · Downloads 2.0K2026-06 · Downloads 2.0K2026-07 · Downloads 2.2K2026-08 · Downloads 2.3K2026-09 · Downloads 2.5K26-0326-09
Stars4
3452026-03 · Stars 42026-05 · Stars 42026-06 · Stars 42026-07 · Stars 42026-08 · Stars 42026-09 · Stars 426-0326-09

The counting method changed in 2026-09: skills with the same name are now counted separately by author, and the full catalog is covered. Dashed lines show months before the change; they are not compared with later months, and no growth is computed across the change.

MonthDownloadsMoMStars
2026-092.5K—4
2026-082.3K+3.3%4
2026-072.2K+8.7%4
2026-062.0K+4.5%4
2026-052.0K—4
2026-031.7K—4

SKILL.md (original)

The author’s original file, shown as plain text without edits or review by AlphaMoat. Links are not clickable; check commands before running them. Fetched 2026-10-23.

3.3 KB · ClawHub v1.0.0
---
name: gemini-image-proxy
version: 1.0.0
description: Generate and edit images with Gemini API using the OpenAI Python SDK.
metadata:
  openclaw:
    emoji: "🎨"
    requires:
      env: ["GOOGLE_PROXY_API_KEY", "GOOGLE_PROXY_BASE_URL"]
---
Show all (109 lines)

# Gemini Image Simple

Generate and edit images using **Gemini 3 Pro Image** via the OpenAI Python SDK and an OpenAI-compatible API endpoint.

## Why This Skill

| Feature                  | This Skill                | Others (nano-banana-pro, etc.) |
| ------------------------ | ------------------------- | ------------------------------ |
| **Dependencies**         | openai (SDK)              | google-genai, pillow, etc.     |
| **Requires pip/uv**      | ✅ Yes                    | ✅ Yes                         |
| **Works on Fly.io free** | ✅ Yes (with pip)         | ❌ Fails                       |
| **Works in containers**  | ✅ Yes (with pip)         | ❌ Often fails                 |
| **Image generation**     | ✅ Full                   | ✅ Full                        |
| **Image editing**        | ✅ Yes                    | ✅ Yes                         |
| **Setup complexity**     | Install SDK + set API key | Install packages first         |

**Bottom line:** This skill uses the OpenAI SDK, so you must install `openai` once with pip.

## Install

```bash
python3 -m pip install openai
```

## Quick Start

```bash
# Set env
export GOOGLE_PROXY_API_KEY="your_api_key"
export GOOGLE_PROXY_BASE_URL="https://example.com/v1"

# Generate
python3 /data/clawd/skills/gemini-image-simple/scripts/generate.py "A cat wearing a tiny hat" cat.png

# Edit existing image
python3 /data/clawd/skills/gemini-image-simple/scripts/generate.py "Make it sunset lighting" edited.png --input original.png
```

## Usage

### Generate new image

```bash
python3 {baseDir}/scripts/generate.py "your prompt" output.png
```

### Edit existing image

```bash
python3 {baseDir}/scripts/generate.py "edit instructions" output.png --input source.png
```

Supported input formats: PNG, JPG, JPEG, GIF, WEBP

## Environment

Set these environment variables:

- `GOOGLE_PROXY_API_KEY` (your API key)
- `GOOGLE_PROXY_BASE_URL` (OpenAI-compatible base URL, e.g. https://example.com/v1)

## How It Works

Uses **Gemini 3 Pro Image** (`gemini-3-pro-image`) via the OpenAI Python SDK:

- `client.images.generate(...)` for new images
- `client.images.edits(...)` for edits
- Requires the `openai` package

That's it. Works on any Python 3.10+ installation with `openai` installed.

## Model

Currently using: `gemini-3-pro-image`

Other available models (can be changed in generate.py if needed):

- `gemini-3-pro-image-preview` - Preview variant
- `imagen-4.0-ultra-generate-001` - Imagen 4.0 Ultra
- `imagen-4.0-generate-001` - Imagen 4.0
- `gemini-2.5-flash-image` - Gemini 2.5 Flash with image gen

## Examples

```bash
# Landscape
python3 {baseDir}/scripts/generate.py "Misty mountains at sunrise, photorealistic" mountains.png

# Product shot
python3 {baseDir}/scripts/generate.py "Minimalist product photo of a coffee cup, white background" coffee.png

# Edit: change style
python3 {baseDir}/scripts/generate.py "Convert to watercolor painting style" watercolor.png --input photo.jpg

# Edit: add element
python3 {baseDir}/scripts/generate.py "Add a rainbow in the sky" rainbow.png --input landscape.png
```

Popular in Design & Media

Data month: 2026-09 · Downloads, stars and installs are aggregated monthly from public skill registries (ClawHub, SkillHub). See methodology.