Enum UserContent 

pub enum UserContent {
    Text {
        text: String,
    },
    ImageUrl {
        image_url: ImageUrl,
    },
    File {
        file: FileContent,
    },
    InputAudio {
        input_audio: InputAudio,
    },
    VideoUrl {
        video_url: VideoUrlContent,
    },
}

User content types supported by OpenRouter.

OpenRouter uses different content type structures than OpenAI’s Chat Completions API, particularly for file/document, audio, and video content. This enum matches OpenRouter’s API specification.

Supported Content Types

• Text: Plain text content
• ImageUrl: Images via URL or base64 data URI
• File: PDF documents and other files via URL or base64 data URI
• InputAudio: Base64-encoded audio files (supported formats vary by model)
• VideoUrl: Videos via URL or base64 data URI

Example

use rig::providers::openrouter::UserContent;

// Text content
let text = UserContent::text("Hello, world!");

// Image from URL
let image = UserContent::image_url("https://example.com/image.png");

// PDF from URL
let pdf = UserContent::file_url("https://example.com/document.pdf", Some("document.pdf".to_string()));

// Audio from base64
use rig::completion::message::AudioMediaType;
let audio = UserContent::audio_base64("base64data", AudioMediaType::WAV);

// Video from URL
let video = UserContent::video_url("https://example.com/video.mp4");

// Video from base64
use rig::completion::message::VideoMediaType;
let video = UserContent::video_base64("base64data", VideoMediaType::MP4);

Variants

Text

Plain text content

Fields

text: String

ImageUrl

Image content (URL or base64 data URI)

Supports: image/png, image/jpeg, image/webp, image/gif

Fields

image_url: ImageUrl

File

File content (for PDFs and other documents)

Uses file_data field which accepts either a publicly accessible URL or base64-encoded content as a data URI.

Fields

file: FileContent

InputAudio

Audio content (base64-encoded only; URLs are not supported for audio)

Supported formats vary by model.

Fields

input_audio: InputAudio

VideoUrl

Video content (URL or base64 data URI)

Supports: video/mp4, video/mpeg, video/mov, video/webm. URL support varies by provider.

Fields

video_url: VideoUrlContent

Implementations

impl UserContent

pub fn text(text: impl Into<String>) -> UserContent

Create text content

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

Create image content from URL

pub fn image_url_with_detail( url: impl Into<String>, detail: ImageDetail, ) -> UserContent

Create image content from URL with detail level

pub fn image_base64( data: impl Into<String>, mime_type: &str, detail: Option<ImageDetail>, ) -> UserContent

Create image content from base64 data

Arguments

• data - Base64-encoded image data
• mime_type - MIME type (e.g., “image/png”, “image/jpeg”)
• detail - Optional detail level for image processing

pub fn file_url(url: impl Into<String>, filename: Option<String>) -> UserContent

Create file content from URL

Arguments

• url - URL to the file (must be publicly accessible)
• filename - Optional filename for the document

pub fn file_base64( data: impl Into<String>, mime_type: &str, filename: Option<String>, ) -> UserContent

Create file content from base64 data

Arguments

• data - Base64-encoded file data
• mime_type - MIME type (e.g., “application/pdf”)
• filename - Optional filename for the document

pub fn audio_base64( data: impl Into<String>, format: AudioMediaType, ) -> UserContent

Create audio content from base64-encoded data

OpenRouter only supports base64-encoded audio; direct URLs are not supported.

Arguments

• data - Base64-encoded audio data
• format - Audio format (e.g., AudioMediaType::WAV, AudioMediaType::MP3)

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

Create video content from a URL

URL support varies by provider.

Arguments

• url - URL to the video (must be publicly accessible)

pub fn video_base64( data: impl Into<String>, media_type: VideoMediaType, ) -> UserContent

Create video content from base64-encoded data

Arguments

• data - Base64-encoded video data
• media_type - Video media type (e.g., VideoMediaType::MP4)

Trait Implementations

impl Clone for UserContent

fn clone(&self) -> UserContent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UserContent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for UserContent

fn deserialize<__D>( __deserializer: __D, ) -> Result<UserContent, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&str> for UserContent

fn from(text: &str) -> UserContent

Converts to this type from the input type.

impl From<String> for UserContent

fn from(text: String) -> UserContent

Converts to this type from the input type.

impl From<UserContent> for UserContent

Convert OpenAI’s UserContent to OpenRouter’s UserContent

fn from(value: UserContent) -> UserContent

Converts to this type from the input type.

impl FromStr for UserContent

type Err = Infallible

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<UserContent, <UserContent as FromStr>::Err>

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

impl PartialEq for UserContent

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<UserContent> for UserContent

type Error = MessageError

The type returned in the event of a conversion error.

fn try_from( value: UserContent, ) -> Result<UserContent, <UserContent as TryFrom<UserContent>>::Error>

Performs the conversion.

impl StructuralPartialEq for UserContent