Regioes

O Floopy roda em mais de uma regiao geografica para que as requisicoes sejam respondidas perto dos seus usuarios. O endpoint que voce chama decide qual regiao atende a requisicao — os dados que sua conta armazena nunca saem da Europa.

Endpoints disponiveis

Endpoint	Comportamento
`https://api.floopy.ai`	Padrao. Escolhe a regiao saudavel mais proxima a cada requisicao com base na origem da chamada. Recomendado para trafego de producao.
`https://api-eu.floopy.ai`	Sempre atendido pela regiao europeia. Use quando precisar de um destino fixo e estavel.
`https://api-br.floopy.ai`	Sempre atendido pela regiao brasileira. Use quando precisar de um destino fixo e estavel.

Os tres endpoints aceitam as mesmas requisicoes compativeis com OpenAI, retornam os mesmos formatos de resposta e respeitam as mesmas chaves de API. Apontar seu cliente para qualquer um deles e uma mudanca de uma linha na sua baseURL.

Como o endpoint padrao escolhe uma regiao

Quando voce chama https://api.floopy.ai, a camada de roteamento olha a origem de rede da requisicao e a encaminha para a regiao mais proxima em termos de distancia de rede. Se uma regiao estiver indisponivel, as requisicoes fazem failover automaticamente para a outra — sem alteracao do seu lado.

Essa selecao acontece por requisicao. Em principio, chamadas de um mesmo cliente podem cair em regioes diferentes ao longo do tempo (por exemplo, se o cliente trocar de rede ou se uma regiao estiver brevemente fora do ar). Para direcionamento deterministico, use um dos endpoints fixos acima.

Residencia de dados

Os dados da sua conta — logs de requisicoes, traces, organizacoes, projetos, chaves de API, cobranca — ficam armazenados apenas no nosso armazenamento europeu, independentemente da regiao que atendeu a requisicao. A regiao brasileira mantem apenas estado efemero, por requisicao, necessario para responder a chamada.

Isso significa que:

Uma requisicao atendida por api-br.floopy.ai e registrada no mesmo armazenamento europeu que uma atendida por api-eu.floopy.ai. As duas regioes compartilham dashboards, trilhas de auditoria, agregados de cobranca e exportacoes.
As garantias de conformidade e retencao do armazenamento valem de forma uniforme. Trocar de regiao nao move dados historicos para nenhum lugar novo.
A regiao que atendeu cada requisicao fica registrada na linha do log, para voce filtrar analises por regiao depois.

Caches sao por regiao

Cada regiao mantem seus proprios caches de resposta e de embeddings. A primeira requisicao para uma dada entrada em uma regiao que voce nao usa ha algum tempo pode ser um pouco mais lenta que um hit de cache — a resposta e a mesma, so o tempo muda. Apos o cache aquecer, chamadas seguintes dentro da mesma regiao voltam a ter os ganhos de cache usuais.

Se voce mover uma carga entre api-eu.floopy.ai e api-br.floopy.ai, espere um periodo similar de aquecimento na nova regiao.

Quando usar cada endpoint

api.floopy.ai — Escolha esse por padrao. Minimiza latencia sem prender voce a uma regiao.
api-eu.floopy.ai / api-br.floopy.ai — Escolha um endpoint fixo quando:
- Voce esta medindo latencia a partir de uma origem especifica.
- Voce precisa de um destino estavel para um runbook de resposta a incidente.
- Voce esta fazendo A/B do comportamento regional ou medindo o aquecimento de cache.

Comportamento de failover

Se a regiao mais proxima ficar indisponivel, api.floopy.ai roteia automaticamente novas requisicoes para a outra regiao. Requisicoes em andamento nao sao migradas — elas terminam ou retornam erro da regiao original. Quando a regiao afetada volta a ficar saudavel, o trafego se rebalanceia sozinho.

Endpoints fixos (api-eu.floopy.ai e api-br.floopy.ai) nao fazem failover. Se voce apontar um cliente para um endpoint fixo e aquela regiao ficar indisponivel, essas requisicoes falham ate a regiao se recuperar. Use api.floopy.ai se quiser failover automatico.