gemini_rust

Struct Gemini

Source 
pub struct Gemini { /* private fields */ }
Expand description

Client for the Gemini API

Implementations§

Source§

impl Gemini

Source

pub fn new(api_key: impl Into<String>) -> Self

Create a new client with the specified API key

Examples found in repository?
examples/test_api.rs (line 9)
5async fn main() -> Result<(), Box<dyn std::error::Error>> {
6    let api_key = env::var("GEMINI_API_KEY")?;
7
8    // Create client with the default model (gemini-2.0-flash)
9    let client = Gemini::new(api_key);
10
11    println!("Sending request to Gemini API...");
12
13    // Simple text completion with minimal content
14    let response = client
15        .generate_content()
16        .with_user_message("Say hello")
17        .execute()
18        .await?;
19
20    println!("Response: {}", response.text());
21
22    Ok(())
23}
More examples
Hide additional examples
examples/google_search.rs (line 10)
5async fn main() -> Result<(), Box<dyn std::error::Error>> {
6    // Get API key from environment variable
7    let api_key = env::var("GEMINI_API_KEY").expect("GEMINI_API_KEY environment variable not set");
8
9    // Create client
10    let client = Gemini::new(api_key);
11
12    println!("--- Google Search tool example ---");
13
14    // Create a Google Search tool
15    let google_search_tool = Tool::google_search();
16
17    // Create a request with Google Search tool
18    let response = client
19        .generate_content()
20        .with_user_message("What is the current Google stock price?")
21        .with_tool(google_search_tool)
22        .execute()
23        .await?;
24
25    println!("Response: {}", response.text());
26
27    Ok(())
28}
examples/curl_google_search.rs (line 30)
5async fn main() -> Result<(), Box<dyn std::error::Error>> {
6    // Get API key from environment variable
7    let api_key = env::var("GEMINI_API_KEY").expect("GEMINI_API_KEY environment variable not set");
8
9    println!("--- Curl equivalent with Google Search tool ---");
10
11    // This is equivalent to the curl example:
12    // curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key=$GEMINI_API_KEY" \
13    //   -H "Content-Type: application/json" \
14    //   -d '{
15    //       "contents": [
16    //           {
17    //               "parts": [
18    //                   {"text": "What is the current Google stock price?"}
19    //               ]
20    //           }
21    //       ],
22    //       "tools": [
23    //           {
24    //               "google_search": {}
25    //           }
26    //       ]
27    //   }'
28
29    // Create client
30    let client = Gemini::new(api_key);
31
32    // Create a content part that matches the JSON in the curl example
33    let text_part = Part::Text {
34        text: "What is the current Google stock price?".to_string(),
35    };
36
37    let content = Content {
38        parts: vec![text_part],
39        role: None,
40    };
41
42    // Create a Google Search tool
43    let google_search_tool = Tool::google_search();
44
45    // Add the content and tool directly to the request
46    // This exactly mirrors the JSON structure in the curl example
47    let mut content_builder = client.generate_content();
48    content_builder.contents.push(content);
49    content_builder = content_builder.with_tool(google_search_tool);
50
51    let response = content_builder.execute().await?;
52
53    println!("Response: {}", response.text());
54
55    Ok(())
56}
examples/curl_equivalent.rs (line 26)
5async fn main() -> Result<(), Box<dyn std::error::Error>> {
6    // Get API key from environment variable
7    let api_key = env::var("GEMINI_API_KEY").expect("GEMINI_API_KEY environment variable not set");
8
9    // This is equivalent to the curl example:
10    // curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key=$YOUR_API_KEY" \
11    //   -H 'Content-Type: application/json' \
12    //   -X POST \
13    //   -d '{
14    //     "contents": [
15    //       {
16    //         "parts": [
17    //           {
18    //             "text": "Explain how AI works in a few words"
19    //           }
20    //         ]
21    //       }
22    //     ]
23    //   }'
24
25    // Create client - now using gemini-2.0-flash by default
26    let client = Gemini::new(api_key);
27
28    // Method 1: Using the high-level API (simplest approach)
29    println!("--- Method 1: Using the high-level API ---");
30
31    let response = client
32        .generate_content()
33        .with_user_message("Explain how AI works in a few words")
34        .execute()
35        .await?;
36
37    println!("Response: {}", response.text());
38
39    // Method 2: Using Content directly to match the curl example exactly
40    println!("\n--- Method 2: Matching curl example structure exactly ---");
41
42    // Create a content part that matches the JSON in the curl example
43    let text_part = Part::Text {
44        text: "Explain how AI works in a few words".to_string(),
45    };
46
47    let content = Content {
48        parts: vec![text_part],
49        role: None,
50    };
51
52    // Add the content directly to the request
53    // This exactly mirrors the JSON structure in the curl example
54    let mut content_builder = client.generate_content();
55    content_builder.contents.push(content);
56    let response = content_builder.execute().await?;
57
58    println!("Response: {}", response.text());
59
60    Ok(())
61}
examples/generation_config.rs (line 10)
5async fn main() -> Result<(), Box<dyn std::error::Error>> {
6    // Get API key from environment variable
7    let api_key = env::var("GEMINI_API_KEY").expect("GEMINI_API_KEY environment variable not set");
8
9    // Create client
10    let client = Gemini::new(api_key);
11
12    // Using the full generation config
13    println!("--- Using full generation config ---");
14    let response1 = client
15        .generate_content()
16        .with_system_prompt("You are a helpful assistant.")
17        .with_user_message("Write a short poem about Rust programming language.")
18        .with_generation_config(GenerationConfig {
19            temperature: Some(0.9),
20            top_p: Some(0.8),
21            top_k: Some(20),
22            max_output_tokens: Some(200),
23            candidate_count: Some(1),
24            stop_sequences: Some(vec!["END".to_string()]),
25            response_mime_type: None,
26            response_schema: None,
27        })
28        .execute()
29        .await?;
30
31    println!(
32        "Response with high temperature (0.9):\n{}\n",
33        response1.text()
34    );
35
36    // Using individual generation parameters
37    println!("--- Using individual generation parameters ---");
38    let response2 = client
39        .generate_content()
40        .with_system_prompt("You are a helpful assistant.")
41        .with_user_message("Write a short poem about Rust programming language.")
42        .with_temperature(0.2)
43        .with_max_output_tokens(100)
44        .execute()
45        .await?;
46
47    println!(
48        "Response with low temperature (0.2):\n{}\n",
49        response2.text()
50    );
51
52    // Setting multiple parameters individually
53    println!("--- Setting multiple parameters individually ---");
54    let response3 = client
55        .generate_content()
56        .with_system_prompt("You are a helpful assistant.")
57        .with_user_message("List 3 benefits of using Rust.")
58        .with_temperature(0.7)
59        .with_top_p(0.9)
60        .with_max_output_tokens(150)
61        .with_stop_sequences(vec!["4.".to_string()])
62        .execute()
63        .await?;
64
65    println!(
66        "Response with custom parameters and stop sequence:\n{}",
67        response3.text()
68    );
69
70    Ok(())
71}
examples/structured_response.rs (line 11)
6async fn main() -> Result<(), Box<dyn std::error::Error>> {
7    // Get API key from environment variable
8    let api_key = env::var("GEMINI_API_KEY").expect("GEMINI_API_KEY environment variable not set");
9
10    // Create client
11    let client = Gemini::new(api_key);
12
13    // Using response_schema for structured output
14    println!("--- Structured Response Example ---");
15
16    // Define a JSON schema for the response
17    let schema = json!({
18        "type": "object",
19        "properties": {
20            "name": {
21                "type": "string",
22                "description": "Name of the programming language"
23            },
24            "year_created": {
25                "type": "integer",
26                "description": "Year the programming language was created"
27            },
28            "creator": {
29                "type": "string",
30                "description": "Person or organization who created the language"
31            },
32            "key_features": {
33                "type": "array",
34                "items": {
35                    "type": "string"
36                },
37                "description": "Key features of the programming language"
38            },
39            "popularity_score": {
40                "type": "integer",
41                "description": "Subjective popularity score from 1-10"
42            }
43        },
44        "required": ["name", "year_created", "creator", "key_features", "popularity_score"]
45    });
46
47    let response = client
48        .generate_content()
49        .with_system_prompt("You provide information about programming languages in JSON format.")
50        .with_user_message("Tell me about the Rust programming language.")
51        .with_response_mime_type("application/json")
52        .with_response_schema(schema)
53        .execute()
54        .await?;
55
56    println!("Structured JSON Response:");
57    println!("{}", response.text());
58
59    // Parse the JSON response
60    let json_response: serde_json::Value = serde_json::from_str(&response.text())?;
61
62    println!("\nAccessing specific fields:");
63    println!("Language: {}", json_response["name"]);
64    println!("Created in: {}", json_response["year_created"]);
65    println!("Created by: {}", json_response["creator"]);
66    println!("Popularity: {}/10", json_response["popularity_score"]);
67
68    println!("\nKey Features:");
69    if let Some(features) = json_response["key_features"].as_array() {
70        for (i, feature) in features.iter().enumerate() {
71            println!("{}. {}", i + 1, feature);
72        }
73    }
74
75    Ok(())
76}
Additional examples can be found in:
Source

