# Binary data helpers

> Binary data helpers - Returns base64 encoded string of images located in addresses passed in input
> collection. Input collection should hold data of valid image url addresses reachable from location
> where code is being executed. Method will retrieve image, apply specified reformatting before
> converting contents to base64 string. Results will in same order as specified in input collection.

This Markdown file sits beside the HTML page at the same path (with a `.md` suffix). It summarizes the topic and lists links for tools and LLM context.

Companion generated at `2026-05-06T18:17:09.820714+00:00` (UTC).

## Primary page

- [Binary data helpers](https://docs.datarobot.com/en/docs/api/reference/sdk/binary_data_helpers.html): Full documentation for this topic (HTML).

## Sections on this page

- [datarobot.helpers.binary_data_utils.get_encoded_image_contents_from_urls(urls, custom_headers=None, image_options=None, continue_on_error=False, n_threads=None)](https://docs.datarobot.com/en/docs/api/reference/sdk/binary_data_helpers.html#datarobot.helpers.binary_data_utils.get_encoded_image_contents_from_urls): In-page section heading.
- [datarobot.helpers.binary_data_utils.get_encoded_image_contents_from_paths(paths, image_options=None, continue_on_error=False, n_threads=None, base_path=None)](https://docs.datarobot.com/en/docs/api/reference/sdk/binary_data_helpers.html#datarobot.helpers.binary_data_utils.get_encoded_image_contents_from_paths): In-page section heading.
- [datarobot.helpers.binary_data_utils.get_encoded_file_contents_from_paths(paths, continue_on_error=False, n_threads=None, base_path=None)](https://docs.datarobot.com/en/docs/api/reference/sdk/binary_data_helpers.html#datarobot.helpers.binary_data_utils.get_encoded_file_contents_from_paths): In-page section heading.
- [datarobot.helpers.binary_data_utils.get_encoded_file_contents_from_urls(urls, custom_headers=None, continue_on_error=False, n_threads=None)](https://docs.datarobot.com/en/docs/api/reference/sdk/binary_data_helpers.html#datarobot.helpers.binary_data_utils.get_encoded_file_contents_from_urls): In-page section heading.
- [classdatarobot.helpers.image_utils.ImageOptions](https://docs.datarobot.com/en/docs/api/reference/sdk/binary_data_helpers.html#datarobot.helpers.image_utils.ImageOptions): In-page section heading.

## Related documentation

- [Developer documentation](https://docs.datarobot.com/en/docs/api/index.html): Linked from this page.
- [API reference](https://docs.datarobot.com/en/docs/api/reference/index.html): Linked from this page.

## Documentation content

### datarobot.helpers.binary_data_utils.get_encoded_image_contents_from_urls(urls, custom_headers=None, image_options=None, continue_on_error=False, n_threads=None)

Returns base64 encoded string of images located in addresses passed in input collection.
Input collection should hold data of valid image url addresses reachable from
location where code is being executed. Method will retrieve image, apply specified
reformatting before converting contents to base64 string. Results will in same
order as specified in input collection.

- Parameters:
- Raises: ContentRetrievalTerminatedError: – The error is raised when the flag continue_on_error is set to` False` and processing has
      been terminated due to an exception while loading the contents of the file.
- Return type: List of base64 encoded strings representing reformatted images.

### datarobot.helpers.binary_data_utils.get_encoded_image_contents_from_paths(paths, image_options=None, continue_on_error=False, n_threads=None, base_path=None)

Returns base64 encoded string of images located in paths passed in input collection.
Input collection should hold data of valid image paths reachable from location
where code is being executed. Method will retrieve image, apply specified
reformatting before converting contents to base64 string. Results will in same
order as specified in input collection.

- Parameters:
- Raises: ContentRetrievalTerminatedError: – The error is raised when the flag continue_on_error is set to` False` and processing has
      been terminated due to an exception while loading the contents of the file.
- Return type: List of base64 encoded strings representing reformatted images.

### datarobot.helpers.binary_data_utils.get_encoded_file_contents_from_paths(paths, continue_on_error=False, n_threads=None, base_path=None)

Returns base64 encoded string for files located under paths passed in input collection.
Input collection should hold data of valid file paths locations reachable from
location where code is being executed. Method will retrieve file and convert its contents
to base64 string. Results will be returned in same order as specified in input collection.

- Parameters:
- Raises: ContentRetrievalTerminatedError: – The error is raised when the flag continue_on_error is set to` False` and processing has
      been terminated due to an exception while loading the contents of the file.
- Return type: List of base64 encoded strings representing files.

### datarobot.helpers.binary_data_utils.get_encoded_file_contents_from_urls(urls, custom_headers=None, continue_on_error=False, n_threads=None)

Returns base64-encoded string for files located in the URL addresses passed on input. Input
collection holds data of valid file URL addresses reachable from location where code is being
executed. Method will retrieve file and convert its contents to base64 string. Results will
be returned in same order as specified in input collection.

- Parameters:
- Raises: ContentRetrievalTerminatedError: – The error is raised when the flag continue_on_error is set to` False` and processing has
      been terminated due to an exception while loading the contents of the file.
- Return type: List of base64 encoded strings representing files.

### class datarobot.helpers.image_utils.ImageOptions

Image options class. Class holds image options related to image resizing and image reformatting.

should_resize: bool
: Whether input image should be resized to new dimensions.

force_size: bool
: Whether the image size should fully match the new requested size. If the original
  and new image sizes have different aspect ratios, specifying True will force a resize
  to exactly match the requested size. This may break the aspect ratio of the original
  image. If False, the resize method modifies the image to contain a thumbnail version
  of itself, no larger than the given size, that preserves the image’s aspect ratio.

image_size: Tuple[int, int]
: New image size (width, height). Both values (width, height) should be specified and contain
  a positive value. Depending on the value of force_size, the image will be resized exactly
  to the given image size or will be resized into a thumbnail version of itself, no larger
  than the given size.

image_format: ImageFormat | str
: What image format will be used to save result image after transformations. For example
  (ImageFormat.JPEG, ImageFormat.PNG). Values supported are in line with values supported
  by DataRobot. If no format is specified by passing None value original image format
  will be preserved.

image_quality: int or None
: The image quality used when saving image. When None is specified, a value will
  not be passed and Pillow library will use its default.

resample_method: ImageResampleMethod
: What resampling method should be used when resizing image.

keep_quality: bool
: Whether the image quality is kept (when possible). If True, for JPEG images quality will
  be preserved. For other types, the value specified in image_quality will be used.