نسخ تسجيل مع تسميات المتحدثين
حوّل تسجيلًا طويلًا إلى نص منسوخ بتسميات المتحدثين وتسميات WebVTT التوضيحية باستخدام مهمة نسخ دفعي.
تحصل من تسجيل مكتمل واحد على النص المنسوخ وتسميات recording.vtt التوضيحية وأدوار المتحدثين. ثبّت SDK واضبط API_URL وAPI_KEY كما في البدء السريع؛ وحدود حجم الملف ومدته في الحدود.
النسخ وكتابة التسميات التوضيحية
يرفع هذا المثال recording.wav، وينتظر المهمة حتى خمس دقائق، ويطبع النص المنسوخ، ويكتب recording.vtt. لتغيير اللغة أو النموذج راجع النماذج والأصوات.
import { readFile, writeFile } from 'node:fs/promises';
import {
BatchDiarization,
BatchTranscribeClient,
BatchTranscriptionModel,
Language,
Subtitles,
} from '@humain-voice/sdk';
function requiredEnv(name: 'API_KEY' | 'API_URL'): string {
const value = process.env[name];
if (!value) throw new Error(`${name} is required`);
return value;
}
async function main(): Promise<void> {
const inputPath = process.argv[2] ?? 'recording.wav';
const outputPath = process.argv[3] ?? 'recording.vtt';
const client = new BatchTranscribeClient({
api_url: requiredEnv('API_URL'),
api_key: requiredEnv('API_KEY'),
api_version: process.env.API_VERSION ?? 'v1',
});
try {
const result = await client.transcribe(
await readFile(inputPath),
Language.ArEn,
{
asr: BatchTranscriptionModel.BayanArEn,
diarization: BatchDiarization.On,
saveResult: true,
pollInterval: 2,
timeout: 300,
onProgress: ({ status }) => console.info('status:', status),
},
);
console.info(result.results?.transcript ?? '');
await writeFile(outputPath, Subtitles.fromResponse(result).toVtt(), 'utf8');
} finally {
await client.close();
}
}
void main().catch((error: unknown) => {
console.error(error);
process.exitCode = 1;
});
الخرج المتوقع (توضيحي):
status: queued
status: processing
status: processing
status: done
Yeah, I mean, look, to start with, building infrastructure is not ...يبني Subtitles التسميات التوضيحية من إزاحات الكلمات؛ استدعِ toSrt() (to_srt() في Python) بدل toVtt() للحصول على SRT.
تسمية المتحدثين
عند تفعيل التمييز، يسند الخادم إلى كل إزاحة كلمة قيمة speaker بحسب الوقت. يجمّع هذا المثال الكلمات المتتالية في أدوار متحدثين. التسميات سلاسل معتمة لا تميّز إلا بين المتحدثين داخل مهمة واحدة؛ راجع الخطوط الزمنية للمتحدثين. تُطبع الكلمات التي لا متحدث لها بالقيمة UNKNOWN_SPEAKER. خيارات التمييز في مستويات تمييز المتحدثين.
import { readFile } from 'node:fs/promises';
import {
BatchDiarization,
BatchTranscribeClient,
BatchTranscriptionModel,
Language,
} from '@humain-voice/sdk';
function requiredEnv(name: 'API_KEY' | 'API_URL'): string {
const value = process.env[name];
if (!value) throw new Error(`${name} is required`);
return value;
}
async function main(): Promise<void> {
const inputPath = process.argv[2] ?? 'recording.wav';
const client = new BatchTranscribeClient({
api_url: requiredEnv('API_URL'),
api_key: requiredEnv('API_KEY'),
api_version: process.env.API_VERSION ?? 'v1',
});
try {
const result = await client.transcribe(await readFile(inputPath), Language.ArEn, {
asr: BatchTranscriptionModel.BayanArEn,
diarization: BatchDiarization.On,
saveResult: true,
timeout: 300,
onProgress: ({ status }) => console.info('status:', status),
});
const turns: { speaker: string; words: string[] }[] = [];
for (const offset of result.results?.offsets ?? []) {
const speaker = offset.speaker ?? 'UNKNOWN_SPEAKER';
const last = turns[turns.length - 1];
if (last?.speaker === speaker) last.words.push(offset.word);
else turns.push({ speaker, words: [offset.word] });
}
for (const turn of turns) console.info(`${turn.speaker}: ${turn.words.join(' ')}`);
} finally {
await client.close();
}
}
void main().catch((error: unknown) => {
console.error(error);
process.exitCode = 1;
});
الخرج المتوقع (توضيحي):
status: queued
status: processing
status: processing
status: done
SPEAKER_1: Yeah, I mean, look, to start with, building infrastructure is not ...
SPEAKER_2: جلالة الملك فهد بن عبد العزيز ...التعامل مع الإخفاقات
| الحالة | الإجراء |
|---|---|
400 أو 402 أو 413 أو 422 | لم تُنشأ مهمة. صحّح الطلب، أو أضف رصيدًا في حالة 402؛ والصوت الذي تتجاوز مدته أربع ساعات يعيد 422 AUDIO_DURATION_EXCEEDED (الحدود). |
401 | صحّح API_KEY؛ راجع المصادقة. |
429 أو 503 عند الرفع | تراجع وأعد الإرسال؛ راجع إعادة المحاولة بأمان. |
انتهاء مهلة الرفع أو إعادة 500 أو 502 أو 504 | قد تكون المهمة أُنشئت. لا تعد الإرسال تلقائيًا؛ راجع إعادة المحاولة والتكرار. |
وصول المهمة إلى failed | فشلت المهمة دون سبب. تنشئ إعادة الإرسال مهمة جديدة؛ وإذا فشلت ثانية فتواصل مع الدعم مع معرّف المهمة. |
وصول المهمة إلى cleared | النتيجة محذوفة؛ أعد الإرسال. يواصل transcribe() الاستعلام الدوري عن مهمة cleared حتى تنتهي المهلة. أبقِ saveResult: true (save_result=True) كي لا تمسح قراءاتك النتيجة (النسخ الدفعي مهمة). |
BatchTranscribeTimeoutError | ارفع timeout (timeout_seconds) للتسجيلات الطويلة، أو استعلم دوريًا عن err.jobId بالاستدعاء getResult(jobId, lang, { saveResult: true }) (get_result(job_id, lang, save_result=True)). |