All methods

API Gemini

A API Gemini permite que os desenvolvedores criem aplicativos de IA generativa usando modelos do Gemini. O Gemini é nosso modelo mais avançado, criado desde o início para ser multimodal. Ele pode generalizar, entender, operar e combinar diferentes tipos de informações, incluindo idiomas, imagens, áudio, vídeo e código. Você pode usar a API Gemini para casos de uso como raciocínio em textos e imagens, geração de conteúdo, agentes de diálogo, sistemas de resumo e classificação e muito mais.

Serviço: generativelanguage.googleapis.com

Para chamar esse serviço, recomendamos que você use as bibliotecas de cliente fornecidas pelo Google. Caso o aplicativo precise usar bibliotecas próprias para chamar esse serviço, use as informações a seguir quando fizer as solicitações da API.

Endpoint de serviço

Um endpoint de serviço é um URL de base que especifica o endereço de rede de um serviço de API. Um serviço pode ter vários endpoints de serviço. Este serviço tem o endpoint a seguir, e todos os URIs abaixo são relativos a ele:

  • https://generativelanguage.googleapis.com

Recurso REST: v1beta.auth_tokens

Métodos
create POST /v1beta/auth_tokens
Cria um token que pode ser usado para restringir o comportamento de uma sessão BidiGenerateContent.

Recurso REST: v1beta.batches

