Skip to main content

The global endpoint and the regional ones

The base URL used throughout these docs, https://api.valarhq.ai/v1, is the global endpoint: DNS geo-steering resolves it to the nearest Valar region automatically, so a client in Frankfurt enters through the EU edge and a client in Chicago through the US edge, with failover between regions if one is unhealthy. If you want to be explicit about which region your traffic enters through — a fixed egress path for firewall rules, reproducible latency, or simply no dependence on where your resolver sits — point at a regional endpoint directly: Everything else stays identical: use exactly the same API keys and model slugs from the dashboard, the same request shapes, and the same API surface. The base URL is the only thing that changes.

Configure it

No key or workspace changes are needed to switch endpoints — the same key works against the global endpoint and both regional ones, and usage from all three lands in the same reporting.