xAI

Use xAI with Blazen — construct the XaiProvider and call complete().

xAI is an OpenAI-compatible LLM provider. Construct it like any other Blazen provider — build a list of ChatMessages, call complete() (or stream()), and read back a typed ModelResponse.

At a glance

Provider id	xai
Base URL	https://api.x.ai/v1
Default model	grok-3
API key env var	XAI_API_KEY
Auth	Authorization: Bearer <key>

Set XAI_API_KEY in the environment and Blazen reads it automatically, or pass the key explicitly when you construct the provider.

Capabilities

Capability	Supported
Streaming	Yes
Tool calling	Yes
Structured output	Yes
Vision	Yes
Model listing	Yes
Embeddings	Yes

Usage

Construct the provider and call complete(). The default model is grok-3; override it with with_model / model when you need a different one.

use blazen_llm::{Model, ModelRequest, ChatMessage};
use blazen_provider_xai::XaiProvider;

// Reads XAI_API_KEY from the environment, or pass the key to `new`.
let model = XaiProvider::new(std::env::var("XAI_API_KEY")?);

let resp = model
    .complete(ModelRequest::new(vec![ChatMessage::user("Hello")]))
    .await?;
println!("{}", resp.content.unwrap_or_default());

from blazen import XaiProvider, ProviderOptions, ChatMessage

# Omit the api_key to read XAI_API_KEY from the environment.
model = XaiProvider(options=ProviderOptions(api_key="..."))

resp = await model.complete([ChatMessage.user("Hello")])
print(resp.content)

import { XaiProvider, ChatMessage } from "blazen";

// Omit apiKey to read XAI_API_KEY from the environment.
const model = XaiProvider.create({ apiKey: "..." });

const resp = await model.complete([ChatMessage.user("Hello")]);
console.log(resp.content);

Streaming

async for chunk in model.stream([ChatMessage.user("Count to five")]):
    print(chunk.delta, end="")

await model.stream([ChatMessage.user("Count to five")], (chunk) => {
  if (chunk.delta) process.stdout.write(chunk.delta);
});

See also

• Models & Providers — the canonical provider + ModelManager guide