واجهة برمجية تعرف شكلها من أول طلب

نادِ المحرك بمفتاح 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"

المصادقة والعزل

كل منتج أو عميل يأخذ مفتاحاً خاصاً. لا يُرسل المفتاح إلى المتصفح في صفحة العرض؛ الحقن يتم من جهة الخادم. لا تضع المفاتيح في مستودعات عامة.

تفاصيل الأمان والاستضافة