Skip to main content
Use this when the bytes go straight into a request of your own: the base64 image or document part a multimodal model takes, or a parser that reads from memory. Reach for download() instead when the file is meant to stay on disk, or when a library you call only takes a path. An input file is capped at 20 MB, so reading one into memory is safe.

​
Returns

Returns the file’s bytes.

​
Example

Inside an agent callback, the files of the current turn arrive as input_data.input_files, so the same call reads the document the test case attached.

​
Parameters

​
string | InputFile
required
The file to fetch: an InputFile read from test_case.input_files or input_data.input_files, or the URI of any file this organization uploaded.

​
Errors

A failed read raises instead of returning None, and the message never contains the presigned link.