Grok

Grok is a conversational AI assistant developed by xAI, designed to provide helpful and informative responses with real-time knowledge. Grok models are known for their strong reasoning capabilities and up-to-date information access.

The sgcWebSockets library provides a Delphi component TsgcHTTP_API_Grok to interact with the Grok API.

Grok API

The Grok API provides access to Grok models for building AI-powered applications. The API supports text generation, vision (image understanding), streaming, and model listing.

Features

• Messages
  • Grok Messages Examples

• Vision
  • Grok Vision Examples

• Models
  • Grok Models Examples

Configuration

The Grok API uses API keys for authentication. Visit your xAI Console to retrieve the API key you'll use in your requests.

Remember that your API key is a secret! Do not share it with others or expose it in any client-side code.

This API Key must be configured in the GrokOptions.ApiKey property of the component.

Grok := TsgcHTTP_API_Grok.Create(nil);
Grok.GrokOptions.ApiKey := 'YOUR_API_KEY';

Messages

Send a structured list of input messages with text content, and the model will generate the next message in the conversation.

• _CreateMessage: Creates a message with the specified model and user prompt.
  • Model: The model to use (e.g. grok-3).
  • Message: The user message content.
• _CreateMessageWithSystem: Creates a message with a system prompt.
  • System: System prompt that sets the behavior of the assistant.
• _CreateMessageStream: Creates a message with streaming (SSE) enabled. Events are delivered through the OnHTTPAPISSE event handler.

Vision

Grok can understand images passed as base64-encoded content within messages.

• _CreateVisionMessage: Sends an image with a text prompt.
  • ImageBase64: The base64-encoded image data.
  • MediaType: The MIME type (image/jpeg, image/png, image/gif, image/webp).
  • Prompt: The text prompt to accompany the image.

Models

List the available Grok models.

• _GetModels: Lists all available models.