Google Gen AI Python SDK: configurações de proxy síncronas e assíncronas

Para um proxy HTTP comum, forneça o ambiente de inicialização compartilhado documentado antes de criar o cliente:

HTTPS_PROXY='http://proxy.example:8080' python app.py

Mantenha as credenciais normais de chave de API e de nuvem. O ouvinte HTTP pode transportar destinos HTTPS.

Para o caminho HTTPX SOCKS documentado, com o suporte presente, configure os dois conjuntos de opções:

from google import genai
from google.genai import types

options = types.HttpOptions(
    client_args={'proxy': 'socks5://proxy.example:1080'},
    async_client_args={'proxy': 'socks5://proxy.example:1080'},
)
client = genai.Client(api_key=api_key, http_options=options)

Quando este caminho HTTPX SOCKS pode usar um intermediário público, a lista de proxies SOCKS5 oferece candidatos para os dois URLs de proxy. Mantenha o cliente e feche-o durante sua carga de trabalho. Apenas client_args não seleciona o caminho assíncrono.

O backend aiohttp opcional pode encarregar-se das chamadas assíncronas. Seus protocolos de proxy e argumentos de requisição são diferentes; use a escolha suportada pelo SDK instalado de um transporte assíncrono ou cliente HTTPX compatível, em vez de supor que as opções do HTTPX configuram o aiohttp.

Rotule a operação falhada por síncrona/assíncrona, backend e protocolo de proxy. O sucesso em um caminho só comprova esse caminho.