upload_file
Upload local files to Gemini Files API to handle large images over 20MB or reuse files across multiple prompts, returning file URI and metadata.
Instructions
Upload a local file through the Gemini Files API and return its URI & metadata. Useful when the image is larger than 20MB or reused across prompts.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| display_name | No | Optional display name for the uploaded file. | |
| path | Yes | Server-accessible file path to upload to Gemini Files API. |
Input Schema (JSON Schema)
{
"properties": {
"display_name": {
"anyOf": [
{
"maxLength": 256,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional display name for the uploaded file.",
"title": "Display Name"
},
"path": {
"description": "Server-accessible file path to upload to Gemini Files API.",
"maxLength": 512,
"minLength": 1,
"title": "Path",
"type": "string"
}
},
"required": [
"path"
],
"type": "object"
}