Support passing files uploaded to Gemini Files API and setting custom media type

[dprov]

• Closes Support passing files uploaded to Gemini Files API #2005

[DouweM]

@dprov Thanks!

[marmor7]

@DouweM
I think this code:

self.system == 'google-gla' and not item.url.startswith(r'https://generativelanguage.googleapis.com/v1beta/files')

conflicts with the docs here:
https://ai.pydantic.dev/input/#user-side-download-vs-direct-file-url

Maybe the docs needs to be updated?

Also, would be nice to get an example code in the docs showing a file being uploaded to Gemini and then referenced in a pydantic-ai message, it's not straightforward to me.

[DouweM]

@marmor7 Good point, it's explained in the code comment but not the docs:

pydantic-ai/pydantic_ai_slim/pydantic_ai/models/google.py

Lines 610 to 613 in eae558b

	# google-gla does not support passing file urls directly, except for youtube videos
	# (see above) and files uploaded to the file API (which cannot be downloaded anyway)
	self.system == 'google-gla'
	and not item.url.startswith(r'https://generativelanguage.googleapis.com/v1beta/files')

Also, would be nice to get an example code in the docs showing a file being uploaded to Gemini and then referenced in a pydantic-ai message, it's not straightforward to me.

Good point; I'm glad you figured it out eventually but the next person should have an easier time.

Would you be up for adding both to the docs?

[marmor7]

@DouweM sure, what about this:
#3492