Importar uma API do Google Gemini compatível com OpenAI

APLICA-SE A: Todas as camadas de gerenciamento de API

Este artigo mostra como importar uma API do Google Gemini compatível com OpenAI para acessar modelos como gemini-2.0-flash. Para esses modelos, a Gestão de API do Azure pode administrar um endpoint de conclusão de chat compatível com OpenAI.

Saiba mais sobre como gerenciar APIs de IA no Gerenciamento de API:

• Funcionalidades de gateway de IA na Gestão de API do Azure
• Importar uma API de modelo de idioma

Pré-requisitos

• Uma instância de gerenciamento de API existente. Crie um, caso ainda não o tenha feito.
• Uma chave de API para a API do Gemini. Se você não tiver um, crie-o no Google AI Studio e armazene-o em um local seguro.

Importe uma API Gemini compatível com OpenAI usando o portal

1. No portal do Azure, navegue até sua instância de Gerenciamento de API.

2. No menu à esquerda, em APIs, selecione APIs>+ Add API.

3. Em Definir uma nova API, selecione Language Model API.

   

4. Na aba Configurar API:

   1. Insira um Nome para exibição e uma Descrição opcional para a API.

   2. Em URL, insira o seguinte URL base da documentação de compatibilidade do Gemini OpenAI: https://generativelanguage.googleapis.com/v1beta/openai

   3. Em Path, acrescente um caminho que sua instância de Gerenciamento de API usa para rotear solicitações para os pontos de extremidade da API do Gemini.

   4. Em Tipo, selecione Criar API OpenAI.

   5. Em Chave de acesso, insira o seguinte:

      1. Nome do cabeçalho: Autorização.
      2. Valor do cabeçalho (chave):Bearer seguido pela sua chave de API para a API do Gemini.

   

5. Nas guias restantes, opcionalmente, configure políticas para gerenciar o consumo de tokens, cache semântico e segurança de conteúdo de IA. Para obter detalhes, consulte Importar uma API de modelo de idioma.

6. Selecione Revisão.

7. Depois que as configurações forem validadas, selecione Criar.

O Gerenciamento de API cria a API e configura o seguinte:

• Um recurso de back-end e uma política de definição de serviço de back-end que direcionam as solicitações de API para o ponto de acesso do Google Gemini.
• Acesso ao back-end LLM usando a chave de API Gemini que você forneceu. A chave é protegida como um valor nomeado secreto no Gerenciamento de API.
• (opcionalmente) Políticas para ajudá-lo a monitorar e gerenciar a API.

Teste o modelo Gemini

Depois de importar a API, pode-se testar o endpoint de conclusões de chat da API.

1. Selecione a API que você criou na etapa anterior.

2. Selecione a guia Teste .

3. Selecione a POST Creates a model response for the given chat conversation operação, que é um POST pedido para o /chat/completions endpoint.

4. Na seção Corpo da solicitação , insira o JSON a seguir para especificar o modelo e um prompt de exemplo. Neste exemplo, o gemini-2.0-flash modelo é usado.

   {
       "model": "gemini-2.0-flash",
       "messages": [
           {
               "role": "system",
               "content": "You are a helpful assistant"
           },
           {
               "role": "user",
               "content": "How are you?"
           }
       ],
       "max_tokens": 50
   }
   

   Quando o teste é bem-sucedido, o back-end responde com um código de resposta HTTP bem-sucedido e alguns dados. Anexados à resposta estão dados de uso de token para ajudá-lo a monitorar e gerenciar o consumo de token do modelo de idioma.

   

Conteúdo relacionado

• Funcionalidades de gateway de IA na Gestão de API do Azure