AIstudioProxyAPI: uso ilimitado das APIs do modelo Gemini 2.5 Pro

Introdução geral

O AIstudioProxyAPI é um projeto de código aberto que usa a tecnologia Node.js e Playwright para emular a API OpenAI, simulando o Estúdio de IA do Google baseado na web Gêmeos em uma interface de API padrão. Os desenvolvedores podem usar esse serviço de proxy para fornecer aos clientes que suportam a API do OpenAI (por exemplo, Open WebUI, NextChat) acesso direto à API do Google Estúdio de IA A quantidade ilimitada de recursos. O projeto não requer configuração complexa e é adequado para desenvolvedores que desejam integrar rapidamente os recursos do Google AI Studio. O projeto atual é mantido pessoalmente, é atualizado com pouca frequência e não oferece suporte ao modo sem cabeça, portanto, você precisa garantir manualmente que a porta de depuração do Chrome esteja disponível.

Lista de funções

• oferta /v1/chat/completions responder cantando /v1/models compatíveis com o cliente da API OpenAI.
• Suporte à resposta de streaming (stream=true) para obter o efeito de máquina de escrever.
• Suporte para respostas sem fluxo (stream=false), que retorna o JSON completo de uma só vez.
• Otimize automaticamente os prompts de entrada do usuário e adapte o formato de saída do Google AI Studio.
• Inicia e se conecta automaticamente à instância do Chrome, define a porta de depuração e o tamanho da janela.
• Fornece opções interativas para lidar com conflitos de porta ou conectar-se a uma instância existente do Chrome.

Usando a Ajuda

Processo de instalação

A implantação do AIstudioProxyAPI é simples, mas você precisa ter certeza de que seu ambiente está configurado corretamente. Veja a seguir as etapas detalhadas:

1. armazém de clones
   Execute o seguinte comando no terminal para obter o código do projeto:

   git clone https://github.com/CJackHwang/AIstudioProxyAPI
   cd AIstudioProxyAPI

2. Instalação de dependências
   Dependências do projeto express, cors, playwright responder cantando @playwright/test. Escolha um dos seguintes comandos, dependendo do seu gerenciador de pacotes:

   npm install
   # 或
   yarn install
   # 或
   pnpm install
   

   Após a conclusão da instalação, a dependência é configurada automaticamente para que@playwright/test Fornece funcionalidade de asserção.

3. Início dos serviços
   Execute o seguinte comando para iniciar o serviço do agente:

   node auto_connect_aistudio.cjs
   

   O script irá:

   • Verifique se a dependência está completa.
   • Verificar a porta de depuração do Chrome (padrão) 8848), seja ele gratuito ou não.
   • Definição do tamanho da janela do Chrome (largura padrão) 460px).
   • Inicie automaticamente o Chrome e abra a página do Google AI Studio.

   Se a porta estiver ocupada, o script solicitará a opção de conectar-se a uma instância existente do Chrome ou limpar a porta e tentar novamente. Certifique-se de fazer login manualmente na página do Google AI Studio para concluir a autenticação.

Uso das funções principais

A essência do AIstudioProxyAPI é disponibilizar os recursos do modelo Gemini do Google AI Studio aos clientes por meio de uma interface compatível com a API OpenAI. Veja como ele funciona:

1. Configuração do cliente
   Em clientes compatíveis com a API OpenAI (como a Open WebUI), defina o endereço da API como o endereço do serviço de proxy (padrão) http://localhost:2048). Não há necessidade de alterar o código do cliente, pois as interfaces são totalmente compatíveis.
2. Enviar uma solicitação de diálogo
   Use o cliente para enviar solicitações de diálogo no mesmo formato que a API do OpenAI. Exemplo:

   {
   "model": "gemini",
   "messages": [
   {"role": "system", "content": "你是一个助手"},
   {"role": "user", "content": "请解释量子力学"}
   ],
   "stream": true
   }
   

   • configurar stream=true Obtenha respostas em fluxo contínuo, adequadas para diálogos em tempo real.
   • configurar stream=false Obtenha a resposta JSON completa, adequada para processamento único.
3. Otimizar palavras de alerta
   O serviço de proxy agrupa automaticamente a entrada do usuário, adicionando tags específicas (como <<<START_RESPONSE>>>) para garantir que a saída do Google AI Studio esteja no formato esperado. Os desenvolvedores não precisam ajustar manualmente as palavras-chave.
4. Gerenciando instâncias do Chrome
   Após a inicialização, a janela do Chrome deve permanecer aberta e a página do Google AI Studio não deve travar. Se a página não estiver respondendo, feche todos os processos relacionados (node responder cantando chrome), execute novamente o node auto_connect_aistudio.cjs.

Operação da função em destaque

• resposta de streamingConfiguração no lado do cliente stream=trueA resposta é exibida literalmente com um efeito de máquina de escrever, adequado para aplicativos interativos.
• Tratamento de conflitos de portasO script detecta 8848 Quando a porta está ocupada, o usuário é solicitado a escolher entre conectar-se a uma instância existente do Chrome ou limpar a porta.
• Redimensionamento da janela: Se 460px A largura não se ajusta ao monitor, mas pode ser modificada auto_connect_aistudio.cjs acertou em cheio --window-size Parâmetros.

Solução de problemas

• Falha no carregamento da páginaVerifique a conexão de rede e tente acessá-la manualmente https://aistudio.google.com/prompts/new_chat e faça login.
• ocupação do porto: Executar lsof -i :2048 Verificar programas de ocupação, fechar ou alterar server.cjs acertou em cheio SERVER_PORT.
• O dramaturgo não está pronto.Verifique se a janela do Chrome não está fechada e execute novamente o script de inicialização.

cenário do aplicativo

1. Integração rápida de recursos de diálogo de IA
   Os desenvolvedores desejam adicionar a funcionalidade de diálogo de IA aos seus aplicativos, mas estão limitados pela cota da API OpenAI. O aIstudioProxyAPI permite que os desenvolvedores aproveitem a cota gratuita do Google AI Studio para implementar rapidamente a funcionalidade por meio da interface familiar da API OpenAI.
2. Desenvolvimento e testes locais
   As equipes de desenvolvimento podem emular a API OpenAI por meio do AIstudioProxyAPI ao testar a funcionalidade de diálogo de IA em seus ambientes locais, eliminando a necessidade de adquirir cotas adicionais de API e reduzindo os custos.
3. Educação e pesquisa
   Estudantes ou pesquisadores precisam fazer experiências com recursos de diálogo de modelos grandes, mas não têm acesso à API. O AIstudioProxyAPI fornece acesso fácil aos modelos Gemini para pesquisas acadêmicas.

QA

1. Quais clientes são compatíveis com o AIstudioProxyAPI?
   Qualquer cliente compatível com a API do OpenAI (por exemplo, Open WebUI, NextChat) pode ser usado sem modificar o código do cliente.
2. Por que o modo sem cabeça não é compatível?
   A detecção automatizada do Google AI Studio restringe o modo sem cabeça a uma instância do Chrome com interface.
3. Como lidar com portos ocupados?
   sonda 2048 talvez 8848 ocupação de portos, encerrar programas conflitantes ou modificar server.cjs A configuração da porta no
4. O serviço exige uma rede contínua?
   Sim, o serviço de proxy requer acesso à Internet para a página do Google AI Studio para garantir que a página seja carregada corretamente.