واجهة برمجية تعرف شكلها من أول طلب
نادِ المحرك بمفتاح Bearer على مسارات /v1. الأمثلة أدناه للتوضيح. اسم المضيف العام للواجهة سيُثبت عند الإطلاق؛ اليوم التجربة تتم عبر صفحة العرض.
المضيف api.muwakilai.com أدناه مثال للشكل النهائي، وليس نقطة نهاية إنتاج معلنة بعد.
نقاط الواجهة الرئيسية (REST /v1)
| المسار | الوظيفة |
|---|---|
POST /v1/chat/completions | محادثة نصية قياسية مع دعم الأدوات |
POST /v1/audio/speech | تحويل النص لصوت بـ 8 أصوات أو صوت مستنسخ |
POST /v1/audio/transcriptions | تحويل الصوت لنص (WAV, WebM, M4A, MP3) |
POST /v1/embeddings | تمثيل متجهي للنصوص وقاعدة المعرفة |
POST /v1/agents/{id}/chat | محادثة الوكيل مع SSE، الأدوات، والذاكرة |
POST /v1/voices | حفظ صوت مستنسخ من مقطع 3–6 ثوانٍ بموافقة |
GET /v1/conversations/{id}/analysis | ملخص المكالمة، المشاعر، والبيانات المستخرجة |
إكمال محادثة
curl https://api.muwakilai.com/v1/chat/completions \
-H "Authorization: Bearer $MUWAKIL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "muwakil-chat",
"messages": [
{"role": "system", "content": "جاوب باللهجة الأردنية ومن معلومات المتجر فقط."},
{"role": "user", "content": "شو ساعات العمل يوم الخميس؟"}
]
}' تحويل النص إلى كلام
curl https://api.muwakilai.com/v1/audio/speech \
-H "Authorization: Bearer $MUWAKIL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "muwakil-voice",
"voice": "omar",
"dialect": "jo",
"input": "طلب رقم سبعة تسعة خمسة اثنين بخمسطعش دينار"
}' --output reply.wav تحويل الصوت إلى نص (STT)
curl https://api.muwakilai.com/v1/audio/transcriptions \
-H "Authorization: Bearer $MUWAKIL_API_KEY" \
-F "file=@call.wav" \
-F "language=ar" محادثة الوكيل المتدفقة (SSE)
curl -N https://api.muwakilai.com/v1/agents/agent_store_jo/chat \
-H "Authorization: Bearer $MUWAKIL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"message": "بدي أتأكد من طلبي رقم 4821",
"stream": true
}' ملخص المكالمة وتحليل المشاعر
curl https://api.muwakilai.com/v1/conversations/conv_91f2a8/analysis \
-H "Authorization: Bearer $MUWAKIL_API_KEY" المصادقة والعزل
كل منتج أو عميل يأخذ مفتاحاً خاصاً. لا يُرسل المفتاح إلى المتصفح في صفحة العرض؛ الحقن يتم من جهة الخادم. لا تضع المفاتيح في مستودعات عامة.