Gateway quickstart

Store a provider credential, create a virtual key, and send your first governed request through Altrum.

This is in development. Details may change before it is available.

You need the Owner or Admin role, and a model provider account of your own.

1. Add a provider credential

   Open AI Gateway, then Provider credentials, and add your OpenAI API key. Altrum stores it encrypted and never shows it again. See Provider credentials.

2. Create a virtual key

   In Virtual keys, create an organization key. Copy it: it is shown once. See Virtual keys.

3. Point your client at Altrum

   Use your provider’s SDK as you do today, with Altrum’s address as the base URL and the virtual key as the API key. AI Gateway, Overview shows the address and code to copy for the OpenAI, Anthropic and Google SDKs and curl.

   import os
   from openai import OpenAI
   
   client = OpenAI(
       base_url="https://api.altrum.ai/v1",
       api_key=os.environ["ALTRUM_VIRTUAL_KEY"],
   )
   
   reply = client.chat.completions.create(
       model="openai/gpt-4o-mini",
       messages=[{"role": "user", "content": "Where is my parcel?"}],
   )
   print(reply.choices[0].message.content)
   

   The answer is the provider’s own answer, in the provider’s format.

4. See it in the request log

   Open AI Gateway, then Request log. The request is there with its model, tokens, cost, time taken and the guardrails that checked it.

Next

• Use Claude Code or another coding agent through Altrum: Coding agents.
• Set a monthly budget: Budgets and rate limits.
• Govern the traffic with guardrails: Organization guardrails.