PHP SDK Integration Guide

# Install with Composer
composer require n1n/llm-api-php

# Or add in composer.json
{
    "require": {
        "n1n/llm-api-php": "^1.0"
    }
}

# If using the Guzzle HTTP client
composer require guzzlehttp/guzzle

<?php
require_once 'vendor/autoload.php';

use N1N\LLMClient;
use N1N\Models\ChatMessage;

// Initialize client
$client = new LLMClient([
    'api_key' => 'your-api-key',
    'base_url' => 'https://api.n1n.ai/v1'
]);

try {
    // Basic chat
    $response = $client->chat()->create([
        'model' => 'gpt-3.5-turbo',
        'messages' => [
            ['role' => 'system', 'content' => 'You are a helpful assistant'],
            ['role' => 'user', 'content' => 'Introduce the PHP language']
        ],
        'temperature' => 0.7,
        'max_tokens' => 500
    ]);
    
    echo $response->choices[0]->message->content;
    
    // Using message objects
    $messages = [
        new ChatMessage('system', 'You are a PHP expert'),
        new ChatMessage('user', 'How to connect to a database with PHP?')
    ];
    
    $response = $client->chat()->create([
        'model' => 'gpt-4o-mini',
        'messages' => $messages
    ]);
    
    // Get usage stats
    echo "Token usage: " . $response->usage->total_tokens . "
";
    echo "Cost: $" . $response->usage->cost . "
";
    
} catch (Exception $e) {
    echo "Error: " . $e->getMessage();
}

<?php
use N1N\LLMClient;

$client = new LLMClient(['api_key' => 'your-api-key']);

// Streaming response
$stream = $client->chat()->createStream([
    'model' => 'gpt-3.5-turbo',
    'messages' => [
        ['role' => 'user', 'content' => 'Write a long story']
    ],
    'stream' => true
]);

// Handle streaming data
foreach ($stream as $chunk) {
    if (isset($chunk->choices[0]->delta->content)) {
        echo $chunk->choices[0]->delta->content;
        ob_flush(); // Flush immediately to browser
        flush();
    }
}

// Stream with callbacks
$client->chat()->streamWithCallback(
    [
        'model' => 'gpt-3.5-turbo',
        'messages' => [['role' => 'user', 'content' => 'Hello']]
    ],
    function($chunk) {
        // Handle each data chunk
        if ($content = $chunk->choices[0]->delta->content ?? null) {
            echo $content;
        }
    },
    function($error) {
        // Error handling
        echo "Stream error: " . $error->getMessage();
    }
);