grok_box

An xAI (Grok) provider based on ai_box.

Usage

import 'package:ai_box/ai_box.dart';
import 'package:grok_box/grok_box.dart';

Future<void> main() async {
  final ai = Grok(apiKey: 'xai-...');

  // One-shot text generation.
  final answer = await ai.generateText(
    model: 'grok-4.3',
    message: 'Say hello in one short sentence.',
  );
  print(answer);

  // Multi-turn chat.
  final res = await ai.chat(
    model: 'grok-4.3',
    messages: [
      LLMContent.system('You are concise.'),
      LLMContent.user('What is the capital of Japan?'),
    ],
    maxTokens: 32,
  );
  print(res.text);
  print(res.usage); // token usage
}

Streaming

True SSE streaming — text arrives incrementally and the final chunk carries the finish reason:

await for (final text in ai.generateTextStream(
  model: 'grok-4.3',
  message: 'Write a haiku about Dart.',
)) {
  stdout.write(text);
}

Models and key validation

final models = await ai.getModels();

// validateKey() checks the key against xAI's api-key endpoint and also
// verifies the key/team is not blocked or disabled.
final ok = await ai.validateKey();

Multimodal input, tool calling, structured output and the sealed LLMException error hierarchy are all provided by ai_box — see its README for details.