Skip to main content
xAI is a platform for providing endpoints for Large Language models. See their list of models here. We recommend experimenting to find the best-suited model for your use-case. The grok-3 model is good for most use-cases.

​
Authentication

Set your XAI_API_KEY environment variable. You can get one from xAI here. 
export XAI_API_KEY=sk-***

​
Example

Use xAI with your Agent: 

from agno.agent import Agent
from agno.models.xai import xAI

agent = Agent(
    model=xAI(id="grok-3"),
    markdown=True
)

agent.print_response("Share a 2 sentence horror story.")
xAI models support live search capabilities that can access real-time information: 
from agno.agent import Agent
from agno.models.xai import xAI

agent = Agent(
    model=xAI(
        id="grok-3",
        search_parameters={
            "mode": "on",
            "max_search_results": 20,
            "return_citations": True,
        },
    ),
    markdown=True,
)

agent.print_response("What's the latest news about AI developments?")
View more examples here.

​
Params

ParameterTypeDefaultDescription
idstr"grok-3"The specific model ID used for generating responses.
namestr"xAI"The name identifier for the xAI agent.
providerstr"xAI"The provider of the model, combining "xAI" with the model ID.
api_keyOptional[str]NoneThe API key for authenticating requests to the xAI service. Retrieved from the environment variable XAI_API_KEY.
base_urlstr"https://api.x.ai/v1"The base URL for making API requests to the xAI service.
search_parametersOptional[Dict[str, Any]]NoneParameters for enabling live search capabilities. Supports mode, max_search_results, and return_citations.
xAI also supports the params of OpenAI.