توثيق Voice API

• Authorization: Bearer [token] أو مصادقة مفتاح API
• Content-Type: application/json
• X-Scope-Type: personal | workspace
• X-Workspace-ID: مطلوب إذا كان النطاق workspace

{
  "message": "Book a follow-up call tomorrow",
  "session_id": "sess_123",
  "stream": true,
  "voice": {
    "input_format": "wav",
    "output_format": "wav",
    "sample_rate": 16000
  },
  "metadata": {
    "lang": "en",
    "client": "web"
  }
}

{
  "success": true,
  "session_id": "sess_123",
  "content": "Sure — I scheduled a follow-up for tomorrow.",
  "provider": "openai",
  "usage": {
    "input_tokens": 210,
    "output_tokens": 96
  },
  "metadata": {
    "latency_ms": 842
  }
}

• session.started — تم بدء الجلسة الصوتية
• stt.partial — جزء تفريغ صوتي جزئي
• llm.delta — أجزاء نصية متدفقة من النموذج
• tts.chunk — مقطع صوتي مُولّد
• session.completed — النتيجة النهائية مع الاستهلاك

الإيقاف يوقف التوليد الصوتي الجاري لجلسة محددة مع تحرير مسار التنفيذ بأمان.

POST /api/v1/voice/interrupt/{session_id}

{
  "reason": "user_barge_in"
}

• الصيغة الموصى بها للإدخال: WAV (PCM16, mono, 16kHz).
• المدخلات غير WAV يمكن تحويلها قبل STT.
• صيغة الإخراج تعتمد على المزود وإعدادات التشغيل.
• الأحجام الكبيرة قد تعيد 413.

curl -X POST "/api/v1/voice/chat" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -H "X-Scope-Type: personal" \
  -d '{
    "message":"Summarize this call",
    "session_id":"sess_123",
    "stream":false
  }'