xAI

xAI serves its Grok models. Its API follows OpenAI’s format, so you wrap it with the OpenAI client and the SDK meters it with the OpenAI recipe.

Set up

Point the OpenAI client’s baseURL at xAI and wrap it:

import OpenAI from 'openai';

const xai = stigg.wrap(
  new OpenAI({ baseURL: 'https://api.x.ai/v1', apiKey: process.env.XAI_API_KEY }),
);

const response = await xai.chat.completions.create({
  model,
  messages,
  stiggContext: { customerId: 'customer-acme', entitlement: { currencyId: 'credits' } },
});

xAI supports both the Chat Completions and Responses APIs. Both are metered.

What is reported

xAI returns a usage object in OpenAI’s format with the number of tokens each call consumed. The calls go through the OpenAI client, so they are reported under OpenAI event names. The wrapper reads the counts and reports them to Stigg as the metrics below.

Method	Event name
`chat.completions.create`	`openai.chat.completions.create`
`responses.create`	`openai.responses.create`

Chat Completions

Metric	What it counts
`prompt_tokens`	Input tokens, including cached tokens
`completion_tokens`	Output tokens
`cached_tokens`	Input tokens served from the cache, when the vendor reports them
`total_tokens`	All input and output tokens, as reported by the vendor

Responses

Metric	What it counts
`input_tokens`	Input tokens, including cached tokens
`output_tokens`	Output tokens
`cached_tokens`	Input tokens served from the cache, when the vendor reports them
`total_tokens`	All input and output tokens, as reported by the vendor

total_tokens includes the other token counts, so price the total or the parts, never both. To tell xAI apart from other vendors on the same event name, add a dimension such as provider to the stiggContext. Every usage field the provider returns is also included, with a raw. prefix. See How usage is reported. For details on xAI’s API, see xAI’s API reference.

Introduction

Get started

Usage metering

Credits

Entitlements and access enforcement

Governance

AI agents

Architecture and deployment

Pricing and packaging

Customers, subscriptions and contracts

Workflows

Widgets

Developer tools

Account management

Security & compliance

Set up

What is reported

​Set up

​What is reported

Set up

What is reported