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 })]
Unlike OpenRouter() and
Codex(), direct providers are not vaulted yet: the
credential comes from the agent's environment. A deployed agent needs it set as a runtime
secret, or should use a vaulted route instead.
Declaring this provider without the variable set is not an error. The failure comes when something tries to use it, and names the variable you need.
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.