Image / Audio / Pdf / Video

// Pass in an image type
function DescribeImage(image: image) -> string {
    client "openai/gpt-5-mini"
    prompt #"
        Describe the image.
        {{ image }}
    "#
}
test ImageDescriptionFromURL {
    functions [DescribeImage]
    args {
        image {
            url "https://upload.wikimedia.org/wikipedia/en/4/4d/Shrek_%28character%29.png"
        }
    }
}
test ImageDescriptionFromBase64 {
    functions [DescribeImage]
    args { 
        image {
            media_type "image/png"
            base64 "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x/AAzmH+UlvRkwAAAAASUVORK5CYII="
        }
    }
}
test ImageDescriptionFromFile {
    functions [DescribeImage]
    args {
        image {
            file "./shrek.png"
        }
    }
}
## Controlling URL Processing
You can control how BAML processes media URLs before sending them to providers using the `media_url_handler` configuration option:
```baml
client<llm> MyClient {
  provider anthropic
  options {
    media_url_handler {
      image "send_base64"     // Convert URLs to base64
      pdf "send_url"          // Keep URLs as-is
    }
  }
}