الذكاء الاصطناعي (AI)

تُعدّ خدمة الذكاء الاصطناعي منصة سحابية وقابلة للتوسع للوصول إلى نماذج الذكاء الاصطناعي المتقدمة. تساعد هذه الخدمة المطورين وأصحاب الأعمال والشركات الناشئة على الاستفادة بسهولة من قدرات نماذج اللغة الكبيرة (LLM) دون الحاجة إلى بنية تحتية معقدة. باستخدام هذه الخدمة، يمكنك بسهولة اختبار مختلف النماذج والدردشة معها، بل وحتى إنشاء مساعدين أذكياء مخصصين يجيبون استناداً إلى قاعدة المعرفة الخاصة بك. توفر الخدمة واجهة برمجة تطبيقات (API) متوافقة مع معايير OpenAI، مما يتيح إمكانية التكامل السريع والسهل مع مختلف التطبيقات والأنظمة.

• توفير واجهة برمجة تطبيقات (API) سحابية للاستخدام السريع والسهل
• توافق كامل مع عملاء OpenAI الشائعة
• قابلية توسع عالية للاستخدام في المشاريع الصغيرة وحتى المؤسسات الكبيرة
• إمكانية التبديل السريع والمرن بين النماذج والمزودين (Providers) ونقاط النهاية (Endpoints) بأقل قدر من التغييرات
• دعم مختلف أنواع النماذج بما في ذلك النماذج اللغوية، ونماذج توليد الصور، والنماذج متعددة الوسائط

• واجهة مستخدم موحدة لاختبار النماذج والتحاور معها
• تقييم ومقارنة النماذج في بيئة بسيطة وسهلة الاستخدام
• الوصول إلى أكثر من 80 نموذجاً من أفضل النماذج من أبرز المزودين على مستوى العالم

• إنشاء مساعدين أذكياء بقدرات وإمكانيات متنوعة
• تقديم الإجابات بناءً على قاعدة المعرفة الخاصة بك
• التكامل مع مختلف الأنظمة والخدمات لرفع الإنتاجية
• دعم سيناريوهات متعددة مثل دعم العملاء، وإنشاء المحتوى، وتحليل البيانات

للحصول على مفتاح API، انتقل إلى صفحة «مفاتيح API» وانقر على زر إنشاء مفتاح API جديد:

ثم في النافذة المنبثقة، اختر اسماً اختيارياً لمفتاحك واضغط على زر إنشاء مفتاح API جديد. أصبح مفتاحك جاهزاً الآن:

يمكنك استخدام المفتاح الذي تم إنشاؤه ونقطة النهاية (Endpoint) المحددة في مختلف التطبيقات والخدمات التي تطورها، مثل روبوتات الدردشة (Chatbots)، والمساعدين الأذكياء (AI Assistants)، والوكلاء الأذكياء (AI Agents)، وإضافة القدرات الفريدة لأفضل نماذج الذكاء الاصطناعي إليها بكل سهولة. كما ستتمكن من الاستفادة من التحديثات المستقبلية لهذا المجال بأقل قدر من التعديل على الشيفرة البرمجية.

يجب أن تتضمن جميع الطلبات الترويسة (Header) التالية:

Authorization: Bearer YOUR_API_KEY

curl https://ai.kubit.cloud/api/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant"},
      {"role": "user", "content": "مرحباً! هل يمكنك سرد قصة قصيرة؟"}
    ]
  }'

نموذج الاستجابة:

{
  "id": "chatcmpl-12345",
  "object": "chat.completion",
  "created": 1758730329,
  "model": "openai/gpt-5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "كان يا ما كان في قديم الزمان..."
      },
      "finish_reason": "stop"
    }
  ]
}

curl https://ai.kubit.cloud/api/v1/embeddings \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/text-embedding-3-small",
    "input": ["نص نموذجي لتوليد متجهات التضمين", "النص الثاني لتوليد متجهات التضمين"]
  }'

نموذج الاستجابة:

{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "embedding": [0.123, 0.456, ...],
      "index": 0
    },
    {
      "object": "embedding",
      "embedding": [0.789, 0.012, ...],
      "index": 1
    }
  ],
  "model": "openai/text-embedding-3-small",
  "usage": {
    "prompt_tokens": 10,
    "total_tokens": 10
  }
}

بالإضافة إلى chat/completions، تدعم الخدمة أيضاً بروتوكول OpenAI Responses. يُستخدم هذا البروتوكول في الأدوات التي تتصل مباشرةً مع Responses API (مثل Codex):

curl https://ai.kubit.cloud/api/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-2.5-flash",
    "input": "اكتب دالة بلغة بايثون لعكس السلسلة النصية المدخلة."
  }'

تدعم الخدمة أيضاً بروتوكول Anthropic Messages لتمكين الأدوات التي تدعم Messages API بشكل أصلي (مثل Claude Code) من الاتصال دون الحاجة لتعديل الشيفرة. في هذا البروتوكول، يمكن إرسال المفتاح أيضاً عبر ترويسة x-api-key:

curl https://ai.kubit.cloud/api/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "اكتب دالة بلغة بايثون لعكس السلسلة النصية المدخلة."}
    ]
  }'

استخدم المسار https://ai.kubit.cloud/api/v1/decisions لتصنيف النصوص أو اختيار إجابة محددة. يقبل هذا المسار بروتوكول OpenAI Decisions: تُرسل المدخلات في input والأسئلة ضمن مصفوفة questions. يمكن أن يكون نوع السؤال predicate لتقييم صحة عبارة، أو choice لاختيار أحد الخيارات، أو score لإعطاء درجة. يجب أن يدعم النموذج المختار اتخاذ القرارات؛ ابحث عن معرّفه في قائمة النماذج على https://ai.kubit.cloud/api/v1/models.

