> ## Documentation Index
> Fetch the complete documentation index at: https://docs.youka.io/llms.txt
> Use this file to discover all available pages before exploring further.

# مجموعة تطوير البرمجيات Node.js

> أتمتة Youka من Node.js و Bun باستخدام مجموعة تطوير البرمجيات الرسمية TypeScript

`@youka/sdk` هي مجموعة تطوير البرمجيات (SDK) الرسمية بلغة TypeScript لواجهة برمجة تطبيقات Youka. استخدمها لإنشاء كاريوكي من الصوت أو الفيديو، وتخصيص كلمات الأغاني والتنسيق، وتصدير فيديوهات MP4، ودمج سير عمل Youka داخل تطبيقات Node.js أو Bun.

## التثبيت

<CodeGroup>
  ```bash npm theme={null}
  npm install @youka/sdk
  ```

  ```bash pnpm theme={null}
  pnpm add @youka/sdk
  ```

  ```bash yarn theme={null}
  yarn add @youka/sdk
  ```

  ```bash bun theme={null}
  bun add @youka/sdk
  ```
</CodeGroup>

## المتطلبات

* Node.js 20 أو أحدث، أو Bun 1.1+
* مفتاح Youka API في `YOUKA_API_KEY` (أنشئ واحدًا على [online.youka.io/account](https://online.youka.io/account) ضمن **API keys**)

## مثال سريع

```ts theme={null}
import { YoukaClient } from "@youka/ar/sdk";

const client = new YoukaClient({
  apiKey: process.env.YOUKA_API_KEY!,
});

const operation = await client.projects.create({
  source: { type: "path", path: "./song.mp3" },
  lyricsSource: { type: "transcribe" },
});

const { project } = await client.projects.wait(operation);
console.log(project.id, project.title);
```

## المرجع

<Columns cols={2}>
  <Card title="بدء سريع" icon="rocket" href="/ar/sdk/quickstart">
    مثال شامل من البداية للنهاية: إنشاء، انتظار، تصدير، تنزيل.
  </Card>

  <Card title="المصادقة" icon="key" href="/ar/sdk/authentication">
    إعداد `YoukaClient` والتعامل مع مفاتيح API بأمان.
  </Card>

  <Card title="الحساب، الرصيد، والفوترة" icon="credit-card" href="/ar/sdk/account-billing">
    مساعدات الهوية والرصيد والتسعير وإتمام الدفع وبوابة الفوترة.
  </Card>

  <Card title="المشاريع" icon="folder" href="/ar/sdk/projects">
    الرفع، والإنشاء، والسرد، والحذف.
  </Card>

  <Card title="المسارات المنفصلة" icon="waveform-lines" href="/ar/sdk/stems">
    تشغيل مهام فصل المسارات.
  </Card>

  <Card title="مزامنة الكلمات" icon="closed-captioning" href="/ar/sdk/lyrics-sync">
    إعادة تشغيل مزامنة كلمات الأغاني.
  </Card>

  <Card title="عمليات التصدير" icon="file-video" href="/ar/sdk/exports">
    سير عمل التصدير عبر السحابة ومحليًا.
  </Card>

  <Card title="المهام" icon="list-check" href="/ar/sdk/tasks">
    فحص المهام والانتظار حتى الاكتمال.
  </Card>

  <Card title="الإعدادات المسبقة" icon="palette" href="/ar/sdk/presets">
    إعدادات عرض قابلة لإعادة الاستخدام.
  </Card>

  <Card title="الوسائط" icon="image" href="/ar/sdk/media">
    رفع الخلفيات والشعارات والمقدمات.
  </Card>

  <Card title="إعدادات المشروع" icon="sliders" href="/ar/sdk/project-settings">
    إعدادات العرض على مستوى المشروع.
  </Card>

  <Card title="الأخطاء" icon="triangle-exclamation" href="/ar/sdk/errors">
    `YoukaRequestError` و `YoukaTaskError`.
  </Card>
</Columns>

## ما التالي

* [بدء سريع](/ar/sdk/quickstart) — أقصر طريق للحصول على كاريوكي مكتمل
* [مرجع API](/ar/api) — كل نقطة نهاية، مُولّدة تلقائيًا من OpenAPI
* [وكلاء الذكاء الاصطناعي](/ar/agents) — قواعد التشغيل لمؤلفي الوكلاء