gemini

# Gemini API

Use Google Gemini API via REST for text generation, multimodal analysis, image generation, and more.

## Prerequisites

- Environment variable `GOOGLE_API_KEY` must be set
- API endpoint: `https://generativelanguage.googleapis.com/v1beta`

## Available Models

| Model | Use Case |
|-------|----------|
| `gemini-2.5-flash` | Fast text generation (default) |
| `gemini-2.5-pro` | High quality text generation |
| `gemini-3-flash-preview` | Latest flash model |
| `gemini-3-pro-preview` | Latest pro model |
| `gemini-2.5-flash-image` | Image generation (Nano Banana) |
| `gemini-3-pro-image-preview` | Advanced image generation with thinking & search |

## Workflow

### Phase 1: Determine Task Type

Based on user request, identify which capability to use:
- **Text Generation**: Basic prompts, chat, Q&A
- **Multimodal Analysis**: Analyze images, videos, or audio
- **Image Generation**: Create or edit images (Nano Banana)
- **Function Calling**: Execute custom functions
- **Search Grounding**: Real-time web search integration

### Phase 2: Execute API Call

Use the appropriate curl command based on task type.

---

## 1. Text Generation

### Basic Prompt

```bash
curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent?key=$GOOGLE_API_KEY" \
    -H 'Content-Type: application/json' \
    -X POST \
    -d '{
      "contents": [{
        "parts": [{"text": "Your prompt here"}]
      }]
    }'
```

### With Configuration

```bash
curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent?key=$GOOGLE_API_KEY" \
    -H 'Content-Type: application/json' \
    -X POST \
    -d '{
      "contents": [{
        "parts": [{"text": "Your prompt here"}]
      }],
      "generationConfig": {
        "temperature": 0.9,
        "maxOutputTokens": 2000,
        "stopSequences": ["END"]
      }
    }'
```

### Multi-turn Chat

```bash
curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-f