Smart routing

Routify routes each request to the best available channel for that model.

Routing pipeline

Request
  │
  ▼
1. Candidates    — list channels supporting requested model
  │
  ▼
2. Healthy       — drop unhealthy / over-quota / low-balance
  │
  ▼
3. Permitted     — apply user tier + region preference
  │
  ▼
4. Score         — priority × weight × health × latency × cost factors
  │
  ▼
5. Weighted pick — pick using score as probability

Failure handling

If a chosen channel returns an error, Routify:

1. Marks the channel as failed (raises its failure_rate exponentially)
2. Selects another candidate from the same pool
3. Retries up to 3 times across different channels
4. Returns 502 if all fail

You'll always either get a 200 response or an explicit error — we never silently degrade quality.

Channel quality tiers

VIP tier accounts get a 1.5× routing weight bonus on official channels — so you nearly always hit the highest-quality endpoint.

Manual routing

Force a specific channel:

extra_body={"routify": {"channel": "deepseek-official"}}

Skip a channel:

extra_body={"routify": {"exclude_channels": ["claude-aws-bedrock"]}}