Struct ContentBuilder 

pub struct ContentBuilder { /* private fields */ }

Fluent builder for composing a multimodal Message from interleaved text, image, file, and audio parts.

use openrouter::{ContentBuilder, ImageDetail, Role};

let msg = ContentBuilder::new()
    .add_text("Compare these:")
    .add_image("https://example.com/a.png")
    .add_image_with_detail("https://example.com/b.png", ImageDetail::High)
    .build_message(Role::User);
assert_eq!(msg.role, Role::User);

Implementations

impl ContentBuilder

pub fn new() -> Self

New empty builder.

pub fn add_text(self, text: impl Into<String>) -> Self

Append a plain-text part.

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

Append an image-URL part.

pub fn add_image_with_detail( self, url: impl Into<String>, detail: ImageDetail, ) -> Self

Append an image-URL part with an explicit detail level.

pub fn add_base64_image(self, path: impl AsRef<Path>) -> Result<Self>

Read an image from disk, base64-encode it, and append it.

pub fn add_pdf( self, url: impl Into<String>, filename: impl Into<String>, ) -> Self

Append a PDF reference by URL.

pub fn add_base64_pdf( self, path: impl AsRef<Path>, filename: impl Into<String>, ) -> Result<Self>

Read a PDF from disk, base64-encode it, and append it.

pub fn add_audio(self, path: impl AsRef<Path>) -> Result<Self>

Read an audio file from disk and append it.

pub fn add_text_file(self, path: impl AsRef<Path>) -> Result<Self>

Read a UTF-8 text file and append its contents as a text part.

pub fn add_part(self, part: ContentPart) -> Self

Append an arbitrary pre-built part (escape hatch).

pub fn build_message(self, role: Role) -> Message

Finalize as a Message with the given role.

pub fn build_parts(self) -> Vec<ContentPart>

Finalize as a raw Vec<ContentPart>.

Trait Implementations

impl Clone for ContentBuilder

fn clone(&self) -> ContentBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContentBuilder

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

Formats the value using the given formatter.

impl Default for ContentBuilder

fn default() -> ContentBuilder

Returns the “default value” for a type.