README

A modern PHP client for DeepSeek's AI API, featuring robust error handling and full PSR compliance.

📦 Installation

Requires PHP 7.4+ and Composer:

composer require solicode/deepseek-php-client

🔑 Authentication

Get your API key from DeepSeek Dashboard.

Never commit secrets - store in environment variables.

🚀 Basic Usage

<?php

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

use SoliCode\DeepSeekClient;

try {
    // Initialize client
    $client = new DeepSeekClient('your-api-key');

    // List available models
    $models = $client->models();
    echo "<pre>Available models:\n";
    print_r($models['data']);
    echo "</pre>";

    // Generate chat completion
    $response = $client->chat(
        model: 'deepseek-chat',
        messages: [
            ['role' => 'user', 'content' => 'Explain quantum entanglement simply']
        ]
    );

    echo "<pre>\nResponse:\n" . htmlspecialchars($response['choices'][0]['message']['content']) . "</pre>";

} catch (InsufficientBalanceException $e) {
    die("<pre>Error: Add funds to your DeepSeek account</pre>");
} catch (\Exception $e) {
    die("<pre>Error: " . htmlspecialchars($e->getMessage()) . "</pre>");
}

📖 Advanced Features

Custom Request Configuration

$client = new DeepSeekClient(
    apiKey: 'your-key',
    baseUrl: 'https://api.deepseek.com/v1', // Custom endpoint
    timeout: 15, // Seconds
    headers: ['X-Custom-Header' => 'value']
);

Streaming Responses

$stream = $client->chat(
    'deepseek-chat',
    [['role' => 'user', 'content' => 'Explain recursion']],
    ['stream' => true]
);

foreach ($stream as $chunk) {
    echo $chunk['choices'][0]['delta']['content'] ?? '';
}

Error Handling Hierarchy

try {
    // API operations
} catch (InsufficientBalanceException $e) {
    // Handle payment issues (402 errors)
} catch (InvalidRequestException $e) {
    // Handle bad parameters (400 errors)
} catch (AuthenticationException $e) {
    // Handle invalid API keys (401 errors)
} catch (APIConnectionException $e) {
    // Handle network issues
} catch (\Exception $e) {
    // Generic fallback
}

🛠 Development

Running Tests

composer test

Code Quality Checks

composer check-style
composer fix-style

Contributing

1. Fork the repository.
2. Create a feature branch (feat/your-feature).
3. Write tests for new features.
4. Submit a pull request.

📚 API Reference

DeepSeekClient Methods

⚠️ Common Errors

📜 License

MIT License - See LICENSE for full text.

Developed with ❤️ by SoliCode • Report issues here