إرسال الطلبات إلى API متوافق مع OpenAI باستخدام curl

يشرح هذا الدليل كيفية إرسال الطلبات إلى خادم كاكوتي المتوافق مع OpenAI باستخدام أمر curl.

🔧 المتطلبات الأساسية

1. الحصول على مفتاح API (رمز الوصول) الذي تلقيته من لوحة تحكم كاكوتي.
2. تثبيت أداة curl على نظامك (عادة ما تكون مثبتة مسبقًا على Linux و Mac).
3. المعرفة الأساسية بإرسال طلبات HTTP.

🧭 عنوان Base URL

استخدم العنوان التالي لإرسال الطلبات:

Base URL

https://llm-api.kakoti.com/v1

🧰 إرسال الطلبات

أرسل مفتاح API في رأس Authorization:

Authorization Header

Authorization: Bearer YOUR_API_KEY

📝 مثال على الطلب

cURL Example

curl -X POST https://llm-api.kakoti.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o-mini", "messages": [{"role": "user", "content": "مرحبا"}]}'

🔌 استخدام Postman أو Insomnia

إذا كنت تستخدم Postman أو Insomnia لإرسال طلبات HTTP، يمكنك استيراد الطلب باستخدام أمر curl المذكور أعلاه.

🧾 شرح أجزاء الأمر المختلفة

📤 استجابة الخادم

عند النجاح، تكون الاستجابة عادة بالتنسيق التالي:

{
  "id": "chatcmpl-12345",
  "object": "chat.completion",
  "created": 1731000000,
  "model": "gpt-4o-mini",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "مرحبا! كيف يمكنني مساعدتك؟"
      },
      "finish_reason": "stop"
    }
  ]
}