README

PHP integration for the xAI Responses API using the tool-calling abstractions provided by adachsoft/ai-integration.

The package maps tool-calling chat requests to xAI Responses API payloads and maps API responses back to the shared SPI response model. It supports assistant messages, system and user messages, function calls, function call outputs, token usage, configurable models, and optional HTTP traffic logging.

Requirements

PHP 8.3 or newer
An xAI API key

Installation

composer require adachsoft/ai-integration-xai-responses

Usage

Create the xAI configuration and build the tool-calling chat SPI through the package factory:

use AdachSoft\AiIntegrationXaiResponses\Config\XaiResponsesConfig;
use AdachSoft\AiIntegrationXaiResponses\XaiResponsesToolCallingChatSpiFactory;

$config = new XaiResponsesConfig(
    apiKey: getenv('XAI_API_KEY'),
    defaultModelId: 'grok-4',
);

$chat = XaiResponsesToolCallingChatSpiFactory::create($config);

The resulting $chat implements ToolCallingChatSpiInterface from adachsoft/ai-integration and can be used wherever that shared SPI is expected. Use XaiResponsesToolCallingChatSpiFactory::createWithLogger() when HTTP request and response logging is required.

Configuration

XaiResponsesConfig supports the following settings:

apiKey — xAI API key.
defaultModelId — model used when a request does not provide one; defaults to grok-4.
baseUri — xAI API base URI; defaults to https://api.x.ai/v1.
defaultTemperature — default sampling temperature; defaults to 0.7.

Keep API keys in environment variables or another secure secret store. Do not commit credentials to source control.

License

This package is licensed under the MIT License. See the LICENSE file for details.

adachsoft / ai-integration-xai-responses

Maintainers

Package info

Statistics

Security