تجريبي
واجهة المكالمات الحية
تصفّح التوثيق
المكالمات الحية
ينشئ POST /v1/calls تذكرة قصيرة العمر (٣٠٠ ثانية) يستخدمها المتصفح لوصل الوسائط مباشرة إلى خادم الـGPU. مع وجود transport.sdp يصبح الإنشاء بطلية واحدة — يعود جواب SDP ضمن الاستجابة 201 (على نمط OpenAI Live).
يُرسَل العرض إلى call_url مع ترويسة x-call-token، وDELETE يُنهي المكالمة. عملاء WebSocket يتصلون عبر ws_url بدل ice_servers. وGET /v1/calls يعيد سجل مكالماتك الموثّق من الخادم.
POST /v1/calls
agent_idstring?الوكيل المخزّن الذي سيعمل؛ أو مرّر شخصية وصوتًا مباشرة.
promptstring?شخصية مباشرة حين لا تستخدم وكيلًا مخزّنًا.
transportobjectإما {"type": "webrtc", "sdp": "<offer>"} للإنشاء بطلية واحدة، أو {"type": "webrtc"} لتذكرة، أو {"type": "websocket"}.
recordingboolean?الافتراضي خطأ؛ ويتطلب أسطح موافقة عندك.
settingsobject?تجاوزات لكل مكالمة لإعدادات CallSettings للوكيل.
| الحقل | النوع | ملاحظات |
|---|---|---|
| agent_id | string? | الوكيل المخزّن الذي سيعمل؛ أو مرّر شخصية وصوتًا مباشرة. |
| prompt | string? | شخصية مباشرة حين لا تستخدم وكيلًا مخزّنًا. |
| transport | object | إما {"type": "webrtc", "sdp": "<offer>"} للإنشاء بطلية واحدة، أو {"type": "webrtc"} لتذكرة، أو {"type": "websocket"}. |
| recording | boolean? | الافتراضي خطأ؛ ويتطلب أسطح موافقة عندك. |
| settings | object? | تجاوزات لكل مكالمة لإعدادات CallSettings للوكيل. |
POST /v1/calls/{call_id}
DELETE /v1/calls/{call_id}
GET /v1/calls
curl -X POST https://api.sawtakarabi.ai/v1/calls \ -H "Authorization: Bearer $SAWTAK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"agent_id": "<agent_id>", "transport": {"type": "webrtc"}}'