Enum MediaSource 

#[non_exhaustive]
pub enum MediaSource {
    Url {
        url: String,
        media_type: Option<String>,
    },
    Base64 {
        media_type: String,
        data: String,
    },
    FileId {
        id: String,
        media_type: Option<String>,
    },
}

How a media payload is delivered to the model.

Every codec routes on the variant alone, so adding a new modality (ContentPart::Audio, ContentPart::Video etc.) reuses the same source shape — no parallel *Source enums.

media_type is required on MediaSource::Base64 (no other context to infer from) and optional on MediaSource::Url / MediaSource::FileId where URL extension or vendor metadata typically supplies it.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Url

Hosted at an https:// URL the vendor can fetch directly.

Fields

url: String

HTTPS URL.

media_type: Option<String>

IANA media type (e.g. image/png, audio/mpeg). Optional — the URL extension or HTTP Content-Type header normally suffices for the vendor.

Base64

Inlined as base64 bytes with a media type tag.

Fields

media_type: String

IANA media type — required.

data: String

Base64-encoded payload bytes.

FileId

Already uploaded via the vendor’s Files API.

Covers OpenAI Files (file-… IDs), Gemini File API (files/… IDs), Anthropic file inputs.

Fields

id: String

Vendor-assigned file identifier.

media_type: Option<String>

IANA media type — optional (vendor metadata typically supplies).

Implementations

impl MediaSource

pub fn base64(media_type: impl Into<String>, data: impl Into<String>) -> Self

Convenience constructor for a base64-inlined source.

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

Convenience constructor for a URL source.

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

Convenience constructor for a vendor file-id source.

pub fn media_type(&self) -> Option<&str>

Borrow the media type if known.

Trait Implementations

impl Clone for MediaSource

fn clone(&self) -> MediaSource

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MediaSource

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MediaSource

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for MediaSource

fn eq(&self, other: &MediaSource) -> 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 MediaSource

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 MediaSource

impl StructuralPartialEq for MediaSource