PHP Luminova: OpenAI Client Integration

use Luminova\AI\Client\OpenAI;

$client = new OpenAI(
    apiKey:       env('OPENAI_KEY'),
    organization: 'org-abc123',  // Optional
    project:      'proj-xyz',    // Optional
);

use Luminova\AI\AI;

$reply = AI::message('Hello from the config-driven client!');

$reply = $client->message('Explain quantum entanglement simply.');
echo $reply[0]['text'] ?? '';

$reply = $client->chat([
    ['role' => 'system',    'content' => 'You are a helpful PHP tutor.'],
    ['role' => 'user',      'content' => 'What is a trait?'],
    ['role' => 'assistant', 'content' => 'A trait is a reusable set of methods...'],
    ['role' => 'user',      'content' => 'Can traits have properties?'],
]);

echo $reply[0]['text'] ?? '';

$reply = $client->chat('Write a haiku about the ocean.', [
    'model'       => 'gpt-4.1',
    'max_tokens'  => 64,
    'temperature' => 0.8,
]);

$response = $client->generate('List 5 PHP best practices.');
print_r($response);

$results = $client->webSearch('Latest PHP 8.4 features');
print_r($results);

$vector = $client->embed('The quick brown fox');
// Returns a flat float array: [0.012, -0.034, ...]

$vectors = $client->embed(['Hello world', 'Hi there']);
// Returns an array of float arrays

use Luminova\AI\AI;
$similarity = AI::compareCosineVector($vectors[0], $vectors[1]);
echo $similarity; // e.g. ~0.97

$vector = $client->embed('Some text', [
    'model'      => 'text-embedding-3-large',
    'dimensions' => 512,
]);

$images = $client->image('A serene mountain lake at sunset, oil painting style.');
echo $images[0]['url'] ?? '';

$images = $client->image('A futuristic city skyline at night, digital art.', [
    'model'           => 'dall-e-3',
    'size'            => '1024x1024',
    'response_format' => 'url',
    'n'               => 2,
]);

foreach ($images as $img) {
    echo $img['url'] . PHP_EOL;
}

$results = $client->image('Replace the sky with a dramatic sunset.', [
    'size'  => '1024x1024',
    'edits' => [
        'image' => '/path/to/original.png', // Max 4 MB PNG
        'mask'  => '/path/to/mask.png',     // Max 4 MB PNG, transparent = editable
    ],
]);

echo $results[0]['url'] ?? '';

$content = $client->vision(
    'Describe what you see in this image.',
    'https://upload.wikimedia.org/wikipedia/commons/a/a7/Camponotus_flavomarginatus_ant.jpg'
);

echo $content[0]['text'] ?? '';

$content = $client->vision(
    'Is there any text in this screenshot? If so, transcribe it.',
    '/tmp/screenshot.png',
    ['model' => 'gpt-4.1']
);

echo $content[0]['text'] ?? '';

$content = $client->vision(
    'Which of these two logos is more recognizable and why?',
    [
        'https://example.com/logo-a.png',
        'https://example.com/logo-b.png',
    ]
);

$content = $client->vision(
    'Identify any defects on this product.',
    '/tmp/product.jpg',
    ['detail' => 'high']
);

$url = $client->speech('Welcome to Luminova!', [
    'voice' => 'nova',     // alloy, echo, fable, onyx, nova, shimmer
    'speed' => 1.0,
    'model' => 'gpt-4o-mini-tts',
    'path'  => '/var/www/html/audio', // Optional save directory
]);

echo $url; // https://example.com/audio/6789abc.mp3

$url = $client->speech('Hello, world!', [
    'symlink' => 'public/audio',
]);

$text = $client->audio(
    'Transcribe this meeting recording.',
    '/tmp/meeting.mp3',
    [
        'model'    => 'whisper-1',
        'language' => 'en',
    ]
);

echo $text;

$srt = $client->audio('', '/tmp/interview.mp3', [
    'response_format' => 'srt',
]);

$job = $client->fineTune('my-assistant', '/path/to/training.jsonl', [
    'model' => 'gpt-4.1-mini',
]);

$jobId = $job['id'];
echo 'Job started: ' . $jobId;

$job = $client->fineTuneDataset([
    ['input' => 'What is your name?', 'output' => 'I am Lumi.'],
    ['input' => 'Who made you?',       'output' => 'Nanoblock Technology Ltd.'],
], [
    'suffix' => 'lumi-v1',
    'model'  => 'gpt-4.1-mini',
]);

$status = $client->fineTuneStatus($job['id']);

if ($status['status'] === 'succeeded') {
    $modelName = $status['fine_tuned_model'];
    echo 'Model ready: ' . $modelName;
}

$fileId = $client->upload('/path/to/training.jsonl', 'fine-tune');
echo 'Uploaded file ID: ' . $fileId;

$files = $client->files(['purpose' => 'fine-tune']);

foreach ($files as $file) {
    echo $file['id'] . ' — ' . $file['filename'] . PHP_EOL;
}

$meta = $client->file('file-abc123');
echo $meta['filename'];

// Stream to string
$content = $client->download('file-abc123');

// Save to disk
$ok = $client->download('file-abc123', '/tmp/downloaded.jsonl');

$deleted = $client->delete('file-abc123');
var_dump($deleted); // bool(true)

$models = $client->models();

foreach ($models as $model) {
    echo $model['id'] . PHP_EOL;
}

$info = $client->model('gpt-4.1-mini');
print_r($info);

use Luminova\Exceptions\AIException;

try {
    $reply = $client->message('Hello!');
} catch (AIException $e) {
    echo 'OpenAI Error: ' . $e->getMessage();
}

protected array $endpoints = [
    'responses'  => 'responses',
    'models'     => 'models',
    'images'     => 'images',
    'speech'     => 'audio/speech',
    'transcribe' => 'audio/transcriptions',
    'embeddings' => 'embeddings',
    'fineTune'   => 'fine_tuning/jobs',
    'files'      => 'files',
];

public __construct(string $apiKey, ?string $organization = null, ?string $project = null): mixed

use Luminova\AI\Client\OpenAI;

$client = new OpenAI(apiKey: env('OPENAI_KEY'), organization: 'org-abc123');

$reply  = $client->message('Hello, OpenAI!');

public upload(string $filename, string $purpose = 'fine-tune', array $options = []): string|null

$fileId = $client->upload('/path/to/training.jsonl');
$job    = $client->fineTune('my-model', $fileId);

public files(array $options = []): array

$files = $client->files(['purpose' => 'fine-tune']);
foreach ($files as $file) {
    echo $file['id'] . ' — ' . $file['filename'] . PHP_EOL;
}

public file(string $fileId, array $options = []): array

$meta = $client->file('file-abc123');
echo $meta['filename']; // training.jsonl

public download(string $fileId, ?string $saveTo = null): string|bool

// Stream to string
$content = $client->download('file-abc123');

// Save to disk
$ok = $client->download('file-abc123', '/tmp/downloaded.jsonl');

public delete(string $fileId): bool

$deleted = $client->delete('file-abc123');