Skip to main content

Overview

xAI provides Grok models with support for both OpenAI and Anthropic API formats, offering flexibility for different use cases. Key Features:
  • Dual API format support
  • Grok model family
  • Real-time information capabilities
  • Flexible authentication
Official Documentation: xAI Docs

Authentication

xAI supports dual authentication:
  • Bearer token for OpenAI-compatible endpoints
  • x-api-key for Anthropic-compatible endpoints
Lava Forward Token:
${LAVA_SECRET_KEY}.${CONNECTION_SECRET}.${PRODUCT_SECRET}
For BYOK: ${TOKEN}.${YOUR_XAI_KEY}
ModelContextDescription
grok-beta128KLatest Grok model
grok-vision-beta128KMulti-modal vision support

OpenAI-Compatible Endpoint

// Using OpenAI format with Bearer auth
const response = await fetch(
  `https://api.lavapayments.com/v1/forward?u=${encodeURIComponent('https://api.x.ai/v1/chat/completions')}`,
  {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.LAVA_FORWARD_TOKEN}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      model: 'grok-beta',
      messages: [{role: 'user', content: 'Hello!'}]
    })
  }
);

const data = await response.json();
console.log('Usage:', data.usage.total_tokens);

Anthropic-Compatible Endpoint

// Using Anthropic format with x-api-key auth
const response = await fetch(
  `https://api.lavapayments.com/v1/forward?u=${encodeURIComponent('https://api.x.ai/v1/messages')}`,
  {
    method: 'POST',
    headers: {
      'x-api-key': process.env.LAVA_FORWARD_TOKEN,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      model: 'grok-beta',
      messages: [{role: 'user', content: 'Hello!'}],
      max_tokens: 1024
    })
  }
);

const data = await response.json();
console.log('Usage:', data.usage.input_tokens);

Available Endpoints

EndpointFormatAuth Header
/v1/chat/completionsOpenAIAuthorization: Bearer
/v1/messagesAnthropicx-api-key
Usage Tracking:
  • OpenAI endpoint: data.usage (OpenAI format)
  • Anthropic endpoint: data.usage (Anthropic format with input_tokens/output_tokens)

BYOK Support

Supported - Get API key from xAI Console

Resources