نسخ RTC
يمكن لـ RTC تحويل صوت التسجيل إلى نص بعد انتهاء المكالمة. يتم تحويل صوت ميكروفون كل مشارك وصوت كل شاشة مشتركة إلى نص بشكل منفصل، بحيث تحدد كل سطر المتحدث بدقة. ويشترك شخصان يستخدمان ميكروفونًا واحدًا في تسمية المتحدث نفسه.
التعليقات التوضيحية المباشرة أثناء المكالمة غير متاحة للعملاء حتى الآن.
transcript.segment و captions.* تظل إشعارات الويب
مخطط لها.
قبل البدء في النسخ
Section titled “قبل البدء في النسخ”- يجب أن تكون دقائق النسخ متوفرة في الخطة: تشملها باقتا «Growth» و«Business»، ويمكن لأي فئة إضافة حزم.
- أبلغ المشاركين واحصل على الموافقة التي تتطلبها حالة الاستخدام الخاصة بك، سواء بشأن التسجيل أو النص. يجب أن يعرض تطبيقك مؤشرًا مرئيًا أثناء تشغيل التسجيل الذي سيتم تحويله إلى نص.
- يشارك المشاركون الذين لا يجب تدوين نصوصهم (مثل الأطفال، أو أي شخص رفض ذلك) مع
transcribe: falseالطلب.
طلب نسخة مكتوبة
Section titled “طلب نسخة مكتوبة”اطلب نسخة نصية عند بدء التسجيل، أو لاحقًا للحصول على نسخة من تسجيل انتهى.
| الطريقة والمسار | النطاق | النتيجة |
|---|---|---|
POST /v1/recordings مع "transcript": true | recordings:write | يبدأ التسجيل؛ ويتم طلب النص عند انتهائه |
POST /v1/recordings/{recordingId}/transcript | recordings:write | 202 { "recordingId", "status" } |
GET /v1/recordings/{recordingId}/transcript | recordings:read | النص وحالته (مقروء) |
GET /v1/recordings/{recordingId}/transcript?format=vtt | recordings:read | النص كملف (التنسيقات) |
GET /v1/transcripts | recordings:read | نصوصك، الأحدث أولاً، بدون النص نفسه. يتم استبعاد نصوص التسجيلات الموجودة في سلة المهملات، لذا قد تحتوي الصفحة على أقل من limit العناصر؛ تابع X-Next-Cursor |
نص الطلب اختياري:
{ "language": "de", "vocabulary": ["CHAMPREP", "Hocuspocus", "Dr. Okonkwo"] }| الحقل | القواعد |
|---|---|
language | A رمز اللغة، أو zh-Hant للصينية بالأحرف التقليدية. إذا تم تجاهلها، يقوم RTC باكتشاف لغة كل مشارك. |
vocabulary | التلميحات: ما يصل إلى 100 اسم، أو كلمة منتج، أو مصطلح، بحد أقصى 64 حرفًا لكل منها و1 كيلوبايت إجمالًا. تزيد التلميحات من احتمالية ظهور هذه الكلمات؛ لكنها لا تضمن صحة التهجئة. |
يمر النص المكتوب بهذه الحالات:
status | المعنى |
|---|---|
waiting | التسجيل لا يزال قيد التشغيل. يبدأ النص عند انتهاء التسجيل. |
reserving | تقوم RTC بحجز دقائق النص من رصيدك المخصص. |
queued | الدقائق المحجوزة؛ في انتظار كاتب النص. |
running | قيد النسخ. |
done | جاهز للقراءة. |
failed | لم يتم. error و errorCode اشرح السبب. النص الفاشل مجاني. |
يحتوي كل تسجيل على نص واحد. إذا سألت مرة أخرى في حين أن هناك نصًا موجودًا أو قيد التشغيل فستحصل على إجابات 409 TRANSCRIPT_EXISTS. اطلب مرة أخرى a فشل واحد ويقوم RTC بتشغيله مرة أخرى؛ يمكنك تغيير language و
vocabulary. التسجيل الذي لا يحتوي على صوت يُرد عليه 409
NO_AUDIO.
عادةً ما تكون مدة الإنجاز أقل بكثير من نصف مدة التسجيل زائد بضع دقائق. استخدم transcript.completed webhook بدلاً من الاستقصاء.
قراءة النص
Section titled “قراءة النص”GET /v1/recordings/{recordingId}/transcript تُرجع JSON (Cache-Control: no-store):
{ "recordingId": "REC_UUID", "status": "done", "language": "en", "billedMinutes": 42, "truncated": false, "durationMs": 2512000, "model": "faster-whisper-small", "completedAt": "2026-11-08T12:44:10.000Z", "segments": [ { "participantId": "PARTICIPANT_UUID", "identity": "user-123", "source": "microphone", "startMs": 61000, "endMs": 63400, "text": "Let's start with the roadmap." } ], "createdAt": "2026-11-08T12:00:00.000Z"}| الحقل | المعنى |
|---|---|
segments | السطور مرتبة زمنيًا: من (participantId، و identity عندما يكون لدى المشارك واحد)، الصوت source (microphone أو screen_audio)، متى (startMs, endMs من بداية التسجيل) و text |
language | اللغة السائدة، أو اللغة التي طلبتها (zh-Hant للصينية التقليدية) |
billedMinutes | الدقائق التي تم احتسابها لهذه الجلسة (الفوترة) |
truncated | true عندما ينفد الرصيد أثناء تشغيل يتسم بتداخل صوتي شديد؛ يتوقف النص عند هذا الحد |
error, errorCode | أسباب فشل التشغيل: RTC_ALLOWANCE_EXHAUSTED, BILLING_UNAVAILABLE, CANCELLED, RECORDING_LENGTH_UNKNOWN (وقت بدء التسجيل أو نهايته مفقود، لذا لا يمكن قياس أي شيء أو إصدار فاتورة)، أو عدم وجود رمز بسبب فشل في المعالجة |
request | ما تم طلبه في هذه الجلسة: language (غير موجود عند اكتشافه) و vocabulary، لذا يمكن إعادة المحاولة لإرسالها مرة أخرى |
النص هو ما قاله المشاركون. تعامل معه على أنه محتوى مستخدم غير موثوق به في تطبيقك.
التنسيقات
Section titled “التنسيقات”إضافة format لتصدير النص النهائي كملف. الإجابة عبارة عن مرفق باسم transcript-{recordingId}.{format}. النص المكتوب الذي لا
done الإجابات 409 TRANSCRIPT_NOT_READY
لكل تنسيق باستثناء json.
format | نوع المحتوى | المتحدثون |
|---|---|---|
json (افتراضي) | application/json | identity و participantId لكل مقطع |
vtt | text/vtt | علامات الصوت في WebVTT: <v user-123>text |
srt | application/x-subrip | قبل كل إشارة: user-123: text |
txt | text/plain | سطر واحد لكل مقطع: [00:01:01] user-123: text |
في حالة عدم وجود identity، يتم استخدام participantId يُستخدم.
اللغات
Section titled “اللغات”تدعم خدمة النسخ حوالي 100 لغة. وتُقدَّم هذه اللغات على مستويين، بناءً على دقة قياسية في مجموعات الاجتماعات العامة ومجموعات قراءة النصوص:
| المستوى | اللغات |
|---|---|
| متاح بشكل عام | الإنجليزية (en)، الإسبانية (es)، البرتغالية (pt)، الألمانية (de)، الإيطالية (it)، الروسية (ru)، اليابانية (ja)، الفرنسية (fr)، الصينية (zh، الأحرف المبسطة؛ zh-Hant للنسخة التقليدية) |
| نسخة تجريبية | جميع اللغات الأخرى، بما في ذلك العربية (ar) والهندية (hi) |
تعمل اللغات في مرحلة بيتا، ولكن بدقة أقل وأقل قابلية للتنبؤ. في صوت الاجتماعات الحقيقية (عدة أشخاص، كلام عفوي)، توقع معدلات خطأ في الكلمات الإنجليزية تبلغ حوالي 20٪؛ أما القراءة الصوتية والمتحدثون الفرديون الواضحون فيحققون نتائج أفضل بكثير.
GET /v1/capabilities تسرد الرموز تحت transcription.languages، تلك المتاحة بشكل عام تحت transcription.gaLanguages، التنسيقات و حدود المفردات.
تُكتب اللغة الصينية بالأحرف المبسطة ما لم تطلب zh-Hant.
الفوترة
Section titled “الفوترة”تستخدم النصوص rtc-transcription-minutes البدل.
- الوحدة: واحد لكل دقيقة بدأت من الأطول بين مدة التسجيل وإجمالي الكلام لجميع المشاركين. الاجتماع العادي، حيث يتحدث شخص واحد في كل مرة، يتم احتساب تكلفته حسب مدته. عندما يتحدث العديد من الأشخاص في الوقت نفسه، يتم احتساب إجمالي الكلام بدلاً من ذلك.
- عمليات التشغيل الفاشلة مجانية. لا يتم فرض أي رسوم على الجلسة التي تفشل أو يتم إلغاؤها؛ ويتم تحرير الدقائق المحجوزة لها.
- محجوز أولاً: يحتفظ RTC بمدة التسجيل من رصيدك المخصص قبل وضع النص في قائمة الانتظار. في حالة عدم توفر دقائق كافية، يفشل الطلب مجانًا مع
errorCode: "RTC_ALLOWANCE_EXHAUSTED"وtranscript.failedتسرد قائمة الأحداث الحزم والترقيات فيoffers. - التداخل: أثناء نسخ التسجيلات التي تحتوي على تداخل صوتي كثيف، تحتفظ RTC بدقائق إضافية مع زيادة مدة الكلام. إذا نفد الرصيد المخصص، يتوقف النص عند هذا الحد، ويتم وضع علامة عليه
truncated: true، ولا يتم احتساب تكلفة سوى ما تم نسخه. - إذا تعذر الوصول إلى نظام الفوترة، ينتظر الطلب ثم يفشل تلقائيًا مع
BILLING_UNAVAILABLE. لا تقوم RTC أبدًا بالنسخ دون فوترة. - يتم تسليم النص النهائي دائمًا. إذا لم تتمكن خدمة الفوترة من تأكيد الدقائق بعد ذلك، تواصل RTC المحاولة، وبعد بضع ساعات، تسجل كل دقيقة مستخدمة كاستخدام. الدقائق المستخدمة ليست مجانية أبدًا.
خطة بدون دقائق للنسخ الصوتي 403
RTC_FEATURE_NOT_IN_PLAN؛ رصيد مستنفد يستجيب 402
RTC_ALLOWANCE_EXHAUSTED. كلاهما يحمل
feature: "rtc-transcription-minutes" و offers التي تعمل على إصلاح ذلك. انظر
الخطط والفوترة للاطلاع على الباقات، وأسعار الباقات وأسعار الدفع حسب الاستخدام.
الانسحاب: transcribe: false
Section titled “الانسحاب: transcribe: false”المشارك الذي رمز الانضمام تحمل
"transcribe": false لا يتم نسخها أبدًا: يتم تسجيل مساراتها كالمعتاد ولكن يتم تخطيها في عملية النسخ. استخدمها للأطفال، أو لأي شخص رفض المشاركة، أو في أي حالة تتطلبها شروطك. لن تحتوي النسخة النصية ببساطة على أي سطور منهم.
Webhooks
Section titled “Webhooks”| الحدث | data |
|---|---|
transcript.queued | recordingId, roomId, reservedMinutes |
transcript.completed | recordingId, roomId, segments (عدد)، durationMs, billedMinutes, truncated |
transcript.failed | recordingId, roomId, error، ولأسباب تتعلق بالفوترة code (RTC_ALLOWANCE_EXHAUSTED, BILLING_UNAVAILABLE أو CANCELLED) مع offers، أو RECORDING_LENGTH_UNKNOWN |
لا تحمل Webhooks أبدًا نص النص المكتوب؛ اقرأه باستخدام API. انظر webhooks.
التسليم إلى مساحة التخزين الخاصة بك
Section titled “التسليم إلى مساحة التخزين الخاصة بك”عندما توفير مساحة تخزين خاصة بك مفعّلاً، يتم تسليم النص النهائي مع ملفات التسجيل الخاصة به، على النحو التالي transcript.json و
transcript.vtt، من خلال نفس الوجهات، قالب المسار ({artifact}
و {file})، والمحاولات المتكررة والأحداث (recording.delivered مع
artifact: "transcript:json" أو "transcript:vtt"). التسجيلات الموجودة في سلة المهملات لا يتم تسليمها.
الاحتفاظ والملف المهملات
Section titled “الاحتفاظ والملف المهملات”يُرفق النص المسجل بالتسجيل:
- سلة المهملات: عندما ينتقل التسجيل إلى سلة المهملات، يتم إخفاء النص المكتوب أيضًا (
404). تؤدي استعادة التسجيل إلى إعادة النص. - تم الحذف نهائيًا: حذف التسجيل من سلة المهملات، أو الحذف التلقائي بعد 30 يومًا من دخوله سلة المهملات، يؤدي إلى حذف النص المكتوب معه.
- لا شيء آخر يؤدي إلى انتهاء صلاحية النص. يتم الاحتفاظ به طالما تم الاحتفاظ بالتسجيل، وفقًا لفترة الاحتفاظ بالتسجيلات المحددة في خطتك.
النسخ التي تم تسليمها بالفعل إلى مساحة التخزين الخاصة بك هي ملكك ولن يتم حذفها أبدًا.
الخصوصية ومعالجة البيانات
Section titled “الخصوصية ومعالجة البيانات”- CHAMPREP معالجة التسجيلات والنصوص بصفتها معالج البيانات الخاص بك، بناءً على تعليماتك.
- النسخ هو استضافة ذاتية: يعمل في حساب RTC الخاص CHAMPREPبـ AWS في الولايات المتحدة (
us-east-1). لا يتم إرسال الملفات الصوتية والنصوص إلى أي طرف ثالث، ولا يشارك أي معالج فرعي في العملية. - ملفاتك الصوتية ونصوصك هي لا تُستخدم أبدًا لتدريب نماذج.
- لا يظهر نص النصوص أبدًا في السجلات أو webhooks أو أدوات CHAMPREPالدعم.
- أنت مسؤول عن توفير الأساس القانوني وموافقة الأشخاص الذين تم تسجيلهم ونسخ نصوصهم، وعن عرض مؤشر مرئي للتسجيل والنسخ ، وعن القوانين التي تحمي القاصرين (مثل COPPA أو FERPA). الاستخدام
transcribe: falseبشأن أي شخص لا يجب كتابة نصوصه.