Guias

Com a API já funcionando, encontre o guia correspondente ao que você quer fazer. Cada guia traz exemplos executáveis; os protocolos cobertos estão indicados em cada página.

Recursos básicos

Como o modelo responde: saída progressiva, chamada das suas funções, formato fixo e leitura de imagens.

Quero…	Guia	Pontos principais
Exibir a resposta à medida que é gerada, sem esperar o texto completo	Streaming	Envio via SSE; inclui reconexão e function calling em streaming
Fazer o modelo chamar minhas funções ou APIs externas	Function Calling	Defina `tools`; suporta chamadas paralelas e `tool_choice`
Obter a saída sempre em JSON	Saída estruturada	JSON Mode e restrições com JSON Schema
Fazer o modelo analisar imagens	Compreensão visual	URL ou Base64 da imagem; permite comparar várias imagens

Custo e estabilidade

Gastar menos com as mesmas requisições e não parar quando algo dá errado.

Quero…	Guia	Pontos principais
Reduzir o custo de prompts longos enviados repetidamente	Cache de prompt	Cache de prefixos repetidos, menor custo de tokens e latência
Reutilizar um contexto extenso do Gemini entre requisições	Cache explícito do Gemini	Crie e referencie cachedContents ativamente, com acertos mais previsíveis
Escolher qual provedor processa a requisição	Roteamento de provedores	Roteamento automático por padrão; use `provider.type` quando necessário
Trocar automaticamente para um modelo reserva quando o principal falha	Failover	`provider.fallback`, até 3 modelos reserva

Quando algo falha

Quando uma requisição falha, é limitada ou bloqueada, comece por aqui.

Situação	Guia	Pontos principais
Recebi um erro e quero saber como tratá-lo e se devo tentar novamente	Erros e novas tentativas	Códigos de status, formato de erro, backoff exponencial e timeouts
429 Too Many Requests	Limites de taxa	Padrão de 100 RPM, somado por equipe; leia os cabeçalhos da resposta para saber quanto esperar
Requisição bloqueada ou suspensa pela segurança de conteúdo	Segurança de conteúdo	Regras de acionamento, duração da suspensão e como recuperar o acesso

SDKs e frameworks

Integre via código com SDKs ou frameworks prontos; em todos os casos, basta alterar o endereço da API e a Key.

Estou usando…	Guia
SDK oficial da OpenAI (migrar um projeto existente)	OpenAI SDK
LangChain	LangChain
LlamaIndex	LlamaIndex