API Gemini
L'API Gemini consente agli sviluppatori di creare applicazioni di AI generativa utilizzando i modelli Gemini. Gemini è il nostro modello più avanzato, sviluppato da zero per essere multimodale. È in grado di generalizzare e di comprendere, gestire e combinare senza problemi diversi tipi di informazioni, tra cui linguaggio, immagini, audio, video e codice. Puoi utilizzare l'API Gemini per casi d'uso come il ragionamento su testo e immagini, la generazione di contenuti, gli agenti di dialogo, i sistemi di riepilogo e classificazione e altro ancora.
- Risorsa REST: v1beta.auth_tokens
- Risorsa REST: v1beta.batches
- Risorsa REST: v1beta.cachedContents
- Risorsa REST: v1beta.corpora
- Risorsa REST: v1beta.corpora.operations
- Risorsa REST: v1beta.corpora.permissions
- Risorsa REST: v1beta.dynamic
- Risorsa REST: v1beta.environments
- Risorsa REST: v1beta.environments.files.media
- Risorsa REST: v1beta.fileSearchStores
- Risorsa REST: v1beta.fileSearchStores.documents
- Risorsa REST: v1beta.fileSearchStores.operations
- Risorsa REST: v1beta.fileSearchStores.upload.operations
- Risorsa REST: v1beta.files
- Risorsa REST: v1beta.generatedFiles
- Risorsa REST: v1beta.generatedFiles.operations
- Risorsa REST: v1beta.media
- Risorsa REST: v1beta.models
- Risorsa REST: v1beta.models.operations
- Risorsa REST: v1beta.tunedModels
- Risorsa REST: v1beta.tunedModels.operations
- Risorsa REST: v1beta.tunedModels.permissions
Servizio: generativelanguage.googleapis.com
Per chiamare questo servizio, ti consigliamo di utilizzare le librerie client fornite da Google. Se la tua applicazione deve utilizzare le tue librerie per chiamare questo servizio, utilizza le seguenti informazioni quando effettui le richieste API.
Endpoint di servizio
Un endpoint di servizio è un URL di base che specifica l'indirizzo di rete di un servizio API. Un servizio potrebbe avere più endpoint di servizio. Questo servizio ha il seguente endpoint di servizio e tutti gli URI riportati di seguito sono relativi a questo endpoint di servizio:
https://generativelanguage.googleapis.com
Risorsa REST: v1beta.auth_tokens
| Metodi | |
|---|---|
create |
POST /v1beta/auth_tokens Crea un token che può essere utilizzato per vincolare il comportamento di una sessione BidiGenerateContent. |
Risorsa REST: v1beta.batches
| Metodi | |
|---|---|
cancel |
POST /v1beta/{name=batches/*}:cancel Avvia l'annullamento asincrono di un'operazione a lunga esecuzione. |
delete |
DELETE /v1beta/{name=batches/*} Elimina un'operazione a lunga esecuzione. |
get |
GET /v1beta/{name=batches/*} Recupera l'ultimo stato di un'operazione a lunga esecuzione. |
list |
GET /v1beta/{name=batches} Elenca le operazioni che corrispondono al filtro specificato nella richiesta. |
updateEmbedContentBatch |
PATCH /v1beta/{embedContentBatch.name=batches/*}:updateEmbedContentBatch Aggiorna un batch di richieste EmbedContent per l'elaborazione batch. |
updateGenerateContentBatch |
PATCH /v1beta/{generateContentBatch.name=batches/*}:updateGenerateContentBatch Aggiorna un batch di richieste GenerateContent per l'elaborazione batch. |
Risorsa REST: v1beta.cachedContents
| Metodi | |
|---|---|
create |
POST /v1beta/cachedContents Crea la risorsa CachedContent. |
delete |
DELETE /v1beta/{name=cachedContents/*} Elimina la risorsa CachedContent. |
get |
GET /v1beta/{name=cachedContents/*} Legge la risorsa CachedContent. |
list |
GET /v1beta/cachedContents Lists CachedContents. |
patch |
PATCH /v1beta/{cachedContent.name=cachedContents/*} Aggiorna la risorsa CachedContent (solo la scadenza è aggiornabile). |
Risorsa REST: v1beta.fileSearchStores
| Metodi | |
|---|---|
create |
POST /v1beta/fileSearchStores Crea un FileSearchStore vuoto. |
delete |
DELETE /v1beta/{name=fileSearchStores/*} Elimina un FileSearchStore. |
get |
GET /v1beta/{name=fileSearchStores/*} Recupera informazioni su un FileSearchStore specifico. |
importFile |
POST /v1beta/{fileSearchStoreName=fileSearchStores/*}:importFile Importa un File dal servizio file in un FileSearchStore. |
list |
GET /v1beta/fileSearchStores Elenca tutti i FileSearchStores di proprietà dell'utente. |
Risorsa REST: v1beta.fileSearchStores.documents
| Metodi | |
|---|---|
delete |
DELETE /v1beta/{name=fileSearchStores/*/documents/*} Elimina un Document. |
get |
GET /v1beta/{name=fileSearchStores/*/documents/*} Recupera informazioni su un Document specifico. |
list |
GET /v1beta/{parent=fileSearchStores/*}/documents Elenca tutti i Document in un Corpus. |
Risorsa REST: v1beta.fileSearchStores.operations
| Metodi | |
|---|---|
get |
GET /v1beta/{name=fileSearchStores/*/operations/*} Recupera l'ultimo stato di un'operazione a lunga esecuzione. |
Risorsa REST: v1beta.fileSearchStores.upload.operations
| Metodi | |
|---|---|
get |
GET /v1beta/{name=fileSearchStores/*/upload/operations/*} Recupera l'ultimo stato di un'operazione a lunga esecuzione. |
Risorsa REST: v1beta.files
| Metodi | |
|---|---|
delete |
DELETE /v1beta/{name=files/*} Elimina il File. |
get |
GET /v1beta/{name=files/*} Recupera i metadati per il File specificato. |
list |
GET /v1beta/files Elenca i metadati dei File di proprietà del progetto richiedente. |
register |
POST /v1beta/files:register Registra un file Google Cloud Storage con FileService. |
Risorsa REST: v1beta.media
| Metodi | |
|---|---|
download |
GET /v1beta/{parent=environments/*}/files Recupera i metadati dei file o i contenuti della directory dallo snapshot di un ambiente. |
upload |
POST /v1beta/files POST /upload/v1beta/files Crea un File. |
uploadToFileSearchStore |
POST /v1beta/{fileSearchStoreName=fileSearchStores/*}:uploadToFileSearchStore POST /upload/v1beta/{fileSearchStoreName=fileSearchStores/*}:uploadToFileSearchStore Carica i dati in un FileSearchStore, li preelabora e li suddivide in blocchi prima di archiviarli in un documento FileSearchStore. |
Risorsa REST: v1beta.models
| Metodi | |
|---|---|
asyncBatchEmbedContent |
POST /v1beta/{batch.model=models/*}:asyncBatchEmbedContent Mette in coda un batch di EmbedContent richieste per l'elaborazione batch. |
batchEmbedContents |
POST /v1beta/{model=models/*}:batchEmbedContents Genera più vettori di incorporamento dall'input Content, che consiste in un batch di stringhe rappresentate come oggetti EmbedContentRequest. |
batchGenerateContent |
POST /v1beta/{batch.model=models/*}:batchGenerateContent Mette in coda un batch di GenerateContent richieste per l'elaborazione batch. |
countTokens |
POST /v1beta/{model=models/*}:countTokens Esegue il tokenizer di un modello sull'input Content e restituisce il conteggio dei token. |
embedContent |
POST /v1beta/{model=models/*}:embedContent Genera un vettore di text embedding dall'input Content utilizzando il modello Gemini Embedding specificato. |
generateContent |
POST /v1beta/{model=models/*}:generateContent Genera una risposta del modello dato un input GenerateContentRequest. |
get |
GET /v1beta/{name=models/*} Recupera informazioni su un Model specifico, ad esempio il numero di versione, i limiti dei token, i parametri e altri metadati. |
list |
GET /v1beta/models Elenca i Model disponibili tramite l'API Gemini. |
predict |
POST /v1beta/{model=models/*}:predict Esegue una richiesta di previsione. |
predictLongRunning |
POST /v1beta/{model=models/*}:predictLongRunning Come Predict, ma restituisce un'operazione a lunga esecuzione. |
streamGenerateContent |
POST /v1beta/{model=models/*}:streamGenerateContent Genera una risposta in streaming dal modello dato un input GenerateContentRequest. |
Risorsa REST: v1beta.interactions
| Metodi | |
|---|---|
CreateCredential |
POST /v1beta/credentials Crea una credenziale. |
CreateInteraction |
POST /v1beta/interactions Crea una nuova interazione. |
cancelInteractionById |
POST /v1beta/interactions/{id}/cancel Annulla un'interazione in base all'ID. |
ListCredentials |
GET /v1beta/credentials Elenca le credenziali per un progetto. |
GetCredential |
GET /v1beta/credentials/{id} Recupera i metadati di una singola credenziale (nessun campo segreto). |
getInteractionById |
GET /v1beta/interactions/{id} Recupera i dettagli completi di una singola interazione in base al relativo `Interaction.id`. |
UpdateCredential |
PATCH /v1beta/credentials/{id} Aggiorna una credenziale. |
DeleteCredential |
DELETE /v1beta/credentials/{id} Elimina una credenziale. |
deleteInteraction |
DELETE /v1beta/interactions/{id} Elimina l'interazione per ID. |
Risorsa REST: v1beta.agents
| Metodi | |
|---|---|
CreateAgent |
POST /v1beta/agents Crea un nuovo agente (versione digitata per l'SDK). |
ListAgents |
GET /v1beta/agents Elenca tutti gli agenti. |
GetAgent |
GET /v1beta/agents/{id} Recupera un agente specifico. |
DeleteAgent |
DELETE /v1beta/agents/{id} Elimina un agente. |
Risorsa REST: v1beta.webhooks
| Metodi | |
|---|---|
CreateWebhook |
POST /v1beta/webhooks Crea un nuovo webhook. |
PingWebhook |
POST /v1beta/webhooks/{id}:ping Invia un evento ping a un webhook. |
RotateSigningSecret |
POST /v1beta/webhooks/{id}:rotateSigningSecret Genera un nuovo secret di firma per un webhook. |
ListWebhooks |
GET /v1beta/webhooks Elenca tutti i webhook. |
GetWebhook |
GET /v1beta/webhooks/{id} Recupera un webhook specifico. |
UpdateWebhook |
PATCH /v1beta/webhooks/{id} Aggiorna un webhook esistente. |
DeleteWebhook |
DELETE /v1beta/webhooks/{id} Elimina un webhook. |
Risorsa REST: v1beta.triggers
| Metodi | |
|---|---|
CreateTrigger |
POST /v1beta/triggers Crea un nuovo trigger che richiamerà l'agente specificato in base alla pianificazione cron indicata. |
RunTrigger |
POST /v1beta/triggers/{trigger_id}/executions Esegue immediatamente un trigger. |
ListTriggers |
GET /v1beta/triggers Elenca i trigger per un progetto. |
GetTrigger |
GET /v1beta/triggers/{id} Recupera i dettagli di un singolo trigger. |
ListTriggerExecutions |
GET /v1beta/triggers/{trigger_id}/executions Elenca le esecuzioni per un trigger. |
UpdateTrigger |
PATCH /v1beta/triggers/{id} Aggiorna un trigger. |
DeleteTrigger |
DELETE /v1beta/triggers/{id} Elimina un trigger. |
Risorsa REST: v1beta.environments
| Metodi | |
|---|---|
CreateEnvironment |
POST /v1beta/environments Crea un ambiente. |
ListEnvironments |
GET /v1beta/environments Elenca gli ambienti. |
GetEnvironmentFiles |
GET /v1beta/environments/{environment}/files/{path} Recupera i metadati dei file o i contenuti della directory dallo snapshot di un ambiente. |
GetEnvironment |
GET /v1beta/environments/{id} Recupera un ambiente. |
StartEnvironmentFileUpload |
PUT /upload/v1beta/environments/{environment}/files/{path} Avvia una sessione di caricamento ripristinabile per un file in uno spazio di lavoro dell'ambiente. |
DeleteEnvironment |
DELETE /v1beta/environments/{id} Elimina un ambiente. |