429 - Rate limited

Who rate-limited you, and how to unblock.

A 429 can come from three sources: Guardian, your per-key RPM cap, or the upstream provider. The error body tells you which one.

Guardian block

json
{
  "error": {
    "code":                "guardian_block",
    "message":             "Blocked by Guardian: dedup (3 identical prompts in 47s)",
    "rule":                "dedup",
    "retry_after_seconds": 60
  }
}

Fix the loop in your code, or raise/disable the Guardian threshold in Dashboard → Guardian.

Per-key RPM cap hit

json
{
  "error": {
    "code":                "rate_limit_exceeded",
    "message":             "Per-key rate limit exceeded (60 req/min).",
    "retry_after_seconds": 12
  }
}

Raise the RPM cap in Dashboard → Keys → Edit, or back off until the window slides.

Upstream rate limit

When the provider (OpenAI, Anthropic, …) returns a 429, HiWay's provider fallback tries the next cheapest same-tier model (up to 2 retries). If all candidates are rate-limited, HiWay forwards the final 429 with the original Retry-After header intact.