مرجع APIتحويل النص إلى كلامتحويل النص إلى كلام في الوقت الفعلي
تحويل النص إلى كلام في الوقت الفعلي v1
صيانة العملاء الذين ما زالوا يستخدمون بروتوكول Realtime TTS WebSocket v1 المجمّد.
Realtime TTS v1 هو عقد توافق مجمّد للعملاء الحاليين. يجب أن تستخدم التكاملات الجديدة عقد v3 في الصفحة الأعلى؛ أحداث وحقول v1 وv2 وv3 غير قابلة للتبادل.
العنوان والمصادقة والترميز
| العنصر | القيمة |
|---|---|
| WebSocket | wss://realtime.fishaudio.org/v1/tts/live |
| البروتوكول الفرعي | realtime.tts.msgpack.v1 |
| الترميز | إطارات MessagePack ثنائية |
Authorization: Bearer FISHAUDIO_API_KEY
Sec-WebSocket-Protocol: realtime.tts.msgpack.v1لا تضع بيانات الاعتماد في عنوان URL أو في شيفرة المتصفح.
تسلسل الأحداث
authenticated → start → ready → text → flush → audio → usage → stop → finishأحداث العميل هي start وtext وflush وstop وping. أحداث الخادم هي authenticated وready وaudio وusage وpong وwarning وfinish وerror. توجد بيانات الصوت في audio.data، ويمكن إرسال عدة مقاطع text ثم flush قبل stop.
start.request
| الحقل | القاعدة |
|---|---|
model_id | UUID عام مطلوب للصوت/النموذج؛ يُقبل modelId أيضًا. |
engine_model_id | اختياري؛ الاسم البديل engineModelId. |
format | mp3 أو wav أو pcm أو opus؛ الافتراضي mp3. |
speed / volume | 0.5–2 / 0–10. |
language | من 1 إلى 32 محرفًا. |
chunk_length | عدد صحيح من 100 إلى 300. |
latency | normal أو balanced. |
جميع الرسائل خرائط MessagePack وتُرفض الحقول غير المعروفة. تتم التسوية لكل مقطع flush مقبول؛ لا يوفر v1 إعادة تشغيل دائمة أو idempotency للمقاطع. تتضمن الأخطاء code وmessage وretryable. انتقل إلى Realtime TTS v3 للميزات الجديدة.