docs/usage/providers/supergrok.mdx
SuperGrok is xAI's subscription plan for higher Grok usage limits and access to frontier models. LobeHub's SuperGrok provider lets you use an eligible SuperGrok or X Premium subscription by signing in to your xAI account—no separate xAI API key is required.
xAI also uses this subscription-based OAuth flow in third-party integrations such as OpenCode. LobeHub uses the device authorization flow: it opens xAI in your browser, displays a short code when needed, and waits for you to approve access.
<Callout type={'info'}>
SuperGrok and xAI are separate providers in LobeHub. Choose SuperGrok to use an existing subscription through OAuth. Choose xAI if you want to use an API key from the xAI Console and pay for metered API usage.
</Callout>
Before connecting, make sure you have:
auth.x.ai and api.x.aiIf your subscription was purchased through X, sign in to Grok, open Settings > Account, and connect the X account that owns the subscription. xAI uses this link to recognize the X subscription entitlement. See the Grok account and subscription FAQ for details.
<Callout type={'warning'}> Subscription eligibility, model access, usage limits, and regional availability are controlled by xAI and may vary by plan. If authorization succeeds but access is denied, verify your current entitlement on the same account you used to sign in. </Callout>
Settings in LobeHubAI ProvidersSuperGrokClick Connect with SuperGrok. LobeHub requests a one-time device code and normally opens the xAI authorization page in a new browser tab.
If the page does not open automatically, click Open browser to authorize. LobeHub also shows the authorization URL and a short code that you can copy manually.
LobeHub will show Connected after xAI completes the authorization. The OAuth access and refresh tokens are saved in LobeHub's encrypted provider credential vault and refreshed automatically when necessary.
<Callout type={'info'}> Never paste your xAI account password or an API key into the SuperGrok provider. Account sign-in happens only on xAI's authorization page. </Callout>
Open the model selector in a conversation and choose a model under SuperGrok. LobeHub currently enables grok-4.5 by default and can load additional models made available to your account.
See xAI's model documentation for the latest model capabilities and availability. </Steps>
The SuperGrok provider is intended for Grok chat models. Depending on the selected model, LobeHub can use:
<Callout type={'warning'}> SuperGrok in LobeHub currently supports chat models only. Grok Imagine image or video generation and Grok Voice are separate products and are not exposed through this provider. Use the appropriate xAI API provider or the official Grok app for those capabilities. </Callout>
| SuperGrok provider | xAI provider | |
|---|---|---|
| Authentication | Browser sign-in with xAI OAuth | API key from the xAI Console |
| Payment | Uses your eligible subscription allowance | Metered API billing |
| API key required | No | Yes |
| Model access | Determined by your subscription entitlement | Determined by your xAI API account |
| LobeHub browser requests | Disabled; requests run through the server | Depends on the provider configuration |
Use the SuperGrok provider if you already pay for a compatible subscription and want the simplest sign-in flow. Use the xAI provider guide when you need API-key billing, an independently managed API account, or APIs not included in the subscription integration.
SuperGrok usage is governed by your xAI subscription rather than LobeHub token pricing. xAI currently presents paid usage as a shared weekly allowance across Grok products, with usage and the next reset shown under Settings > Usage in Grok. Limits can change, so refer to the official Grok FAQ for the current policy.
When the included allowance is exhausted, requests may be limited until the allowance resets, you add Extra Usage Credits, or you upgrade the subscription. API credits purchased separately in the xAI Console are associated with the API provider and are not required to connect SuperGrok.
To stop using the connected account:
Settings > AI Providers > SuperGrokDisconnectDisconnecting removes the stored SuperGrok OAuth credentials from LobeHub. To use another account, disconnect first and then run Connect with SuperGrok again in a browser session signed in to the desired xAI account.
Open browser to authorizeDevice codes are short-lived. Return to the SuperGrok provider, click Retry, and complete the new authorization request.
Settings > AccountDisconnect and reconnect the provider to create a new token pair. If the error continues, confirm that the subscription is active and that the requested model is available to your account and region. You can also check the xAI service status.
Model availability is returned by xAI for the connected account. Refresh the provider's model list after connecting, and check xAI's current model catalog. A model announced for the API or Grok app is not necessarily included in every subscription tier.
Check Settings > Usage in Grok. If you reached the subscription allowance, wait for the displayed reset time, add Extra Usage Credits, or upgrade the plan.