عميل DeepSeek PHP

🚀 حزمة SDK لـ PHP مدعومة من المجتمع لتكامل واجهة برمجة التطبيقات الذكية DeepSeek

فهرس المحتويات

✨ المميزات
📦 التثبيت
🚀 البداية السريعة
🆕 دليل الترحيل
📝 سجل التغييرات
🧪 الاختبارات
🔒 الأمان
🤝 المساهمين
📄 الرخصة

✨ المميزات

تكامل API سلس: واجهة تعتمد على PHP لميزات الذكاء الاصطناعي في DeepSeek.
نمط الباني السلس: أساليب قابلة للسلسلة لبناء الطلبات بطريقة بديهية.
جاهز للمؤسسات: تكامل مع عميل HTTP متوافق مع PSR-18.
مرونة النماذج: دعم لعدة نماذج من DeepSeek (Coder, Chat, وغيرها).
جاهز للبث: دعم مدمج للتعامل مع الردود في الوقت الفعلي.
العديد من عملاء HTTP: يمكنك استخدام عميل Guzzle http client (افتراضي) أو symfony http client بسهولة.
متوافق مع الأطر: حزم Laravel و Symfony متاحة.

📦 التثبيت

قم بتثبيت الحزمة عبر Composer:

composer require deepseek-php/deepseek-php-client

المتطلبات:

PHP 8.1+

🚀 البداية السريعة

الاستخدام الأساسي

ابدأ مع سطرين من الكود فقط:

use DeepSeek\DeepSeekClient;

$response = DeepSeekClient::build('your-api-key')
    ->query('Explain quantum computing in simple terms')
    ->run();

echo $response;

📌 الإعدادات الافتراضية المستخدمة:

النموذج: deepseek-chat
الحرارة: 0.8

التكوين المتقدم

use DeepSeek\DeepSeekClient;
use DeepSeek\Enums\Models;

$client = DeepSeekClient::build(apiKey:'your-api-key', baseUrl:'https://api.deepseek.com/v3', timeout:30, clientType:'guzzle');

$response = $client
    ->withModel(Models::CODER->value)
    ->withStream()
    ->withTemperature(1.2)
    ->query('Explain quantum computing in simple terms')
    ->run();

echo 'API Response:'.$response;

الاستخدام مع عميل HTTP من Symfony

الحزمة مبنية مسبقاً مع symfony Http client، فإذا كنت بحاجة إلى استخدامها مع عميل HTTP الخاص بـ Symfony، فيمكن تحقيق ذلك بسهولة عن طريق تمرير clientType:'symfony' إلى دالة build.

مثال باستخدام Symfony:

//  مع القيم الافتراضية للـ baseUrl و timeout
$client = DeepSeekClient::build('your-api-key', clientType:'symfony')
// مع التخصيص
$client = DeepSeekClient::build(apiKey:'your-api-key', baseUrl:'https://api.deepseek.com/v3', timeout:30, clientType:'symfony');

$client->query('Explain quantum computing in simple terms')
       ->run();

الحصول على قائمة النماذج

use DeepSeek\DeepSeekClient;

$response = DeepSeekClient::build('your-api-key')
    ->getModelsList()
    ->run();

echo $response; // {"object":"list","data":[{"id":"deepseek-chat","object":"model","owned_by":"deepseek"},{"id":"deepseek-reasoner","object":"model","owned_by":"deepseek"}]}