pub fn pro(api_key: impl Into<String>) -> Self

Create a new client for the Gemini Pro model

Examples found in repository?
examples/gemini_pro_example.rs (line 11)
6async fn main() -> Result<(), Box<dyn std::error::Error>> {
7    // Replace with your actual API key
8    let api_key = env::var("GEMINI_API_KEY").expect("GEMINI_API_KEY environment variable not set");
9
10    // Create a Gemini client
11    let gemini = Gemini::pro(api_key);
12
13    // This example matches the exact curl request format:
14    // curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key=$GEMINI_API_KEY" \
15    //   -H 'Content-Type: application/json' \
16    //   -d '{
17    //     "system_instruction": {
18    //       "parts": [
19    //         {
20    //           "text": "You are a cat. Your name is Neko."
21    //         }
22    //       ]
23    //     },
24    //     "contents": [
25    //       {
26    //         "parts": [
27    //           {
28    //             "text": "Hello there"
29    //           }
30    //         ]
31    //       }
32    //     ]
33    //   }'
34    let response = gemini
35        .generate_content()
36        .with_system_instruction("You are a cat. Your name is Neko.")
37        .with_user_message("Hello there")
38        .execute()
39        .await?;
40
41    // Print the response
42    println!("Response: {}", response.text());
43
44    Ok(())
45}
Source

