L'API Gemini supporta il caricamento di file multimediali separatamente dall'input del prompt, consentendo il riutilizzo dei contenuti multimediali in più richieste e più prompt. Per maggiori dettagli, consulta la guida Prompt con contenuti multimediali.
Metodo: media.upload
Crea un File.
Endpoint
- URI di caricamento, per le richieste di caricamento dei contenuti multimediali:
https: / /generativelanguage.googleapis.com /upload /v1beta /files - URI dei metadati, per le richieste solo di metadati:
https: / /generativelanguage.googleapis.com /v1beta /files Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
file object (File) Facoltativo. Metadati del file da creare.
Esempio di richiesta
Immagine
Python
Node.js
Go
Conchiglia
Audio
Python
Node.js
Go
Conchiglia
Testo
Python
Node.js
Go
Conchiglia
Video
Python
Node.js
Go
Conchiglia
Python
Go
Metodo: files.get
Recupera i metadati per l'elemento File specificato.
Endpoint
gethttps: / /generativelanguage.googleapis.com /v1beta /{name=files /*} Parametri del percorso
name string Obbligatorio. Il nome di File da ottenere. Esempio: files/abc-123 Assume la forma files/{file}.
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Esempio di richiesta
Python
Node.js
Go
Conchiglia
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di File.
Metodo: files.list
Elenca i metadati per File di proprietà del progetto richiedente.
Endpoint
gethttps: / /generativelanguage.googleapis.com /v1beta /files Parametri di query
pageSize integer Facoltativo. Il numero massimo di File da restituire per pagina. Se non specificato, il valore predefinito è 10. Il valore massimo di pageSize è 100.
pageToken string Facoltativo. Un token di pagina di una precedente chiamata files.list.
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Esempio di richiesta
Python
Node.js
Go
Conchiglia
Corpo della risposta
Risposta per files.list.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
files[] object (File) L'elenco di File.
nextPageToken string Un token che può essere inviato come pageToken in una successiva chiamata files.list.
| Rappresentazione JSON |
|---|
{ "files": [ { object ( |
Metodo: files.delete
Elimina File.
Endpoint
deletehttps: / /generativelanguage.googleapis.com /v1beta /{name=files /*} Parametri del percorso
name string Obbligatorio. Il nome di File da eliminare. Esempio: files/abc-123 Assume la forma files/{file}.
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Esempio di richiesta
Python
Node.js
Go
Conchiglia
Corpo della risposta
In caso di esito positivo, il corpo della risposta è un oggetto JSON vuoto.
Risorsa REST: files
Risorsa: File
Un file caricato nell'API. Next ID: 15
name string Immutabile. Identificatore. Il nome della risorsa File. L'ID (nome escluso il prefisso "files/") può contenere fino a 40 caratteri alfanumerici minuscoli o trattini (-). L'ID non può iniziare o terminare con un trattino. Se il nome è vuoto al momento della creazione, verrà generato un nome univoco. Esempio: files/123-456
displayName string Facoltativo. Il nome visualizzato leggibile per File. Il nome visualizzato non deve contenere più di 512 caratteri, spazi inclusi. Esempio: "Immagine di benvenuto"
mimeType string Solo output. Tipo MIME del file.
sizeBytes string (int64 format) Solo output. Le dimensioni del file in byte.
createTime string (Timestamp format) Solo output. Timestamp della creazione di File.
Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime string (Timestamp format) Solo output. Il timestamp dell'ultimo aggiornamento di File.
Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
expirationTime string (Timestamp format) Solo output. Il timestamp di eliminazione di File. Impostato solo se la scadenza di File è programmata.
Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
sha256Hash string (bytes format) Solo output. Hash SHA-256 dei byte caricati.
Una stringa con codifica Base64.
uri string Solo output. L'URI di File.
downloadUri string Solo output. L'URI di download di File.
state enum (State) Solo output. Stato di elaborazione del file.
source enum (Source) Origine del file.
error object (Status) Solo output. Stato di errore se l'elaborazione del file non è riuscita.
metadata Union type metadata può essere solo uno dei seguenti:videoMetadata object (VideoFileMetadata) Solo output. Metadati di un video.
| Rappresentazione JSON |
|---|
{ "name": string, "displayName": string, "mimeType": string, "sizeBytes": string, "createTime": string, "updateTime": string, "expirationTime": string, "sha256Hash": string, "uri": string, "downloadUri": string, "state": enum ( |
VideoFileMetadata
Metadati di un video File.
videoDuration string (Duration format) Durata del video.
Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
| Rappresentazione JSON |
|---|
{ "videoDuration": string } |
Stato
Stati del ciclo di vita di un file.
| Enum | |
|---|---|
STATE_UNSPECIFIED | Il valore predefinito. Questo valore viene utilizzato se lo stato viene omesso. |
PROCESSING | Il file è in fase di elaborazione e non può ancora essere utilizzato per l'inferenza. |
ACTIVE | Il file viene elaborato ed è disponibile per l'inferenza. |
FAILED | L'elaborazione del file non è riuscita. |
Origine
| Enum | |
|---|---|
SOURCE_UNSPECIFIED | Utilizzato se l'origine non è specificata. |
UPLOADED | Indica che il file è stato caricato dall'utente. |
GENERATED | Indica che il file è generato da Google. |
REGISTERED | Indica che il file è registrato, ovvero un file Google Cloud Storage. |
Stato
Il tipo Status definisce un modello di errore logico adatto a diversi ambienti di programmazione, tra cui API REST e API RPC. Viene utilizzato da gRPC. Ogni messaggio Status contiene tre elementi di dati: codice di errore, messaggio di errore e dettagli dell'errore.
Puoi scoprire di più su questo modello di errore e su come utilizzarlo nella guida alla progettazione delle API.
code integer Il codice di stato, che deve essere un valore enum di google.rpc.Code.
message string Un messaggio di errore rivolto agli sviluppatori, che deve essere in inglese. Qualsiasi messaggio di errore rivolto all'utente deve essere localizzato e inviato nel campo google.rpc.Status.details o localizzato dal client.
details[] object Un elenco di messaggi che contengono i dettagli dell'errore. Esiste un insieme comune di tipi di messaggi che le API possono utilizzare.
Un oggetto contenente campi di un tipo arbitrario. Un campo aggiuntivo "@type" contiene un URI che identifica il tipo. Esempio: { "id": 1234, "@type": "types.example.com/standard/id" }
| Rappresentazione JSON |
|---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |