api_gemini 0.8.1

Gemini's API for accessing large language models (LLMs).
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

# api_gemini Examples

## Responsibility Table

| filename | Responsibility |
|----------|---------------|
| gemini_dry_run.rs | Validate setup patterns without real API calls |
| gemini_api_basic.rs | Basic text generation request and response |
| gemini_list_models.rs | List and explore available Gemini models |
| gemini_embeddings.rs | Text embeddings generation and similarity search |
| gemini_multimodal.rs | Image analysis with vision capabilities |
| gemini_safety_settings.rs | Content filtering and safety configuration |
| gemini_error_handling.rs | Error handling patterns and recovery |
| gemini_code_execution.rs | Python code generation and execution |
| gemini_search_grounding.rs | Google Search grounding for real-time data |
| gemini_system_instructions.rs | System prompt and instruction configuration |
| gemini_api_interactive.rs | Real-time interactive chat with streaming |
| gemini_api_cached_interactive.rs | Interactive chat with server-side caching |
| gemini_function_calling.rs | AI function calling and tool use |
| gemini_performance_optimization.rs | Performance patterns and monitoring |

Examples demonstrating the `api_gemini` crate, organized by difficulty.

## Quick Start

1. `gemini_dry_run.rs` - Validate setup without API calls
2. `gemini_api_basic.rs` - Basic conversation
3. `gemini_list_models.rs` - Explore available models

## All Examples

### Beginner
- `gemini_dry_run.rs` - Validate patterns without API calls
- `gemini_api_basic.rs` - Basic text generation
- `gemini_list_models.rs` - Model exploration

### Intermediate
- `gemini_embeddings.rs` - Text embeddings and search
- `gemini_multimodal.rs` - Image analysis
- `gemini_safety_settings.rs` - Content filtering
- `gemini_error_handling.rs` - Error handling patterns
- `gemini_code_execution.rs` - Python code generation and execution via Gemini
- `gemini_search_grounding.rs` - Google Search grounding for real-time information
- `gemini_system_instructions.rs` - System prompt and instruction configuration

### Advanced
- `gemini_api_interactive.rs` - Real-time interactive chat with streaming
- `gemini_api_cached_interactive.rs` - Advanced chat with server-side caching (Featured)
- `gemini_function_calling.rs` - AI agents with tools
- `gemini_performance_optimization.rs` - Performance patterns and monitoring

## Setup

```bash
# Set API key
export GEMINI_API_KEY="your-key"

# Run examples
cargo run --example gemini_api_basic
cargo run --example gemini_api_interactive --features streaming
cargo run --example gemini_api_cached_interactive --features streaming
cargo run --example gemini_performance_optimization --features logging
```

## Features

- `streaming` - Real-time responses
- `logging` - Structured logging (used in performance_optimization.rs)
- `full` - All features

See individual example files for detailed documentation and usage instructions.