في المثال التالي، يختار النموذج أولوية طلب دعم من خيارين: urgent وnormal. تحدد value معرّف الخيار في الاستجابة، بينما توضح description متى ينبغي اختياره. استبدل YOUR_API_KEY بمفتاح API الخاص بك في كوبيت:

curl -i -sS https://ai.kubit.cloud/api/v1/decisions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-6-luna-decisions",
    "input": "I cannot sign in and my entire team is unable to work. We have no workaround.",
    "questions": [{
      "type": "choice",
      "name": "priority",
      "instructions": "Classify the support request by its impact on the customer.",
      "choices": [
        {"value": "urgent", "description": "Work is blocked and no workaround is available."},
        {"value": "normal", "description": "Work can continue or a workaround is available."}
      ]
    }]
  }'

تُعاد الإجابات ضمن مصفوفة answers وبترتيب الأسئلة نفسه. قد يظهر جزء answers من الاستجابة كما يلي؛ تشير choice إلى الخيار المحدد، وconfidence إلى مستوى الثقة، وprobabilities إلى احتمال كل خيار. هذه الأرقام توضيحية وقد تختلف بين الطلبات:

{
  "answers": [
    {
      "type": "choice",
      "name": "priority",
      "choice": "urgent",
      "confidence": 0.96,
      "probabilities": [
        {"value": "urgent", "probability": 0.96},
        {"value": "normal", "probability": 0.04}
      ]
    }
  ]
}

يمكن للعملاء الذين يستخدمون بروتوكول System One، مثل عملاء TypeSafe ونماذج اتخاذ القرارات من Microsoft، استخدام المسار https://ai.kubit.cloud/api/v1/systemone. تُرسل المدخلات في state، وتكون الأسئلة كائناً بمفاتيح تختار أسماءها، وتُعرّف خيارات السؤال من نوع choice في criteria. يدعم المسار أيضاً النوع noul لتقييم صحة عبارة والنوع score لإعطاء درجة.

يستدعي المثال التالي النموذج نفسه وبالخيارين نفسيهما الواردين في مثال OpenAI Decisions، ولكن بصيغة System One. لا يقتصر البروتوكول على نماذج الشركة التي طوّرته؛ يجب أن يدعم النموذج المختار هذا النوع من الطلبات:

curl -i -sS https://ai.kubit.cloud/api/v1/systemone \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-6-luna-decisions",
    "state": "I cannot sign in and my entire team is unable to work. We have no workaround.",
    "questions": {
      "priority": {
        "type": "choice",
        "instructions": "Classify the support request by its impact on the customer.",
        "criteria": {
          "urgent": "Work is blocked and no workaround is available.",
          "normal": "Work can continue or a workaround is available."
        }
      }
    }
  }'

تُعاد الإجابات بالمفاتيح نفسها المستخدمة في الأسئلة؛ في هذا المثال، يوجد الخيار المحدد في answers.priority.choice. قد يظهر جزء answers كما يلي. الحقلان confidence وprobabilities اختياريان في هذا البروتوكول، وقد لا يعيدهما المزوّد:

{
  "answers": {
    "priority": {
      "type": "choice",
      "choice": "urgent",
      "confidence": 0.96,
      "probabilities": {"urgent": 0.96, "normal": 0.04}
    }
  }
}

إذا كان العميل يضيف المسار v1/systemone تلقائياً، فاضبط عنوانه الأساسي على https://ai.kubit.cloud/api. أما إذا كان يضيف systemone فقط، فاستخدم https://ai.kubit.cloud/api/v1.

أنشئ ملف ~/.codex/config.toml (أو أضف إليه) المحتوى التالي:

model_provider = "kubit"
model = "google/gemini-2.5-flash"

[model_providers.kubit]
name = "kubit"
base_url = "https://ai.kubit.cloud/api/v1"

[model_providers.kubit.auth]
command = "sh"
args = ["-c", "echo $KUBIT_API_KEY"]

ثم عيّن مفتاحك في متغير البيئة وشغّل Codex:

export KUBIT_API_KEY="YOUR_API_KEY"
codex

يكفي ضبط متغيرات البيئة التالية ليتصل Claude Code بكوبيت بدلاً من خوادم Anthropic:

export ANTHROPIC_BASE_URL="https://ai.kubit.cloud/api"
export ANTHROPIC_API_KEY="YOUR_API_KEY"
export ANTHROPIC_MODEL="openai/gpt-5"
claude

لاستخدام قاعدة المعرفة الخاصة بك، يجب أولاً إنشاء قاعدة معرفة ورفع المحتوى المطلوب إليها. بعد ذلك، يمكنك إدراج المعرف الفريد (UUID) لقاعدة المعرفة في طلب الـ API لكي يتمكن النموذج من تقديم الإجابات بالاعتماد عليها:

curl https://ai.kubit.cloud/api/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5",
    "knowledge_base_uuid": "your_knowledge_base_uuid",
    "messages": [
      {"role": "user", "content": "هل يمكنك إخباري ما هي خدمات كوبيت؟"}
    ]
  }'

• تقليل وقت التطوير وتكاليف البنية التحتية
• الوصول إلى أحدث النماذج دون القلق بشأن التحديثات والصيانة
• مناسب لفرق التطوير، والشركات الناشئة، والمؤسسات القابلة للتوسع
• التبديل السريع والمرن بين النماذج المختلفة
• أمان البيانات وحماية الخصوصية
• إنشاء قاعدة معرفة مخصصة لتقديم إجابات أكثر دقة وملاءمة
• دعم فني واستشارات متخصصة