Skip to main content
O Google Gemini é um sistema de diálogo AI muito poderoso, que pode gerar respostas fluídas 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 de Conclusão de Chat Gemini, permitindo que utilizemos facilmente a funcionalidade de diálogo oficial do Gemini.

Processo de Solicitação

Para usar a API de Conclusão de Chat Gemini, primeiro acesse o Painel de Controle da Ace Data Cloud para obter seu Token de API, que deve ser guardado para uso futuro. Se você ainda não estiver logado ou registrado, será redirecionado automaticamente para a página de login, onde será convidado a se registrar e fazer login. Após a conclusão, você será redirecionado de volta para esta página. Um Token de API é suficiente para acessar todos os serviços da plataforma, não sendo necessário solicitar individualmente para cada serviço. A primeira solicitação oferece um crédito gratuito para que você possa experimentar; quando o crédito acabar, você pode recarregar o saldo geral no painel de controle.
📘 Documentação Completa: API de Conclusão de Chat Gemini →

Uso Básico

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

Na primeira vez que usar esta interface, você precisará preencher pelo menos três campos: um é authorization, que pode ser selecionado diretamente na lista suspensa. O outro parâmetro é model, que é a categoria do modelo que escolhemos usar do site do Gemini; aqui temos principalmente 6 tipos de modelos, e você pode ver os detalhes dos modelos que fornecemos. O último parâmetro é messages, que é um array de palavras-chave que inserimos, representando a possibilidade de enviar várias palavras-chave ao mesmo tempo, onde cada palavra-chave contém role e content, sendo que role representa o papel do questionador, e oferecemos três identidades: user, assistant, 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, que você pode copiar e executar diretamente, ou pode clicar no botão “Try” para testar.

Dica: A série gemini-3.x flash é um modelo de raciocínio que consumirá tokens de raciocínio primeiro; defina max_tokens para 512 ou mais, caso contrário, pode retornar apenas conteúdo vazio. O gemini-3.6-flash é o modelo Flash atualmente recomendado, suportando até 1 milhão de tokens de contexto, entrada de imagem, chamadas de ferramentas e respostas em fluxo; atualmente acessado através da interface de Conclusões de Chat.
Após a chamada, encontramos o resultado retornado como segue:
O resultado retornado contém vários campos, descritos a seguir:
  • id, o ID da tarefa de diálogo gerada, 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 interação.
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.

Compreensão de Imagens (Entrada Multimodal)

O Gemini é um modelo multimodal nativo, capaz de “ver imagens” diretamente. Para enviar uma imagem, basta alterar o content de uma mensagem de string para um array de blocos de conteúdo, onde você coloca simultaneamente blocos de text e image_url — isso é totalmente compatível com o formato da OpenAI e do Gemini oficial. image_url.url suporta duas formas de escrita:
  • base64 data: URI (recomendado, mais estável): o formato é data:<tipo de mídia>;base64,<dados>, por exemplo, data:image/jpeg;base64,/9j/4AAQ.... O tipo de mídia (MIME) já está escrito no prefixo data:, portanto, não é necessário, nem existe um campo media_type separado.
  • URL de imagem acessível publicamente: por exemplo, https://cdn.acedata.cloud/4hfydw.jpg.
Tipos de imagem suportados: png, jpeg, webp, heic, heif. Exemplo de código de chamada em Python (base64 data URI):
Você também pode passar diretamente uma URL de imagem acessível publicamente:
💡 image_url aceita apenas o campo url (o valor pode ser uma URL de imagem ou um URI de dados base64 data:), além do campo opcional detail. Não passe media_type — isso é um campo de imagem do Anthropic Claude, que não pertence ao formato image_url do OpenAI / Gemini.

Resposta em fluxo

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

Depois de alterar stream para true, a API retornará os dados JSON 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 resultado é o seguinte:
Como pode ser visto, a resposta contém muitos data, e o choices dentro de data é o conteúdo da resposta mais recente, consistente com o que foi apresentado anteriormente. choices é o conteúdo da nova resposta, que você pode integrar ao seu sistema. Além disso, o término 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 contém vários campos, conforme descrito a seguir:
  • id,gerar o ID da tarefa de diálogo atual, 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 para a pergunta.
JavaScript também é suportado, por exemplo, o código de chamada em fluxo do Node.js é o seguinte:
Exemplo de código em Java:
Outras linguagens podem ser reescritas de forma semelhante, o princípio é o mesmo.

Diálogo em múltiplas rodadas

Se você deseja integrar a funcionalidade de diálogo em múltiplas rodadas, é necessário enviar múltiplas perguntas no campo messages, exemplos específicos de múltiplas perguntas são mostrados na imagem abaixo:

Exemplo de código de chamada em Python:
Ao enviar múltiplas perguntas, você pode facilmente realizar diálogos em múltiplas rodadas e obter respostas como a seguinte:
Pode-se ver que as informações contidas em choices são consistentes com o conteúdo do uso básico, que inclui as respostas específicas do Gemini para múltiplos diálogos, permitindo assim responder às perguntas correspondentes com base no conteúdo de múltiplos diálogos.

Modelo multimodal Gemini-3.0

Exemplo de solicitação:
Exemplo de resultado:
Claro, você também pode enviar links de vídeo, o input específico é o seguinte:
Exemplo de resultado:
Como pode ser visto, o modelo Gemini 3.0 pode suportar compreensão multimodal.

Gemini-3.1 Modelo Multimodal

gemini-3.1-pro-preview é o ID oficial do modelo Gemini 3.1 Pro, que suporta entradas multimodais como texto, imagem e vídeo, adequado para tarefas complexas de raciocínio, codificação e compreensão. Exemplo de solicitação:
O Gemini 3.1 Pro também suporta compreensão de vídeo:
O formato de retorno é consistente com o Gemini 3.0 Pro, conforme descrito na seção acima sobre o modelo multimodal Gemini-3.0.

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 de Conclusão de Chat do Gemini 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, sinta-se à vontade para entrar em contato com nossa equipe de suporte técnico.