Skip to main content
Google Gemini é um sistema de diálogo AI muito poderoso, que pode gerar respostas fluentes e naturais em apenas alguns segundos ao inserir palavras-chave. O Gemini pode fornecer assistência inteligente impressionante, aumentando significativamente a eficiência e a criatividade do trabalho humano. Este documento descreve principalmente o processo de uso da API Gemini Chat Completion, que nos permite usar facilmente a funcionalidade de diálogo oficial do Gemini.

Processo de Solicitação

Para usar a API Gemini Chat Completion, primeiro você pode acessar a página Gemini Chat Completion API e clicar no botão “Adquirir” para obter as credenciais necessárias para a solicitação: Se você ainda não estiver logado ou registrado, será redirecionado automaticamente para a página de login, convidando-o a se registrar e fazer login. Após o registro e login, você será automaticamente retornado à página atual. Na primeira solicitação, haverá um crédito gratuito disponível, permitindo o uso gratuito dessa API.

Uso Básico

Em seguida, você pode preencher o conteúdo correspondente na interface, como mostrado na imagem:

Na primeira vez que usar essa interface, precisamos preencher pelo menos três conteúdos: um é authorization, que pode ser selecionado diretamente na lista suspensa. O outro parâmetro é model, que é a categoria do modelo que escolhemos usar no site do Gemini; aqui temos principalmente 6 tipos de modelos, e os detalhes podem ser vistos nos modelos que fornecemos. O último parâmetro é messages, que é um array de palavras-chave que inserimos; é um array que permite o upload simultâneo de várias palavras-chave, onde cada palavra-chave contém role e content, sendo que role representa o papel do questionador, e oferecemos três identidades: user, assistant e system. O outro content é o conteúdo específico da nossa pergunta. Você também pode notar que há um código de chamada correspondente gerado à direita; você pode copiar o código e executá-lo diretamente ou clicar no botão “Experimente” para testar.

Após a chamada, descobrimos que o resultado retornado é o seguinte:
O resultado retornado contém vários campos, descritos a seguir:
  • id, o ID gerado para esta tarefa de diálogo, usado para identificar exclusivamente esta tarefa de diálogo.
  • model, o modelo do site do Gemini escolhido.
  • choices, as informações de resposta fornecidas pelo Gemini para as palavras-chave.
  • usage: informações estatísticas sobre os tokens usados nesta pergunta e resposta.
Entre eles, choices contém as informações de resposta do Gemini, onde choices é a informação específica da resposta do Gemini, como mostrado na imagem.

Pode-se ver que o campo content dentro de choices contém o conteúdo específico da resposta do Gemini.

Resposta em Fluxo

Esta interface também suporta resposta em fluxo, o que é muito útil para integração em páginas da web, permitindo que a página exiba o efeito de exibição palavra por palavra. Se você deseja retornar a resposta em fluxo, pode alterar o parâmetro stream no cabeçalho da solicitação para true. A modificação é mostrada na imagem, mas o código de chamada precisa ter as alterações correspondentes para suportar a resposta em fluxo.

Após alterar stream para true, a API retornará os dados JSON correspondentes linha por linha, e no nível do código, precisamos fazer as modificações necessárias para obter os resultados linha por linha. Exemplo de código de chamada em Python:
O efeito de saída é o seguinte:
Pode-se ver que a resposta contém muitos data, onde data contém as choices, que são o conteúdo da resposta mais recente, consistente com o conteúdo apresentado anteriormente. choices é o novo conteúdo da resposta, que você pode integrar ao seu sistema. O fim da resposta em fluxo é determinado pelo conteúdo de data; se o conteúdo for [DONE], isso indica que a resposta em fluxo foi completamente encerrada. O resultado retornado de data possui vários campos, conforme descrito a seguir:
  • id, o ID gerado para esta tarefa de diálogo, usado para identificar exclusivamente esta tarefa de diálogo.
  • model, o modelo escolhido do site oficial do Gemini.
  • choices, as informações de resposta fornecidas pelo Gemini em relação à consulta.
JavaScript também é suportado, como mostrado no código de chamada em fluxo para Node.js abaixo:
Exemplo de código em Java:
Outras linguagens podem ser adaptadas conforme necessário, o princípio é o mesmo.

Diálogo em Múltiplas Rodadas

Se você deseja integrar a funcionalidade de diálogo em múltiplas rodadas, precisa enviar vários termos de consulta no campo messages, com exemplos específicos mostrados na imagem abaixo:

Exemplo de código em Python:
Ao enviar vários termos de consulta, você pode facilmente implementar diálogos em múltiplas rodadas e obter respostas como a seguinte:
Pode-se ver que choices contém informações consistentes com o conteúdo básico utilizado, que inclui o conteúdo específico das respostas do Gemini para múltiplos diálogos, permitindo assim responder às perguntas correspondentes com base em múltiplos conteúdos de diálogo.

Modelo Multimodal Gemini-3.0

Exemplo de solicitação:
Exemplo de resultado:
Claro, você também pode enviar links de vídeos, o input específico é o seguinte:
Exemplo de resultado:
A partir do acima, pode-se ver que o modelo Gemini 3.0 pode suportar a compreensão multimodal.

Modelo Multimodal Gemini-3.1

O Gemini 3.1 Pro é a versão atualizada do Gemini 3.0 Pro, com o modelo subjacente sendo gemini-3.1-pro-preview, que também suporta entradas multimodais como texto, imagem e vídeo, possuindo uma capacidade de raciocínio e compreensão mais forte. A forma de uso é idêntica à do Gemini 3.0 Pro, basta substituir o parâmetro model por gemini-3.1-pro. Exemplo de solicitação:
O Gemini 3.1 Pro também suporta a compreensão de vídeos:
O formato de retorno é o mesmo do Gemini 3.0 Pro, conforme descrito na seção do modelo multimodal Gemini-3.0 acima.

Tratamento de Erros

Ao chamar a API, se ocorrer um erro, a API retornará o código de erro e a mensagem correspondente. Por exemplo:
  • 400 token_mismatched: Solicitação inválida, possivelmente devido a parâmetros ausentes ou inválidos.
  • 400 api_not_implemented: Solicitação inválida, possivelmente devido a parâmetros ausentes ou inválidos.
  • 401 invalid_token: Não autorizado, token de autorização inválido ou ausente.
  • 429 too_many_requests: Muitas solicitações, você excedeu o limite de taxa.
  • 500 api_error: Erro interno do servidor, algo deu errado no servidor.

Exemplo de Resposta de Erro

Conclusão

Através deste documento, você já entendeu como usar a API Gemini Chat Completion para implementar facilmente a funcionalidade de conversa do Gemini oficial. Esperamos que este documento possa ajudá-lo a integrar e usar melhor essa API. Se tiver alguma dúvida, entre em contato com nossa equipe de suporte técnico.