xAI

Provider Slug. x-ai

Integrate

Just paste your xAI API Key to Obiguard to create your Virtual Key.

Sample Request

Obiguard is a drop-in replacement for xAI. You can make request using the official Obiguard SDK.

Popular libraries & agent frameworks like LangChain, CrewAI, AutoGen, etc. are also supported.

Python

from obiguard import Obiguard

client = Obiguard(
  obiguard_api_key="vk-obg***",  # Your Obiguard virtual key
)

response = client.chat.completions.create(
  model="grok-beta",
  messages=[{"role": "user", "content": "Hello!"}]
)

print(response.choices[0].message)

Python

from obiguard import Obiguard

client = Obiguard(
  obiguard_api_key="vk-obg***",  # Your Obiguard virtual key
)

response = client.chat.completions.create(
  model="grok-beta",
  messages=[{"role": "user", "content": "Hello!"}]
)

print(response.choices[0].message)

OpenAI Python SDK

from openai import OpenAI
from obiguard import OBIGUARD_GATEWAY_URL, createHeaders

client = OpenAI(
  api_key='OPENAI_API_KEY',
  base_url=OBIGUARD_GATEWAY_URL,
  default_headers=createHeaders(
    obiguard_api_key="vk-obg***",  # Your Obiguard virtual key
  )
)

completion = client.chat.completions.create(
  model="grok-beta",
  messages=[
    {"role": "user", "content": "Hello!"}
  ]
)

print(completion.choices[0].message)

cURL

curl https://gateway.obiguard.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "x-obiguard-api-key: $OBIGUARD_API_KEY" \
  -d '{
    "model": "grok-beta",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ]
  }'

Integration Overview

xAI Endpoints & Capabilities

Obiguard works with all of xAI’s endpoints and supports all xAI capabilities like function calling and image understanding. Find examples for each below:

Tool Calling (Function Calling)

Python

tools = [{
  "type": "function",
  "function": {
    "name": "getWeather",
    "description": "Get the current weather",
    "parameters": {
      "type": "object",
      "properties": {
        "location": {"type": "string", "description": "City and state"},
        "unit": {"type": "string", "enum": ["celsius", "fahrenheit"]}
      },
      "required": ["location"]
    }
  }
}]

response = client.chat.completions.create(
  model="grok-beta",
  messages=[
    {"role": "system", "content": "You are a helpful assistant."},
    {"role": "user", "content": "What's the weather like in Delhi - respond in JSON"}
  ],
  tools=tools,
  tool_choice="auto"
)

print(response.choices[0].finish_reason)

Python

tools = [{
  "type": "function",
  "function": {
    "name": "getWeather",
    "description": "Get the current weather",
    "parameters": {
      "type": "object",
      "properties": {
        "location": {"type": "string", "description": "City and state"},
        "unit": {"type": "string", "enum": ["celsius", "fahrenheit"]}
      },
      "required": ["location"]
    }
  }
}]

response = client.chat.completions.create(
  model="grok-beta",
  messages=[
    {"role": "system", "content": "You are a helpful assistant."},
    {"role": "user", "content": "What's the weather like in Delhi - respond in JSON"}
  ],
  tools=tools,
  tool_choice="auto"
)

print(response.choices[0].finish_reason)

REST

curl -X POST "https://gateway.obiguard.ai/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "x-obiguard-api-key: $OBIGUARD_API_KEY" \
  -d '{
    "model": "grok-beta",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "What'\''s the weather like in Delhi - respond in JSON"}
    ],
    "tools": [{
      "type": "function",
      "function": {
        "name": "getWeather",
        "description": "Get the current weather",
        "parameters": {
          "type": "object",
          "properties": {
            "location": {"type": "string", "description": "City and state"},
            "unit": {"type": "string", "enum": ["celsius", "fahrenheit"]}
          },
          "required": ["location"]
        }
      }
    }],
    "tool_choice": "auto"
  }'

Vision

Process images alongside text using xAI’s vision capabilities:

Python

response = client.chat.completions.create(
  model="grok-beta",
  messages=[
    {
      "role": "user",
      "content": [
        {"type": "text", "text": "What's in this image?"},
        {
          "type": "image_url",
          "image_url": "https://upload.wikimedia.org/wikipedia/commons/thumb/d/dd/Gfp-wisconsin-madison-the-nature-boardwalk.jpg/2560px-Gfp-wisconsin-madison-the-nature-boardwalk.jpg",
        },
      ],
    }
  ],
  max_tokens=300,
)

print(response)

Python

response = client.chat.completions.create(
  model="grok-beta",
  messages=[
    {
      "role": "user",
      "content": [
        {"type": "text", "text": "What's in this image?"},
        {
          "type": "image_url",
          "image_url": "https://upload.wikimedia.org/wikipedia/commons/thumb/d/dd/Gfp-wisconsin-madison-the-nature-boardwalk.jpg/2560px-Gfp-wisconsin-madison-the-nature-boardwalk.jpg",
        },
      ],
    }
  ],
  max_tokens=300,
)

print(response)

REST

curl -X POST "https://gateway.obiguard.ai/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_Obiguard_API_KEY" \
  -d '{
    "model": "grok-beta",
    "messages": [
      {
        "role": "user",
        "content": [
          {"type": "text", "text": "What'\''s in this image?"},
          {
            "type": "image_url",
            "image_url": "https://upload.wikimedia.org/wikipedia/commons/thumb/d/dd/Gfp-wisconsin-madison-the-nature-boardwalk.jpg/2560px-Gfp-wisconsin-madison-the-nature-boardwalk.jpg"
          }
        ]
      }
    ],
    "max_tokens": 300
  }'

Embeddings

FAQs

How to get the xAI API key?

Is is free to use the xAI API key?

I am getting rate limited on xAI API

Ecosystem

AI Apps

Agents

LLMs

Vector Databases

Integrate

Sample Request

Integration Overview

xAI Endpoints & Capabilities

FAQs

Ecosystem

AI Apps

Agents

LLMs

Vector Databases

​Integrate

​Sample Request

​Integration Overview

​xAI Endpoints & Capabilities

​FAQs

Integrate

Sample Request

Integration Overview

xAI Endpoints & Capabilities

FAQs