PHP Luminova: Anthropic AI Client Integration

use Luminova\AI\Client\Anthropic;

$client = new Anthropic(apiKey: env('ANTHROPIC_API_KEY'));

$client = new Anthropic(
    apiKey:  env('ANTHROPIC_API_KEY'),
    version: '2023-06-01', // Optional, defaults to 2023-06-01
);

$client = new Anthropic(
    apiKey:       env('ANTHROPIC_API_KEY'),
    betaFeatures: 'interleaved-thinking-2025-05-14',
);

use Luminova\AI\AI;

$reply = AI::message('Hello from Claude!');

$client->setBetaFeatures('interleaved-thinking-2025-05-14');
$reply = $client->message('Reason step by step: what is 17 × 43?');

$client->setBetaFeatures(null);

$reply = $client->message('Summarize the Stoic philosophy in two sentences.');
echo $reply[0]['text'] ?? '';

$reply = $client->chat([
    ['role' => 'system',    'content' => 'You are a concise Python tutor.'],
    ['role' => 'user',      'content' => 'What is a list comprehension?'],
    ['role' => 'assistant', 'content' => 'A compact way to create lists using a single line...'],
    ['role' => 'user',      'content' => 'Show me a practical example.'],
]);

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

$reply = $client->chat('Write a limerick about APIs.', [
    'model'       => 'claude-sonnet-4-6',
    'max_tokens'  => 256,
    'temperature' => 0.9,
]);

$reply = $client->chat(
    [['role' => 'user', 'content' => 'Who are you?']],
    ['system' => 'You are Lumi, a helpful Luminova assistant.']
);

$results = $client->webSearch('Latest Claude model releases');
print_r($results);

$results = $client->webSearch('Current ringgit exchange rate', [
    'allowed_domains' => ['bnm.gov.my', 'xe.com'],
    'user_location'   => [
        'type'     => 'approximate',
        'city'     => 'Kuala Lumpur',
        'country'  => 'MY',
        'timezone' => 'Asia/Kuala_Lumpur',
    ],
    'max_uses' => 3,
]);

$results = $client->webSearch('PHP security best practices', [
    'blocked_domains' => ['w3schools.com'],
]);

$results = $client->webSearch('Open source licenses compared', [
    'search_tool' => 'web_search_20250305',
]);

$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' => 'claude-sonnet-4-6']
);

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',
    ]
);

$batch = $client->batch([
    [
        'custom_id' => 'req-001',
        'params'    => [
            'model'      => 'claude-haiku-4-5-20251001',
            'max_tokens' => 128,
            'messages'   => [['role' => 'user', 'content' => 'Translate "hello" to French.']],
        ],
    ],
    [
        'custom_id' => 'req-002',
        'params'    => [
            'model'      => 'claude-haiku-4-5-20251001',
            'max_tokens' => 128,
            'messages'   => [['role' => 'user', 'content' => 'Translate "hello" to Spanish.']],
        ],
    ],
]);

$batchId = $batch['id'];
echo 'Batch submitted: ' . $batchId;

do {
    $status = $client->batchStatus($batchId);
    echo 'Status: ' . $status['processing_status'] . PHP_EOL;
    sleep(5);
} while ($status['processing_status'] === 'in_progress');

echo 'Results available at: ' . $status['results_url'];

$result = $client->cancelBatch('msgbatch_abc123');
echo 'Cancellation requested. Status: ' . $result['processing_status'];

$models = $client->models();

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

$info = $client->model('claude-sonnet-4-6');
print_r($info);

use Luminova\Exceptions\AIException;

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

protected array $endpoints = [
    'messages' => 'messages',
    'models'   => 'models',
    'batches'  => 'messages/batches',
];

public __construct(string $apiKey, string $version = null, ?string $betaFeatures = null): mixed

$client = new Anthropic(apiKey: env('ANTHROPIC_API_KEY'));

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

$client = new Anthropic(
    apiKey:  env('ANTHROPIC_API_KEY'),
    betaFeatures: 'interleaved-thinking-2025-05-14',
);

$reply = $client->message('Reason carefully: what is 17 × 43?');

public setBetaFeatures(?string $features): static

public batch(array $requests, array $options = []): array

public batchStatus(string $batchId): array

public cancelBatch(string $batchId): array