xAI Grok API Authentication

xAI Grok API Authentication

Complete guide for setting up and managing xAI API authentication for Grok models with Twitter/​X integration.

Quick Start

1. Get API Key

1. Go to console.x.ai
2. Sign in with your X (Twitter) account
3. Navigate to "API Keys" section
4. Click "Create API Key"
5. Copy and save the key (starts with xai-)

2. Set Environment Variable

# Add to .bashrc, .zshrc, or .env
export XAI_API_KEY="xai-your-key-here"

3. Test Connection

curl https://api.x.ai/v1/models \
  -H "Authorization: Bearer $XAI_API_KEY"

Authentication Methods

Method 1: Environment Variable (Recommended)

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1"
)

Method 2: Direct Key

from openai import OpenAI

client = OpenAI(
    api_key="xai-your-key-here",
    base_url="https://api.x.ai/v1"
)

Method 3: Using xai-sdk

from xai_sdk import Client

client = Client(api_key=os.getenv("XAI_API_KEY"))

API Compatibility

xAI API is fully compatible with OpenAI SDK:

# Just change base_url - everything else works the same
from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1"  # Only difference
)

response = client.chat.completions.create(
    model="grok-3-fast",  # Use Grok models
    messages=[{"role": "user", "content": "Hello!"}]
)

Free Credits

$150/​Month Free Credits

1. Go to console.x.ai
2. Navigate to Settings → Data Sharing
3. Enable data sharing opt-in
4. Receive $150/​month in API credits

Credit Usage

Configuration File

Create .env.xai:

# xAI API Configuration
XAI_API_KEY=xai-your-key-here
XAI_BASE_URL=https://api.x.ai/v1
XAI_DEFAULT_MODEL=grok-3-fast

Error Handling

Common Errors

Python Error Handling

from openai import OpenAI, APIError, RateLimitError

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1"
)

try:
    response = client.chat.completions.create(
        model="grok-3-fast",
        messages=[{"role": "user", "content": "Hello"}]
    )
except RateLimitError:
    print("Rate limit hit, waiting...")
    time.sleep(60)
except APIError as e:
    print(f"API error: {e}")

Security Best Practices

1. Never commit API keys to git
2. Use environment variables instead of hardcoding
3. Rotate keys regularly via console.x.ai
4. Use separate keys for dev/​prod environments
5. Add to .gitignore:

   .env
   .env.*
   **/​secrets.*
   

Rate Limits

Endpoints

Related Skills

• xai-models - Model selection guide
• xai-x-search - Twitter/​X search
• xai-sentiment - Sentiment analysis

References

• xAI Console
• xAI Documentation
• API Overview