البدء السريع
ثبّت SDK الخاص بـHUMAIN Voice وانسخ أول تسجيل لك في نحو خمس دقائق.
تثبّت SDK وتنسخ تسجيل WAV، فتحصل على النص المنسوخ وتسميات WebVTT التوضيحية.
قبل أن تبدأ
- مفتاح API من لوحة تحكم HUMAIN Voice (المصادقة).
- تسجيل WAV محفوظ باسم
recording.wav. - Node.js 24 أو أحدث (يشغّل ملفات
.tsمباشرة) أو Python 3.10 أو أحدث.
1. ثبّت SDK
npm install @humain-voice/[email protected]2. اضبط بيئتك
export API_URL="https://api.voice.humain.com"
export API_KEY="YOUR_API_KEY"تقرأ أمثلة Socket.IO أيضًا المتغير الاختياري API_PATH
(إعدادات الاتصال).
3. شغّل نسخًا دفعيًا
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;
});
احفظ المثال باسم الملف المعروض وشغّله:
- JavaScript / TypeScript:
node batch-transcription.ts recording.wav - Python:
python batch_transcription.py recording.wav
ما تحصل عليه
الخرج المتوقع (توضيحي):
status: queued
status: processing
status: processing
status: done
Hello and welcome to the meeting.تُكتب التسميات التوضيحية في recording.vtt. يعمل الرفع كمهمة لها حالاتها الخاصة
(النسخ الدفعي مهمة).