README

Provider-agnostic PHP library for chat-style LLM requests.

MVP scope

• PHP ^8.2
• PSR transport under the hood (Guzzle + Nyholm PSR-7)
• Chat API only
• Providers: OpenAI, YandexGPT, DeepSeek
• Router fallback policy (auth/timeout/429/5xx)
• Optional structured output with JSON schema

Install

composer require denx-b/ai-adapter

Quick start

<?php

declare(strict_types=1);

require __DIR__ . '/vendor/autoload.php';

use AiAdapter\Ai;
use AiAdapter\Core\Router;
use AiAdapter\DTO\ChatRequest;
use Dotenv\Dotenv;

Dotenv::createUnsafeImmutable(__DIR__)->safeLoad();

$openAiApiKey = getenv('OPENAI_API_KEY') ?: '';
$yandexApiKey = getenv('YANDEX_API_KEY') ?: '';
$yandexFolderId = getenv('YANDEX_FOLDER_ID') ?: '';
$deepSeekApiKey = getenv('DEEPSEEK_API_KEY') ?: '';

$ai = Ai::make()
    ->withYandex($yandexApiKey, $yandexFolderId)
    ->withOpenAi($openAiApiKey)
    ->withDeepSeek($deepSeekApiKey)
    ->router(
        Router::fallback([
            'yandex',
            'openai',
            'deepseek',
        ])
    );

$response = $ai->chat(
    ChatRequest::make()
        ->system('You are a concise assistant.')
        ->user('Summarize this incident report in 3 bullet points.')
);

echo $response->text();

Router::fallback(['yandex', 'openai', 'deepseek']) использует defaultModel каждого провайдера. Если нужна конкретная модель, можно указать provider:model, например openai:gpt-4.1-mini.

Рекомендованные модели (актуально на 27 февраля 2026)

Ниже практичный shortlist для chat/text-generation сценариев в этой библиотеке.

Пример выбора "лучшего баланса" через дефолты:

$ai = Ai::make()
    ->withYandex($yandexApiKey, $yandexFolderId, defaultModel: 'yandexgpt')
    ->withOpenAi($openAiApiKey, defaultModel: 'gpt-5-mini')
    ->withDeepSeek($deepSeekApiKey, defaultModel: 'deepseek-chat')
    ->router(Router::fallback(['yandex', 'openai', 'deepseek']));

Примечания:

• Для Yandex-адаптера текущая реализация добавляет ветку /latest автоматически.
• Если у провайдера нет доступа к выбранной модели, запрос завершится ошибкой и роутер перейдет к следующему провайдеру (по fallback-политике).

See examples/ for more scenarios.