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

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

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

دليل استخدام واجهة برمجة التطبيقات (API)
للحصول على مفتاح API، انتقل إلى صفحة «مفاتيح API» وانقر على زر إنشاء مفتاح API جديد:

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

يمكنك استخدام المفتاح الذي تم إنشاؤه ونقطة النهاية (Endpoint) المحددة في مختلف التطبيقات والخدمات التي تطورها، مثل روبوتات الدردشة (Chatbots)، والمساعدين الأذكياء (AI Assistants)، والوكلاء الأذكياء (AI Agents)، وإضافة القدرات الفريدة لأفضل نماذج الذكاء الاصطناعي إليها بكل سهولة. كما ستتمكن من الاستفادة من التحديثات المستقبلية لهذا المجال بأقل قدر من التعديل على الشيفرة البرمجية.
المصادقة
يجب أن تتضمن جميع الطلبات الترويسة (Header) التالية:
Authorization: Bearer YOUR_API_KEY
استبدل 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"
}
]
}
نماذج التضمين (Embedding)
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
}
}
بروتوكول OpenAI Responses
بالإضافة إلى 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
تدعم الخدمة أيضاً بروتوكول 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": "اكتب دالة بلغة بايثون لعكس السلسلة النصية المدخلة."}
]
}'
النموذج الذي تختاره في حقل model يتم استخراجه من كتالوج كوبيت ولا يقتصر بالضرورة على الشركة المطوّرة لهذا البروتوكول؛ على سبيل المثال، يمكنك استدعاء نموذج Gemini عبر /responses أو استدعاء نموذج GPT عبر /messages.
ربط أدوات البرمجة الذكية
Codex
أنشئ ملف ~/.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
اكتب قيمة base_url حتى /api/v1 فقط؛ حيث يقوم Codex تلقائياً بإضافة مسار /responses إلى نهايتها.
Claude Code
يكفي ضبط متغيرات البيئة التالية ليتصل 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": "هل يمكنك إخباري ما هي خدمات كوبيت؟"}
]
}'
المزايا
- تقليل وقت التطوير وتكاليف البنية التحتية
- الوصول إلى أحدث النماذج دون القلق بشأن التحديثات والصيانة
- مناسب لفرق التطوير، والشركات الناشئة، والمؤسسات القابلة للتوسع
- التبديل السريع والمرن بين النماذج المختلفة
- أمان البيانات وحماية الخصوصية
- إنشاء قاعدة معرفة مخصصة لتقديم إجابات أكثر دقة وملاءمة
- دعم فني واستشارات متخصصة