Skip to main content
GET

نظرة عامة

استخدم نقطة النهاية هذه لجلسات الوقت الفعلي مثل التعرّف على الكلام بالبث، وتركيب الكلام، وترجمة الكلام، أو النماذج متعددة الوسائط في الوقت الفعلي. يعيد طلب GET العادي بيانات وصف نقطة النهاية، بينما يفتح طلب ترقية WebSocket جلسة في الوقت الفعلي للنموذج المحدد.

النطاق المدعوم

يوفّر TokenLab نقطة WebSocket فورية على GET /v1/realtime لفحص metadata وطلبات ترقية WebSocket. تعامل معها كسطح WebSocket محدود (WebSocket subset): فهي تمرّر أحداث نماذج realtime المدعومة فقط، ولا تدعم أسطح مساعدات REST في OpenAI Realtime مثل إنشاء الجلسات، أو client_secrets، أو واجهات التحكم بالمكالمات Calls، أو legacy beta session APIs. في تطبيقات المتصفح أو الجوال، احتفظ بمفاتيح API طويلة العمر على الخادم. هذا المسار لا يصدر Realtime client secrets قصيرة العمر.
اختر نموذجًا فوريًا حاليًا من /v1/models، وتحقق من /v1/models/{model} ثم اضبط TOKENLAB_REALTIME_MODEL. تعتمد أحداث الجلسة وإعداداتها على النموذج. مثال JSON أدناه لاستجابة HTTP GET عادية، وليس حدث جلسة WebSocket.

الاتصال

string
مطلوب
معرّف نموذج realtime. استخدم نموذجاً يعلن عقده العام دعم realtime.
string
مطلوب
مفتاح API بصيغة Bearer. يجب أن يرسل عميل WebSocket ترويسة Authorization: Bearer sk-your-api-key أثناء طلب الترقية.

الرسائل

ينقل TokenLab رسائل WebSocket بين عميلك والنموذج الفوري المحدد. استخدم تنسيق الأحداث الموثّق لذلك النموذج، وأدرج model في سلسلة الاستعلام بدلاً من إدراجه في كل حدث.

الفوترة والإغلاق

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

مثال الاستجابة

حقول مهمة

string
نوع الكائن في استجابة HTTP GET العادية. قيمته الثابتة هي realtime.endpoint.
string
مسار اتصال WebSocket النسبي الذي يعيده طلب HTTP GET عادي: /v1/realtime?model={model}. استبدل {model} بمعرّف النموذج المحدد.
string
معرّف البروتوكول الذي يعيده طلب HTTP GET عادي. قيمته الثابتة هي tokenlab_realtime_proxy.
string
نوع الحدث أو الرسالة الذي تعيده API.
string
معرّف مبهم يتم استلامه عبر اتصال realtime. ضمّنه في سجلات الدعم لتسهيل التشخيص؛ وليس عنوان URL لجلسة REST.

التفويضات

Authorization
string
header
مطلوب

API Key authentication. Create or manage API keys in Dashboard > API > API Keys.

معلمات الاستعلام

model
string

Realtime model ID to route the WebSocket session. Required for WebSocket upgrade requests; optional for plain HTTP metadata checks.

الاستجابة

WebSocket connection established