XAI()
Grok models direct from xAI, with your own API key. Costs go direct to the vendor at their rates — no markup, nothing on your Axon balance.
export default defineProfile({
providers: [XAI()],
})
Serves x-ai/*.
Credentials
Set the environment variable, or pass key on the declaration:
XAI_API_KEY=...
providers: [XAI({ key: process.env.MY_OWN_VAR })]
You can also store this key in your Axon account vault through the cloud client:
await cloud.user.vault.connections.get("xai").connect({ key: apiKey })
A fresh host signed into the same account can use the connection. Profiles without
an explicit providers list discover active account connections automatically;
an explicit list continues to restrict which providers that machine uses.
Explicit keys and environment variables take precedence over the account vault.
A custom url requires an explicit credential. Provider SDKs ship with Axon.
Options
XAI(options?: ProviderOptions)
| Option | Default | Description |
|---|---|---|
key | XAI_API_KEY | Your own credential, passed directly |
url | the provider's API | Endpoint override |
slots | unbounded | Ceiling on concurrent calls a fanned-out role may spend here |
Model ids
Bare Grok slugs:
export default defineAgent({ model: "xai:grok-4.6" })
Note the canonical vendor prefix is x-ai while the provider name is xai — the
translation is automatic.