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

​
التثبيت

npm install @youka/sdk

​
المتطلبات

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

​
مثال سريع

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

​
المرجع

بدء سريع

مثال شامل من البداية للنهاية: إنشاء، انتظار، تصدير، تنزيل.

المصادقة

إعداد YoukaClient والتعامل مع مفاتيح API بأمان.

الحساب، الرصيد، والفوترة

مساعدات الهوية والرصيد والتسعير وإتمام الدفع وبوابة الفوترة.

المشاريع

الرفع، والإنشاء، والسرد، والحذف.

المسارات المنفصلة

تشغيل مهام فصل المسارات.

مزامنة الكلمات

إعادة تشغيل مزامنة كلمات الأغاني.

عمليات التصدير

سير عمل التصدير عبر السحابة ومحليًا.

المهام

فحص المهام والانتظار حتى الاكتمال.

الإعدادات المسبقة

إعدادات عرض قابلة لإعادة الاستخدام.

الوسائط

رفع الخلفيات والشعارات والمقدمات.

إعدادات المشروع

إعدادات العرض على مستوى المشروع.

الأخطاء

YoukaRequestError و YoukaTaskError.

​
ما التالي