Struct ModelId 

pub struct ModelId(/* private fields */);

A Gemini model identifier, exactly as the API accepts it.

Either the resource form models/gemini-… or a bare gemini-… name; the wire layer normalises whichever you give it. This is a string newtype rather than an enum on purpose: the model catalog changes faster than any release cycle, and an enum of “known” models guarantees that the named variants are the stale ones while the real work goes through an escape hatch. The known-good names live here as constants instead, so they are discoverable without being the only thing that typechecks.

use gemini_genai_rs::prelude::ModelId;

let a: ModelId = "models/gemini-2.5-flash-native-audio-latest".into();
let b = ModelId::new(String::from("gemini-flash-latest"));
let c = ModelId::LIVE_2_5_FLASH_NATIVE_AUDIO;
assert_eq!(a.as_str(), "models/gemini-2.5-flash-native-audio-latest");
assert_ne!(b, c);

Leave the model unset on SessionConfig and connect resolves a platform-appropriate default via ModelId::live_default; set it only when you need a specific model.

Implementations

impl ModelId

pub const LIVE_2_5_FLASH_NATIVE_AUDIO: ModelId

Vertex AI’s GA Live model name (per Google Cloud docs).

pub const FLASH_2_5_NATIVE_AUDIO_LATEST: ModelId

Google AI’s rolling alias for the current native-audio Live model. Verified reachable on Google AI 2026-08; the dated names it aliases are retired without notice, which is why the alias is the default.

pub const FLASH_LATEST: ModelId

Google AI’s rolling alias for the current Flash text model (generateContent). Dated gemini-2.5-flash names 404 there.

pub const fn from_static(id: &'static str) -> Self

A model id from a 'static string, usable in const context.

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

A model id from any string.

pub fn qualified(id: impl Into<String>) -> Self

A model id with the models/ resource prefix added when the name is bare (contains no /). Qualified names — models/…, projects/… — pass through untouched.

pub fn as_str(&self) -> &str

The identifier as given.

pub fn bare_name(&self) -> &str

The identifier without a leading models/, which is the form Vertex AI wants inside its publisher path.

pub fn live_default(vertex: bool) -> Self

The Live model to use when none was set: GEMINI_LIVE_MODEL if set, else GEMINI_MODEL, else the platform’s current native-audio Flash model.

GEMINI_LIVE_MODEL exists because GEMINI_MODEL is also the text model override (GeminiLlm reads GEMINI_TEXT_MODEL, then GEMINI_MODEL): a native-audio name in the shared variable would 404 every generateContent call. A bare name (no /) gets the models/ prefix the wire expects; a qualified one passes through untouched.

Trait Implementations

impl AsRef<str> for ModelId

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for ModelId

fn clone(&self) -> ModelId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ModelId

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ModelId

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ModelId

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<&String> for ModelId

fn from(s: &String) -> Self

Converts to this type from the input type.

impl From<&str> for ModelId

fn from(s: &str) -> Self

Converts to this type from the input type.

impl From<String> for ModelId

fn from(s: String) -> Self

Converts to this type from the input type.

impl FromStr for ModelId

type Err = Infallible

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for ModelId

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq<&str> for ModelId

fn eq(&self, other: &&str) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<str> for ModelId

fn eq(&self, other: &str) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq for ModelId

fn eq(&self, other: &ModelId) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ModelId

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for ModelId

impl StructuralPartialEq for ModelId