نظرة عامة

Ahmaedinfo هي مكتبة بايثون متطورة توفر واجهة برمجية (API) للتواصل السلس مع نموذج الذكاء الاصطناعي المعدل من DeepSeek 3v. يهدف هذا الدليل إلى تمكين المطورين من بناء خدمات وسيطة (Microservices) باستخدام بايثون، ومن ثم استدعاؤها بسهولة من تطبيقات الويب المختلفة مثل PHP أو Node.js.

المتطلبات التقنية

  • بيئة تشغيل Python 3.8+
  • مدير الحزم pip لتثبيت المكتبات
  • خادم ويب يدعم PHP 7.4+ (لواجهة العميل)
  • صلاحيات للاتصال عبر HTTP/HTTPS بين الخوادم

تثبيت المكتبة

نفذ الأمر التالي في التيرمينال لتثبيت أحدث إصدار:
BASH
pip install ahmaedinfo==1.0.5

استخدام المكتبة في بايثون

مثال كامل لكيفية تهيئة الـ Client وإرسال طلب:
PYTHON
from ahmaedinfo import Client

# إعداد العميل مع خيارات التخصيص
client = Client(
    api_key="ahmaedinfo", 
    timeout=30, 
    retries=3, 
    animate=False, 
    color=False
)

message = "اكتب مقدمة قصيرة عن الذكاء الاصطناعي"
reply = client.ask(message)

print(reply)
تأكد دائماً من التحقق من نوع الاستجابة (String أو Error) قبل عرضها للمستخدم النهائي.

خادم API جاهز (Flask)

قم بإنشاء ملف server.py ليكون نقطة الاتصال بين تطبيقك والمكتبة:
PYTHON / FLASK
from flask import Flask, request, jsonify
from ahmaedinfo import Client
import os

app = Flask(__name__)
api_key = os.environ.get("AHMAEDINFO_API_KEY", "ahmaedinfo")
client = Client(api_key=api_key, timeout=60, retries=3, animate=False, color=False)

@app.route("/ask", methods=["GET", "POST"])
def ask():
    if request.method == "POST":
        payload = request.get_json(force=True, silent=True) or {}
        message = payload.get("message", "")
    else:
        message = request.args.get("message", "")
        
    if not message:
        return jsonify({"error": "empty_message"}), 400
        
    try:
        resp = client.ask(message)
        return jsonify({"reply": resp})
    except Exception as e:
        return jsonify({"error": str(e)}), 500

if __name__ == "__main__":
    app.run(host="0.0.0.0", port=5000)
لتشغيل الخادم:
BASH
python server.py

اختبار الاتصال (CURL)

GET REQUEST
curl "http://localhost:5000/ask?message=مرحبا"
POST REQUEST
curl -X POST -H "Content-Type: application/json" \
-d '{"message":"ما هو الذكاء الاصطناعي؟"}' \
"http://localhost:5000/ask"

عميل PHP للاتصال

هذا الكود يمكنك وضعه في ملف index.php لإنشاء واجهة دردشة تتصل بخادم البايثون:
PHP
<?php
function call_ai_service($message) {
    $url = "http://localhost:5000/ask"; // قم بتغيير الرابط حسب الخادم
    
    // إعداد البيانات
    $data = json_encode(['message' => $message]);
    
    $options = [
        'http' => [
            'header'  => "Content-type: application/json\r\n",
            'method'  => 'POST',
            'content' => $data,
            'timeout' => 30
        ]
    ];
    
    $context  = stream_context_create($options);
    $result = @file_get_contents($url, false, $context);
    
    if ($result === FALSE) return "عذراً، الخادم غير متاح حالياً.";
    
    $response = json_decode($result, true);
    return $response['reply'] ?? "خطأ في قراءة الرد";
}

$reply = "";
if ($_SERVER['REQUEST_METHOD'] === 'POST' && !empty($_POST['q'])) {
    $reply = call_ai_service($_POST['q']);
}
?>
<!-- كود HTML للنموذج -->
<form method="post">
    <input type="text" name="q" placeholder="سؤالك..." required>
    <button type="submit">إرسال</button>
</form>
<?php if($reply): ?>
    <div class="reply"><?= nl2br(htmlspecialchars($reply)) ?></div>
<?php endif; ?>

الخصوصية والدعم

خصوصية تامة

لا نقوم بتخزين أي بيانات شخصية، الاتصال مشفر وآمن.

وسيط ذكي

تعمل المكتبة كجسر ذكي بين تطبيقك ونماذج الذكاء الاصطناعي.

مجاني للجميع

نسعى لتوفير التقنيات المدفوعة بشكل مجاني للمجتمع العربي.

ادعم استمرار المشروع

مساهمتك تساعدنا في تغطية تكاليف الخوادم وتطوير نماذج أفضل.

تم نسخ الكود بنجاح