Priority

The Priority strategy tries providers in the order you define. If the first provider fails (timeout, rate limit, 5xx error), the request automatically goes to the next provider in line.

Best for: High availability setups and automatic recovery from provider outages.

1
{
2
  "name": "HA Priority",
3
  "default_strategy": {
4
    "type": "fallback",
5
    "providers": [
6
      { "provider": "openai", "model": "gpt-5.2", "priority": 1 },
7
      { "provider": "azure", "model": "gpt-5.2", "priority": 2 },
8
      { "provider": "anthropic", "model": "claude-sonnet-4-20250514", "priority": 3 }
9
    ]
10
  }
11
}

Requests go to the highest-priority provider (lowest priority number). On failure, Gateway automatically retries with the next provider in the list, continuing until a provider succeeds or all providers are exhausted.

Gateway tracks provider health automatically — if a provider accumulates failures, it is temporarily skipped so requests aren’t wasted on a provider that’s down.