XAI_API_KEY and metered API billing.
Connect a subscription
Add xAI (Grok subscription) in Settings > Models and complete the xAI authorization flow with the account that owns the eligible plan. No API key or deployment environment variable is required. Subscription models keep thexai/ prefix. When both subscription and xAI API
key connections exist, Roomote prefers subscription
access for those models.
Cost behavior
Requests consume the plan’s included usage windows rather than an xAI API balance. Roomote displays plan and allowance information when xAI’s unofficial CLI usage service returns it. That service can change without notice, so the usage line may disappear even while inference still works. Your xAI or X plan and billing page is authoritative.Verify setup
- complete the xAI authorization flow
- confirm the Grok subscription shows as connected
- enable an
xai/...model and assign it to a role - run a small task and check the subscription usage display when available
Common issues
- Authorization succeeds but models fail. Confirm the account has an eligible active plan with coding or API-compatible Grok access.
- Usage is not displayed. The provider’s unofficial usage endpoint may be unavailable; try a task before reconnecting.
- The allowance is exhausted. Wait for the plan window to reset or disconnect
the subscription so a configured
XAI_API_KEYcan provide metered capacity.