Een werkend gateway in minder dan vijf minuten
Eén container, één provider, één request. Geen account, geen aanmelding, geen phone-home. Hebt u Docker, dan bent u door deze pagina heen voordat uw koffie er staat.
Start het gateway
De embedded modus heeft niets externs nodig: de status staat in het geheugen, dus niets overleeft een herstart, en er hoeft nog geen Postgres of Redis te staan. De console komt op dezelfde poort omhoog, geserveerd door dezelfde Rust-binary.
$ docker run -p 4000:4000 <registry>/waeg-gateway:<version>Geen werkende pull: de images zijn nog niet openbaar. Ontwerppartners krijgen de registrygegevens vertrouwelijk.
Registry en versie zijn placeholders — ontwerppartners ontvangen ze vertrouwelijk. Console op http://localhost:4000/ui/: meld u aan met het vooraf aangemaakte adminaccount en wijzig het wachtwoord.
Voeg een provider toe
Geef het één upstream en één alias, en herstart dan met het bestand gekoppeld zoals het commentaar laat zien. Aliassen zijn waar uw applicatiecode naar verwijst, dus u kunt ze later omleggen zonder de applicatie aan te raken.
# waeg.yaml
providers:
openai:
provider: openai
api_key_env: OPENAI_API_KEY # or api_key_ref: a vault reference
models:
- name: chat # what your code sends as "model"
deployments:
- provider: openai
model_id: gpt-4o
# Restart with it mounted:
# docker run -p 4000:4000 -e OPENAI_API_KEY \
# -v "$PWD/waeg.yaml:/etc/waeg/waeg.yaml" \
# <registry>/waeg-gateway:<version> serve --config /etc/waeg/waeg.yamlRicht uw SDK erop
Wäg bedient het OpenAI-compatibele oppervlak, dus het enige dat verandert is de base-URL. Uw SDK, request-vormen, streaminggedrag en tool calling blijven ongewijzigd.
from openai import OpenAI
client = OpenAI(
base_url="http://localhost:4000/v1", # the only change
api_key="<your-waeg-virtual-key>", # created in the console
)
resp = client.chat.completions.create(
model="chat",
messages=[{"role": "user", "content": "Hello"}],
)Bekijk de response-headers. Dat is het eerste zichtbare teken dat er iets is besloten in plaats van alleen doorgestuurd:
| Header | Wat het u vertelt |
|---|---|
x-waeg-routed-model | Welke deployment het request daadwerkelijk heeft bediend. |
x-waeg-route-reason | Waarom de router die koos — bij intelligente routing en sessie-affiniteit. |
x-waeg-cache | Bij een cachetreffer: welke van de vier tiers antwoordde. |
Bekijk het in de console
Open de console en het request staat er al: verkeer, latentie, tokens, de routingbeslissing en eventuele policy-verdicts. Kosten verschijnen zodra het meegeleverde prijspakket is geladen onder Usage & cost → Pricing. Verder is er niets geconfigureerd — dat is wat een doorloop door het request-pad oplevert.
Hoe het hiervandaan verdergaat
Migreren vanaf LiteLLM
Importeer uw bestaande config met één commando, draai beide parallel, en schakel om zodra de cijfers overeenkomen.
Echt deployen
De Wäg-operator draait de gateway vanuit één custom resource — schaling, rollouts, controles op zijn afhankelijkheden — en er is ook een Helm chart. Zelf meebrengen: Postgres, OpenFGA, Redis en een object store.
Governance toevoegen
Hiërarchische budgetten, de policy-keten, agent- en MCP-controle, auditvastleggingen.
Wäg zit in besloten preview, dus het image-adres hierboven is een placeholder. Ontwerppartners ontvangen de gebouwde, ondertekende images en de registrygegevens vertrouwelijk, met begeleide onboarding.