pub fn with_model(api_key: impl Into<String>, model: String) -> Self

Create a new client with the specified API key and model

Source

pub fn generate_content(&self) -> ContentBuilder

Start building a content generation request

Examples found in repository?
examples/test_api.rs (line 15)
5async fn main() -> Result<(), Box<dyn std::error::Error>> {
6    let api_key = env::var("GEMINI_API_KEY")?;
7
8    // Create client with the default model (gemini-2.0-flash)
9    let client = Gemini::new(api_key);
10
11    println!("Sending request to Gemini API...");
12
13    // Simple text completion with minimal content
14    let response = client
15        .generate_content()
16        .with_user_message("Say hello")
17        .execute()
18        .await?;
19
20    println!("Response: {}", response.text());
21
22    Ok(())
23}
More examples
Hide additional examples
examples/google_search.rs (line 19)
5async fn main() -> Result<(), Box<dyn std::error::Error>> {
6    // Get API key from environment variable
7    let api_key = env::var("GEMINI_API_KEY").expect("GEMINI_API_KEY environment variable not set");
8
9    // Create client
10    let client = Gemini::new(api_key);
11
12    println!("--- Google Search tool example ---");
13
14    // Create a Google Search tool
15    let google_search_tool = Tool::google_search();
16
17    // Create a request with Google Search tool
18    let response = client
19        .generate_content()
20        .with_user_message("What is the current Google stock price?")
21        .with_tool(google_search_tool)
22        .execute()
23        .await?;
24
25    println!("Response: {}", response.text());
26
27    Ok(())
28}
examples/gemini_pro_example.rs (line 35)
6async fn main() -> Result<(), Box<dyn std::error::Error>> {
7    // Replace with your actual API key
8    let api_key = env::var("GEMINI_API_KEY").expect("GEMINI_API_KEY environment variable not set");
9
10    // Create a Gemini client
11    let gemini = Gemini::pro(api_key);
12
13    // This example matches the exact curl request format:
14    // curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key=$GEMINI_API_KEY" \
15    //   -H 'Content-Type: application/json' \
16    //   -d '{
17    //     "system_instruction": {
18    //       "parts": [
19    //         {
20    //           "text": "You are a cat. Your name is Neko."
21    //         }
22    //       ]
23    //     },
24    //     "contents": [
25    //       {
26    //         "parts": [
27    //           {
28    //             "text": "Hello there"
29    //           }
30    //         ]
31    //       }
32    //     ]
33    //   }'
34    let response = gemini
35        .generate_content()
36        .with_system_instruction("You are a cat. Your name is Neko.")
37        .with_user_message("Hello there")
38        .execute()
39        .await?;
40
41    // Print the response
42    println!("Response: {}", response.text());
43
44    Ok(())
45}
examples/curl_google_search.rs (line 47)
5async fn main() -> Result<(), Box<dyn std::error::Error>> {
6    // Get API key from environment variable
7    let api_key = env::var("GEMINI_API_KEY").expect("GEMINI_API_KEY environment variable not set");
8
9    println!("--- Curl equivalent with Google Search tool ---");
10
11    // This is equivalent to the curl example:
12    // curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key=$GEMINI_API_KEY" \
13    //   -H "Content-Type: application/json" \
14    //   -d '{
15    //       "contents": [
16    //           {
17    //               "parts": [
18    //                   {"text": "What is the current Google stock price?"}
19    //               ]
20    //           }
21    //       ],
22    //       "tools": [
23    //           {
24    //               "google_search": {}
25    //           }
26    //       ]
27    //   }'
28
29    // Create client
30    let client = Gemini::new(api_key);
31
32    // Create a content part that matches the JSON in the curl example
33    let text_part = Part::Text {
34        text: "What is the current Google stock price?".to_string(),
35    };
36
37    let content = Content {
38        parts: vec![text_part],
39        role: None,
40    };
41
42    // Create a Google Search tool
43    let google_search_tool = Tool::google_search();
44
45    // Add the content and tool directly to the request
46    // This exactly mirrors the JSON structure in the curl example
47    let mut content_builder = client.generate_content();
48    content_builder.contents.push(content);
49    content_builder = content_builder.with_tool(google_search_tool);
50
51    let response = content_builder.execute().await?;
52
53    println!("Response: {}", response.text());
54
55    Ok(())
56}
examples/curl_equivalent.rs (line 32)
5async fn main() -> Result<(), Box<dyn std::error::Error>> {
6    // Get API key from environment variable
7    let api_key = env::var("GEMINI_API_KEY").expect("GEMINI_API_KEY environment variable not set");
8
9    // This is equivalent to the curl example:
10    // curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key=$YOUR_API_KEY" \
11    //   -H 'Content-Type: application/json' \
12    //   -X POST \
13    //   -d '{
14    //     "contents": [
15    //       {
16    //         "parts": [
17    //           {
18    //             "text": "Explain how AI works in a few words"
19    //           }
20    //         ]
21    //       }
22    //     ]
23    //   }'
24
25    // Create client - now using gemini-2.0-flash by default
26    let client = Gemini::new(api_key);
27
28    // Method 1: Using the high-level API (simplest approach)
29    println!("--- Method 1: Using the high-level API ---");
30
31    let response = client
32        .generate_content()
33        .with_user_message("Explain how AI works in a few words")
34        .execute()
35        .await?;
36
37    println!("Response: {}", response.text());
38
39    // Method 2: Using Content directly to match the curl example exactly
40    println!("\n--- Method 2: Matching curl example structure exactly ---");
41
42    // Create a content part that matches the JSON in the curl example
43    let text_part = Part::Text {
44        text: "Explain how AI works in a few words".to_string(),
45    };
46
47    let content = Content {
48        parts: vec![text_part],
49        role: None,
50    };
51
52    // Add the content directly to the request
53    // This exactly mirrors the JSON structure in the curl example
54    let mut content_builder = client.generate_content();
55    content_builder.contents.push(content);
56    let response = content_builder.execute().await?;
57
58    println!("Response: {}", response.text());
59
60    Ok(())
61}
examples/generation_config.rs (line 15)
5async fn main() -> Result<(), Box<dyn std::error::Error>> {
6    // Get API key from environment variable
7    let api_key = env::var("GEMINI_API_KEY").expect("GEMINI_API_KEY environment variable not set");
8
9    // Create client
10    let client = Gemini::new(api_key);
11
12    // Using the full generation config
13    println!("--- Using full generation config ---");
14    let response1 = client
15        .generate_content()
16        .with_system_prompt("You are a helpful assistant.")
17        .with_user_message("Write a short poem about Rust programming language.")
18        .with_generation_config(GenerationConfig {
19            temperature: Some(0.9),
20            top_p: Some(0.8),
21            top_k: Some(20),
22            max_output_tokens: Some(200),
23            candidate_count: Some(1),
24            stop_sequences: Some(vec!["END".to_string()]),
25            response_mime_type: None,
26            response_schema: None,
27        })
28        .execute()
29        .await?;
30
31    println!(
32        "Response with high temperature (0.9):\n{}\n",
33        response1.text()
34    );
35
36    // Using individual generation parameters
37    println!("--- Using individual generation parameters ---");
38    let response2 = client
39        .generate_content()
40        .with_system_prompt("You are a helpful assistant.")
41        .with_user_message("Write a short poem about Rust programming language.")
42        .with_temperature(0.2)
43        .with_max_output_tokens(100)
44        .execute()
45        .await?;
46
47    println!(
48        "Response with low temperature (0.2):\n{}\n",
49        response2.text()
50    );
51
52    // Setting multiple parameters individually
53    println!("--- Setting multiple parameters individually ---");
54    let response3 = client
55        .generate_content()
56        .with_system_prompt("You are a helpful assistant.")
57        .with_user_message("List 3 benefits of using Rust.")
58        .with_temperature(0.7)
59        .with_top_p(0.9)
60        .with_max_output_tokens(150)
61        .with_stop_sequences(vec!["4.".to_string()])
62        .execute()
63        .await?;
64
65    println!(
66        "Response with custom parameters and stop sequence:\n{}",
67        response3.text()
68    );
69
70    Ok(())
71}
Additional examples can be found in:

Trait Implementations§

Source§

impl Clone for Gemini

Source§

fn clone(&self) -> Gemini

Returns a copy of the value. Read more
1.0.0 · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more

Auto Trait Implementations§

§

impl Freeze for Gemini

§

impl !RefUnwindSafe for Gemini

§

impl Send for Gemini

§

impl Sync for Gemini

§

impl Unpin for Gemini

§

impl !UnwindSafe for Gemini

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

impl<T> ErasedDestructor for T
where T: 'static,