Enum ContentPart 

pub enum ContentPart {
    Text {
        text: String,
    },
    Image {
        data: String,
        mime_type: String,
        content_type: String,
        detail: Option<ImageDetail>,
        image_url: Option<String>,
    },
    File {
        content_type: String,
        filename: Option<String>,
        file_id: Option<String>,
        file_data: Option<String>,
        file_url: Option<String>,
    },
}

Content type for messages that can include both text and images

Variants

Text

Fields

text: String

Image

Fields

data: String

mime_type: String

content_type: String

detail: Option<ImageDetail>

image_url: Option<String>

File

Fields

content_type: String

filename: Option<String>

file_id: Option<String>

file_data: Option<String>

file_url: Option<String>

Implementations

impl ContentPart

pub fn text(text: String) -> Self

pub fn image(data: String, mime_type: String) -> Self

pub fn image_with_detail( data: String, mime_type: String, detail: ImageDetail, ) -> Self

pub fn image_from_url( url: String, detail: Option<ImageDetail>, ) -> Result<Self, String>

Create an image part from an external URL.

DeepSeek external URLs must be https://, ≤8192 chars, and ≤32MiB file. Returns Err for malformed URLs (fail-closed) so callers must handle it.

pub fn image_source(&self) -> Option<ImageSource<'_>>

Strictly typed view of the image source (Base64 vs URL).

This isolates the data/mime_type/image_url triple behind a single dispatch point (KISS/DRY guard rail for the next generation phase).

pub fn validate_image(&self) -> Result<(), String>

Validate image part invariants (MIME allowlist, size, URL limits).

DeepSeek supports JPEG/PNG/GIF/WebP; other types are warned but not rejected to keep the interface open for future providers.

pub fn image_with_detail_str( data: String, mime_type: String, detail_str: &str, ) -> Option<Self>

Ergonomic helper for string-based detail (parses case-insensitively). Returns None and warns if detail_str is invalid.

pub fn file_from_url(file_url: String) -> Self

pub fn file_from_data(filename: String, file_data: String) -> Self

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

Trait Implementations

impl Clone for ContentPart

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContentPart

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ContentPart

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ContentPart

impl PartialEq for ContentPart

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ContentPart

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 ContentPart