---
title: البدء السريع
icon: Rocket
description: ثبّت SDK الخاص بـHUMAIN Voice وانسخ أول تسجيل لك في نحو خمس دقائق.
---

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

## قبل أن تبدأ

- مفتاح API من [لوحة تحكم HUMAIN Voice](https://console.voice.humain.com) ([المصادقة](/ar/authentication)).
- تسجيل WAV محفوظ باسم `recording.wav`.
- Node.js 24 أو أحدث (يشغّل ملفات `.ts` مباشرة) أو Python 3.10 أو أحدث.

## 1. ثبّت SDK

**JavaScript / TypeScript**

```bash
npm install @humain-voice/sdk@0.18.1
```

**Python**

```bash
python -m pip install humain-voice==0.18.1
```

## 2. اضبط بيئتك

```bash
export API_URL="https://api.voice.humain.com"
export API_KEY="YOUR_API_KEY"
```

تقرأ أمثلة Socket.IO أيضًا المتغير الاختياري `API_PATH`
([إعدادات الاتصال](/ar/authentication#إعدادات-الاتصال)).

## 3. شغّل نسخًا دفعيًا

**JavaScript / TypeScript**

```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;
});
```

**Python**

```python
from __future__ import annotations

import asyncio
import os
import sys
from pathlib import Path

from humain_voice import stt
from humain_voice.stt.batchtranscription import BatchDiarization


def required_env(name: str) -> str:
    value = os.environ.get(name)
    if not value:
        raise RuntimeError(f"{name} is required")
    return value


async def main() -> None:
    input_path = Path(sys.argv[1] if len(sys.argv) > 1 else "recording.wav")
    output_path = Path(sys.argv[2] if len(sys.argv) > 2 else "recording.vtt")

    async with stt.BatchTranscribeClient(
        api_url=required_env("API_URL"),
        api_key=required_env("API_KEY"),
        api_version=os.environ.get("API_VERSION", "v1"),
    ) as client:
        result = await client.transcribe(
            input_path,
            lang=stt.Language.ArEn,
            asr=stt.BatchTranscriptionModel.BayanArEn,
            diarization=BatchDiarization.On,
            save_result=True,
            poll_interval=2.0,
            timeout_seconds=300.0,
            on_progress=lambda response: print("status:", response.status.value),
        )

    print(result.results.transcript if result.results else "")
    output_path.write_text(
        stt.Subtitles.from_response(result).to_vtt(),
        encoding="utf-8",
    )


if __name__ == "__main__":
    asyncio.run(main())
```

احفظ المثال باسم الملف المعروض وشغّله:

- JavaScript / TypeScript: `node batch-transcription.ts recording.wav`
- Python: `python batch_transcription.py recording.wav`

## ما تحصل عليه

الخرج المتوقع (توضيحي):

```text
status: queued
status: processing
status: processing
status: done
Hello and welcome to the meeting.
```

تُكتب التسميات التوضيحية في `recording.vtt`. يعمل الرفع كمهمة لها حالاتها الخاصة
([النسخ الدفعي مهمة](/ar/concepts#النسخ-الدفعي-مهمة)).

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

- [النسخ الفوري](/ar/recipes/realtime-transcription): انسخ الصوت المباشر أثناء وصوله.
- [نسخ تسجيل](/ar/recipes/transcribe-a-recording): حدّد من قال ماذا في تسجيل.
- [تحويل النص إلى كلام: الحفظ أو البث](/ar/recipes/text-to-speech-to-file): حوّل النص إلى كلام واحفظه أو شغّله.
- [اختر سير العمل](/ar/concepts#اختر-سير-العمل): اختر النسخ الدفعي أو السريع أو الفوري لصوتك.