Métodos
cancel POST /v1beta/{name=batches/*}:cancel
Inicia o cancelamento assíncrono de uma operação de longa duração.
delete DELETE /v1beta/{name=batches/*}
Exclui uma operação de longa duração.
get GET /v1beta/{name=batches/*}
Recebe o estado mais recente de uma operação de longa duração.
list GET /v1beta/{name=batches}
Lista as operações correspondentes ao filtro especificado na solicitação.
updateEmbedContentBatch PATCH /v1beta/{embedContentBatch.name=batches/*}:updateEmbedContentBatch
Atualiza um lote de solicitações EmbedContent para processamento em lote.
updateGenerateContentBatch PATCH /v1beta/{generateContentBatch.name=batches/*}:updateGenerateContentBatch
Atualiza um lote de solicitações GenerateContent para processamento em lote.

Recurso REST: v1beta.cachedContents

Métodos
create POST /v1beta/cachedContents
Cria um recurso CachedContent.
delete DELETE /v1beta/{name=cachedContents/*}
Exclui o recurso CachedContent.
get GET /v1beta/{name=cachedContents/*}
Lê o recurso CachedContent.
list GET /v1beta/cachedContents
Lista CachedContents.
patch PATCH /v1beta/{cachedContent.name=cachedContents/*}
Atualiza o recurso CachedContent. Somente o prazo de validade pode ser atualizado.

Recurso REST: v1beta.fileSearchStores

Métodos
create POST /v1beta/fileSearchStores
Cria um FileSearchStore vazio.
delete DELETE /v1beta/{name=fileSearchStores/*}
Exclui um FileSearchStore.
get GET /v1beta/{name=fileSearchStores/*}
Recebe informações sobre um FileSearchStore específico.
importFile POST /v1beta/{fileSearchStoreName=fileSearchStores/*}:importFile
Importa um File do serviço de arquivos para um FileSearchStore.
list GET /v1beta/fileSearchStores
Lista todos os FileSearchStores pertencentes ao usuário.

Recurso REST: v1beta.fileSearchStores.documents

Métodos
delete DELETE /v1beta/{name=fileSearchStores/*/documents/*}
Exclui um Document.
get GET /v1beta/{name=fileSearchStores/*/documents/*}
Recebe informações sobre um Document específico.
list GET /v1beta/{parent=fileSearchStores/*}/documents
Lista todos os Documents em um Corpus.

Recurso REST: v1beta.fileSearchStores.operations

Métodos
get GET /v1beta/{name=fileSearchStores/*/operations/*}
Recebe o estado mais recente de uma operação de longa duração.

Recurso REST: v1beta.fileSearchStores.upload.operations

Métodos
get GET /v1beta/{name=fileSearchStores/*/upload/operations/*}
Recebe o estado mais recente de uma operação de longa duração.

Recurso REST: v1beta.files

Métodos
delete DELETE /v1beta/{name=files/*}
Exclui o File.
get GET /v1beta/{name=files/*}
Recebe os metadados do File especificado.
list GET /v1beta/files
Lista os metadados dos Files pertencentes ao projeto solicitante.
register POST /v1beta/files:register
Registra arquivos do Google Cloud Storage com o FileService.

Recurso REST: v1beta.media

Métodos
download GET /v1beta/{parent=environments/*}/files
Recupera metadados de arquivos ou conteúdo de diretórios de um snapshot do ambiente.
upload POST /v1beta/files
POST /upload/v1beta/files
Cria um File.
uploadToFileSearchStore POST /v1beta/{fileSearchStoreName=fileSearchStores/*}:uploadToFileSearchStore
POST /upload/v1beta/{fileSearchStoreName=fileSearchStores/*}:uploadToFileSearchStore
Faz upload de dados para um FileSearchStore, pré-processa e divide em partes antes de armazenar em um documento do FileSearchStore.

Recurso REST: v1beta.models

Métodos
asyncBatchEmbedContent POST /v1beta/{batch.model=models/*}:asyncBatchEmbedContent
Enfileira um lote de solicitações EmbedContent para processamento em lote.
batchEmbedContents POST /v1beta/{model=models/*}:batchEmbedContents
Gera vários vetores de embedding da entrada Content, que consiste em um lote de strings representadas como objetos EmbedContentRequest.
batchGenerateContent POST /v1beta/{batch.model=models/*}:batchGenerateContent
Enfileira um lote de solicitações GenerateContent para processamento em lote.
countTokens POST /v1beta/{model=models/*}:countTokens
Executa o tokenizador de um modelo na entrada Content e retorna a contagem de tokens.
embedContent POST /v1beta/{model=models/*}:embedContent
Gera um vetor de embedding de texto da Content de entrada usando o modelo de embedding do Gemini especificado.
generateContent POST /v1beta/{model=models/*}:generateContent
Gera uma resposta do modelo com base em uma entrada GenerateContentRequest.
get GET /v1beta/{name=models/*}
Recebe informações sobre um Model específico, como número da versão, limites de token, parâmetros e outros metadados.
list GET /v1beta/models
Lista os Models disponíveis na API Gemini.
predict POST /v1beta/{model=models/*}:predict
Executa uma solicitação de previsão.
predictLongRunning POST /v1beta/{model=models/*}:predictLongRunning
Igual a "Predict", mas retorna um LRO.
streamGenerateContent POST /v1beta/{model=models/*}:streamGenerateContent
Gera uma resposta transmitida do modelo com base em uma entrada GenerateContentRequest.

Recurso REST: v1beta.interactions

Métodos
CreateCredential POST /v1beta/credentials
Cria uma credencial.
CreateInteraction POST /v1beta/interactions
Cria uma nova interação.
cancelInteractionById POST /v1beta/interactions/{id}/cancel
Cancela uma interação por ID.
ListCredentials GET /v1beta/credentials
Lista as credenciais de um projeto.
GetCredential GET /v1beta/credentials/{id}
Recebe metadados de uma única credencial (sem campos secretos).
getInteractionById GET /v1beta/interactions/{id}
Recupera todos os detalhes de uma única interação com base no `Interaction.id`.
UpdateCredential PATCH /v1beta/credentials/{id}
Atualiza uma credencial.
DeleteCredential DELETE /v1beta/credentials/{id}
Exclui uma credencial.
deleteInteraction DELETE /v1beta/interactions/{id}
Exclui a interação por ID.

Recurso REST: v1beta.agents

Métodos
CreateAgent POST /v1beta/agents
Cria um novo agente (versão tipada para SDK).
ListAgents GET /v1beta/agents
Lista todos os agentes.
GetAgent GET /v1beta/agents/{id}
Recebe um agente específico.
DeleteAgent DELETE /v1beta/agents/{id}
Exclui um agente.

Recurso REST: v1beta.webhooks

Métodos
CreateWebhook POST /v1beta/webhooks
Cria um webhook.
PingWebhook POST /v1beta/webhooks/{id}:ping
Envia um evento de ping para um webhook.
RotateSigningSecret POST /v1beta/webhooks/{id}:rotateSigningSecret
Gera um novo secret de assinatura para um webhook.
ListWebhooks GET /v1beta/webhooks
Lista todos os webhooks.
GetWebhook GET /v1beta/webhooks/{id}
Recebe um webhook específico.
UpdateWebhook PATCH /v1beta/webhooks/{id}
Atualiza um webhook existente.
DeleteWebhook DELETE /v1beta/webhooks/{id}
Exclui um webhook.

Recurso REST: v1beta.triggers

Métodos
CreateTrigger POST /v1beta/triggers
Cria um gatilho que vai invocar o agente especificado na programação cron fornecida.
RunTrigger POST /v1beta/triggers/{trigger_id}/executions
Executa um gatilho imediatamente.
ListTriggers GET /v1beta/triggers
Lista os gatilhos de um projeto.
GetTrigger GET /v1beta/triggers/{id}
Recebe detalhes de um único gatilho.
ListTriggerExecutions GET /v1beta/triggers/{trigger_id}/executions
Lista as execuções de um acionador.
UpdateTrigger PATCH /v1beta/triggers/{id}
Atualiza um gatilho.
DeleteTrigger DELETE /v1beta/triggers/{id}
Exclui um gatilho.

Recurso REST: v1beta.environments

Métodos
CreateEnvironment POST /v1beta/environments
Cria um ambiente.
ListEnvironments GET /v1beta/environments
Lista os ambientes.
GetEnvironmentFiles GET /v1beta/environments/{environment}/files/{path}
Recupera metadados de arquivos ou conteúdo de diretórios de um snapshot do ambiente.
GetEnvironment GET /v1beta/environments/{id}
Recebe um ambiente.
StartEnvironmentFileUpload PUT /upload/v1beta/environments/{environment}/files/{path}
Inicia uma sessão de upload retomável para um arquivo em um espaço de trabalho de ambiente.
DeleteEnvironment DELETE /v1beta/environments/{id}
Exclui um ambiente.