البدء السريع

ثبّت SDK الخاص بـHUMAIN Voice وانسخ أول تسجيل لك في نحو خمس دقائق.

تثبّت SDK وتنسخ تسجيل WAV، فتحصل على النص المنسوخ وتسميات WebVTT التوضيحية.

قبل أن تبدأ

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. شغّل نسخًا دفعيًا

batch-transcription.ts
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. يعمل الرفع كمهمة لها حالاتها الخاصة (النسخ الدفعي مهمة).

الخطوات التالية

في هذه الصفحة