L'API Gemini supporta il caricamento dei file multimediali separatamente dall'input del prompt, consentendo di riutilizzarli 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 di 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.
Metodo: files.get
Recupera i metadati per il File
specificato.
Endpoint
gethttps://generativelanguage.googleapis.com/v1beta/{name=files/*}
Parametri del percorso
name
string
Obbligatorio. Il nome del File
da ottenere. Esempio: files/abc-123
assume la forma files/{file}
.
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Richiesta di esempio
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di File
.
Metodo: files.list
Elenca i metadati dei File
di proprietà del progetto che effettua la richiesta.
Endpoint
gethttps://generativelanguage.googleapis.com/v1beta/files
Parametri di query
pageSize
integer
Facoltativo. 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 da una chiamata files.list
precedente.
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Richiesta di esempio
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 chiamata files.list
successiva.
Rappresentazione JSON |
---|
{
"files": [
{
object ( |
Metodo: files.delete
Elimina l'elemento File
.
Endpoint
deletehttps://generativelanguage.googleapis.com/v1beta/{name=files/*}
Parametri del percorso
name
string
Obbligatorio. Il nome del File
da eliminare. Esempio: files/abc-123
assume la forma files/{file}
.
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Richiesta di esempio
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. ID successivo: 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. Dimensioni del file in byte.
createTime
string (Timestamp
format)
Solo output. Il timestamp della creazione del File
.
Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. 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 sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. 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 dell'eliminazione di File
. Imposta solo se la scadenza di File
è programmata.
Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. 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 del File
.
downloadUri
string
Solo output. L'URI di download del 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 (VideoMetadata
)
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 ( |
VideoMetadata
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 per il 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 è elaborato e disponibile per l'inferenza. |
FAILED |
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. |
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 dati: codice di errore, messaggio di errore e dettagli dell'errore.
Per scoprire di più su questo modello di errore e su come utilizzarlo, consulta la 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 agli utenti deve essere localizzato e inviato nel campo google.rpc.Status.details
o localizzato dal cliente.
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 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: ..., ... } ] } |