Enum MediaSource 

pub enum MediaSource {
    Url {
        url: HttpsUrl,
    },
    InlineBytes {
        mime: MediaType,
        data: Vec<u8>,
    },
    ProviderFile {
        file_id: ProviderFileId,
    },
    S3 {
        uri: S3Uri,
        bucket_owner: Option<AwsAccountId>,
    },
}

Where the bytes of one media content part come from.

The four variants exhaust the source kinds supported by any backend we care about: HTTPS URL (OpenAI, Anthropic), inline base64 (all), provider-issued file id (OpenAI, Anthropic), and S3 URI (Bedrock). Provider impls translate the source variant they natively speak and return CapabilityError::SourceKindUnsupported for the rest — the validation lives on the provider’s capability table, not here.

The serde representation is internally tagged on source:

{"source": "url", "url": "https://example.com/cat.png"}
{"source": "inline_bytes", "mime": "image/png", "data": "<base64>"}
{"source": "provider_file", "file_id": "file-..."}
{"source": "s3", "uri": "s3://bucket/key", "bucket_owner": "123456789012"}

This in-crate JSON shape is intentionally provider-neutral. Downstream applications can map their own accepted input envelopes into these variants before sending a request.

Variants

Url

A reachable HTTPS URL.

Fields

url: HttpsUrl

The URL the provider will fetch.

InlineBytes

Bytes carried inline. Serialized as base64 over JSON.

Fields

mime: MediaType

The media type of data. Subtype is matched against the provider’s accepted-format list at validation time.

data: Vec<u8>

Raw bytes. Encoded/decoded as base64 on the JSON wire.

ProviderFile

A reference to bytes already uploaded to the provider’s Files API.

Fields

file_id: ProviderFileId

The provider-issued file identifier.

S3

An S3 URI, with an optional explicit cross-account bucket owner.

Fields

uri: S3Uri

The S3 URI (s3://bucket/key).

bucket_owner: Option<AwsAccountId>

12-digit account id of the bucket owner. Required for cross-account access; omit when the caller’s account owns the bucket.

Implementations

impl MediaSource

pub const fn kind(&self) -> SourceKind

Return the discriminant of this source variant.

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 Eq for MediaSource

impl PartialEq for MediaSource

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

Equality operator ==.

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

Inequality operator !=.

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 StructuralPartialEq for MediaSource