cuadra-ai/cuadra-ai-sdk

Build AI agents with your own data, accelerate time-to-value, and create solutions as unique as your business.

1.0.2 2025-07-07 10:12 UTC

Requires

• php: ^7.2 || ^8.0
• ext-curl: *
• ext-json: *
• apimatic/core: ~0.3.13
• apimatic/core-interfaces: ~0.1.5
• apimatic/unirest-php: ^4.0.6

Requires (Dev)

• phan/phan: 5.4.5
• squizlabs/php_codesniffer: ^3.5

MIT

• Cuadra AI

• model
• embed
• ai
• cuadraai

README

Introduction

API Documentation

Install the Package

Run the following command to install the package and automatically add the dependency to your composer.json file:

composer require "cuadra-ai/cuadra-ai-sdk:1.0.2"

Or add it to the composer.json file manually as given below:

"require": {
    "cuadra-ai/cuadra-ai-sdk": "1.0.2"
}

You can also view the package at: https://packagist.org/packages/cuadra-ai/cuadra-ai-sdk#1.0.2

Initialize the API Client

Note: Documentation for the client can be found here.

The following parameters are configurable for the API Client:

Parameter	Type	Description
environment	Environment	The API environment. Default: Environment.PRODUCTION
timeout	int	Timeout for API calls in seconds. Default: 30
enableRetries	bool	Whether to enable retries and backoff feature. Default: false
numberOfRetries	int	The number of retries to make. Default: 0
retryInterval	float	The retry time interval between the endpoint calls. Default: 1
backOffFactor	float	Exponential backoff factor to increase interval between retries. Default: 2
maximumRetryWaitTime	int	The maximum wait time in seconds for overall retrying requests. Default: 0
retryOnTimeout	bool	Whether to retry on request timeout. Default: true
httpStatusCodesToRetry	array	Http status codes to retry against. Default: 408, 413, 429, 500, 502, 503, 504, 521, 522, 524
httpMethodsToRetry	array	Http methods to retry against. Default: 'GET', 'PUT'
loggingConfiguration	LoggingConfigurationBuilder	Represents the logging configurations for API calls
proxyConfiguration	ProxyConfigurationBuilder	Represents the proxy configurations for API calls
authorizationCodeAuth	AuthorizationCodeAuth	The Credentials Setter for OAuth 2 Authorization Code Grant

The API client can be initialized as follows:

use CuadraAiLib\Logging\LoggingConfigurationBuilder;
use CuadraAiLib\Logging\RequestLoggingConfigurationBuilder;
use CuadraAiLib\Logging\ResponseLoggingConfigurationBuilder;
use Psr\Log\LogLevel;
use CuadraAiLib\Environment;
use CuadraAiLib\Authentication\AuthorizationCodeAuthCredentialsBuilder;
use CuadraAiLib\CuadraAiClientBuilder;

$client = CuadraAiClientBuilder::init()
    ->authorizationCodeAuthCredentials(
        AuthorizationCodeAuthCredentialsBuilder::init(
            'OAuthClientId',
            'OAuthClientSecret',
            'OAuthRedirectUri'
        )
    )
    ->environment(Environment::PRODUCTION)
    ->loggingConfiguration(
        LoggingConfigurationBuilder::init()
            ->level(LogLevel::INFO)
            ->requestConfiguration(RequestLoggingConfigurationBuilder::init()->body(true))
            ->responseConfiguration(ResponseLoggingConfigurationBuilder::init()->headers(true))
    )
    ->build();

Authorization

This API uses the following authentication schemes.

• OAuth2 (OAuth 2 Authorization Code Grant)

List of APIs

• Chat
• Models
• Embeds
• Usage

SDK Infrastructure

Configuration

• ProxyConfigurationBuilder
• LoggingConfigurationBuilder
• RequestLoggingConfigurationBuilder
• ResponseLoggingConfigurationBuilder

HTTP

• HttpRequest

Utilities

• ApiResponse