اختيار سير العمل
| سير العمل | النقطة | استخدمه عندما |
|---|---|---|
| النص إلى كلام | POST /v1/audio/speech | تحتاج إلى ملف صوتي من نص. |
| التفريغ | POST /v1/audio/transcriptions | تحتاج إلى نص من ملف صوتي. |
| ترجمة الصوت | POST /v1/audio/translations | تحتاج إلى نص مترجم من ملف صوتي. |
| جلسة وقت فعلي | GET /v1/realtime | تحتاج إلى صوت ثنائي الاتجاه أو أحداث متعددة الوسائط في الوقت الفعلي. |
اكتشاف النماذج
استعلم عن كتالوج النماذج قبل تثبيت نموذج في الكود. استخدم القوائم الموصى بها للكلام والتفريغ، وتحقق من دعم الوقت الفعلي في تفاصيل النموذج قبل فتح socket.طلبات الصوت المتزامنة
تعيد طلبات الكلام والتفريغ والترجمة النتيجة مباشرة من طلب HTTP. قد تستغرق المدخلات الكبيرة وقتًا أطول من مهلات العملاء الشائعة، لذلك عيّن مهلة واسعة واحفظ request IDs للدعم.جلسات الوقت الفعلي
افتح WebSocket مع model في query string ومفتاح API في ترويسة Authorization. استخدم تنسيق الأحداث الموثق للنموذج الفعلي المختار وأغلق socket عند انتهاء الجلسة.معالجة الحالة
- احفظ ملفات الصوت الناتجة بدل إعادة نفس الطلب عند التحديث.
- للتفريغ والترجمة، اعرض حالات الرفع والمعالجة حتى عندما يكون استدعاء API متزامنًا.
- في الوقت الفعلي، عالج أحداث الإغلاق ولا تعاود الاتصال إلا عندما يبدأ المستخدم جلسة جديدة.
- لا تضع مفاتيح API أو URLs خاصة أو أسرار الحساب في نص الصوت.
مرجع API
| الموضوع | المرجع |
|---|---|
| إنشاء كلام | إنشاء كلام |
| إنشاء تفريغ | إنشاء تفريغ |
| إنشاء ترجمة | إنشاء ترجمة |
| WebSocket وقت فعلي | WebSocket وقت فعلي |
| عرض النماذج | عرض النماذج |
| الفوترة والتسعير | الفوترة والتسعير |