— Docs · Roteamento

Roteamento de provedores

Cada endpoint da Onerall é servido por um ou mais provedores upstream. Você pode aceitar o roteamento padrão, otimizar por preço ou latência, ou fixar a ordem exata.

Política padrão

CritérioPeso
Saúde do provedor (janela de 5 min)eliminatório
Latência p95 recentealto
Preço por unidademédio
Afinidade regional do clientemédio

Controlando no request

{
  "input": "...",
  "routing": {
    "order": ["provider_a", "provider_b"],
    "allow_fallbacks": true,
    "optimize": "price"        // "price" | "latency" | "balanced"
  }
}

Com allow_fallbacks: false, uma falha do primeiro provedor retorna provider_unavailable em vez de tentar o próximo.

Transparência na resposta

X-Onerall-Provider: provider_a
X-Onerall-Attempts: 2
X-Onerall-Route: price