Lahajati AI - توثيق واجهة برمجة التطبيقات

مقدمة

مرحبًا بك في توثيق واجهة برمجة التطبيقات (API) الخاصة بـ Lahajati AI. ستجد هنا جميع المعلومات التي تحتاجها لدمج تقنية تحويل النص إلى كلام، تحويل الصوت إلى صوت، واستنساخ الأصوات المتطورة لدينا في تطبيقاتك.

إجراء الطلبات

المصادقة

تستخدم Lahajati AI API مفاتيح API للمصادقة على الطلبات. يمكنك الحصول على مفتاح API الخاص بك من لوحة تحكم حسابك.

يجب أن تتضمن جميع طلبات API مفتاح API الخاص بك في ترويسة Authorization:

Authorization: Bearer YOUR_API_KEY

الطلبات التي لا تحتوي على مصادقة ستفشل مع رمز الحالة `401 Unauthorized`.

معالجة الأخطاء (عام)

تستخدم واجهة برمجة تطبيقات لهجاتي رموز حالة HTTP القياسية للإشارة إلى نجاح أو فشل طلب API. بشكل عام: الرموز في نطاق `2xx` تشير إلى النجاح. الرموز في نطاق `4xx` تشير إلى خطأ ناتج عن المعلومات المقدمة من العميل (على سبيل المثال، معلمة مطلوبة مفقودة، فشل المصادقة، إلخ). الرموز في نطاق `5xx` تشير إلى خطأ من جانب خوادمنا.

`400 Bad Request`: لم يتمكن الخادم من فهم الطلب بسبب صياغة غير صالحة. تحقق من تنسيق جسم الطلب أو معلمات الاستعلام.
`401 Unauthorized`: مفتاح API الخاص بك مفقود، غير صالح، أو منتهي الصلاحية. تأكد من تضمين ترويسة `Authorization: Bearer YOUR_API_KEY` صالحة.
`403 Forbidden`: ليس لديك الإذن للوصول إلى هذا المورد أو تنفيذ هذه العملية (على سبيل المثال، محاولة تعديل مورد لا تملكه، أو تجاوز حدود الباقة).
`404 Not Found`: لم يتم العثور على المورد المطلوب (على سبيل المثال، `id_voice` غير موجود).
`422 Unprocessable Entity`: كان الطلب جيد الصياغة ولكن تعذر متابعته بسبب أخطاء دلالية (فشل التحقق من صحة الإدخال). سيتضمن جسم الاستجابة عادةً كائن `errors` مع تفاصيل الحقول التي فشلت في التحقق.
`429 Too Many Requests`: لقد تجاوزت حد معدل الطلبات (RPM) المسموح به لباقة اشتراكك. حاول مرة أخرى لاحقًا. راجع قسم حدود معدل الطلبات.
`500 Internal Server Error` / `502 Bad Gateway` / `503 Service Unavailable`: حدث خطأ غير متوقع من جانب الخادم أو أن الخدمة غير متاحة مؤقتًا. إذا استمرت المشكلة، يرجى الاتصال بالدعم.

حدود معدل الطلبات (RPM)

واجهة برمجة تطبيقات لهجاتي AI تفرض حدودًا على عدد الطلبات التي يمكن إجراؤها في الدقيقة (RPM) بناءً على باقة اشتراكك. تهدف هذه الحدود إلى ضمان أداء مستقر وعادل لجميع المستخدمين. تجاوز هذه الحدود سيؤدي إلى استجابة خطأ `429 Too Many Requests`.

الباقة	الطلبات في الدقيقة (RPM)
الباقة المجانية	60
باقة البداية	300
باقة صانع المحتوى	500
الباقة المتميزة	800
باقة الأعمال	1000

ملاحظة هامة: لطلب حدود أعلى لـ rpm لحزمة الأعمال، يرجى الاتصال بالدعم على: support@lahajati.ai.

حدود الطلبات المتزامنة

بالإضافة إلى حدود RPM، هناك قيود على عدد الطلبات المتزامنة التي يمكن لحسابك تشغيلها في نفس الوقت. هذا يساعد في الحفاظ على استقرار النظام.

الباقة	الحد الأقصى للطلبات المتزامنة
الباقة المجانية	2
باقة البداية	5
باقة صانع المحتوى	50
الباقة المتميزة	200
باقة الأعمال	400

ملاحظة هامة: لطلب حدود تزامن أعلى لباقة الأعمال، يرجى التواصل مع الدعم عبر: support@lahajati.ai.

POSTPOST تحويل النص إلى كلام احترافي

https://lahajati.ai/api/v1/text-to-speech-pro

يقوم بإنشاء ملف صوتي عالي الجودة من النص المقدم باستخدام نموذج الصوت والمعلمات المحددة.

معلمات جسم الطلب (Request Body - JSON)

المعلمة	النوع	مطلوب	الوصف
`text`	string (نص)	نعم	النص المراد تحويله إلى كلام.
`id_voice`	string (معرف)	نعم	المعرف الفريد لمؤدي الصوت المطلوب. يمكن الحصول عليه عبر نقطة النهاية الحصول على الأصوات.
`version`	string (إصدار)	نعم	إصدار النموذج المحدد للاستخدام. حاليًا يجب أن يكون `lahajati_text_to_speech_pro_v1`.
`professional_quality`	boolean (منطقي)	لا (الافتراضي `0`)	اضبط القيمة على `1` لتمكين المعالجة المحسنة للحصول على مخرجات صوتية بجودة احترافية.
`speech_speed`	float (عشري)	لا (الافتراضي `1.0`)	يتحكم في سرعة الكلام الناتج. النطاق: `0.8` إلى `1.3`.
`volume`	float (عشري)	لا (الافتراضي `1.0`)	يضبط مستوى صوت الكلام الناتج. النطاق: `0.0` إلى `1.0`.

الاستجابة الناجحة

عند النجاح (`200 OK`)، سيحتوي جسم الاستجابة على بيانات الصوت الخام. ترويسة `Content-Type` ستكون `audio/mpeg`.

استجابات الخطأ

بالإضافة إلى الأخطاء العامة، قد تواجه الأخطاء التالية الخاصة بهذه النقطة:

400 تنسيق الإدخال غير صالح أو معلمات مطلوبة مفقودة.
404 المعرف `id_voice` المحدد غير موجود.
422 فشل التحقق من صحة الإدخال. سيحتوي جسم الاستجابة على تفاصيل الأخطاء.

POSTPOST تحويل الصوت إلى صوت احترافي

https://lahajati.ai/api/v1/speech-to-speech-pro

يقوم بتحويل ملف صوتي إلى كلام بصوت آخر محدد مع الحفاظ على النبرة والأسلوب، باستخدام نموذج الصوت والمعلمات المحددة.

ملاحظة هامة: يجب إرسال الطلبات إلى نقطة النهاية هذه باستخدام `multipart/form-data` بسبب تحميل الملف الصوتي.
ملاحظة: عند استخدام `FormData` في JavaScript أو ما يعادلها في المكتبات الأخرى، يقوم المتصفح/المكتبة تلقائيًا بتعيين ترويسة `Content-Type: multipart/form-data` مع `boundary` الصحيح. لا تقم بتعيينها يدويًا.

معلمات الطلب (Form Data)

المعلمة	النوع	مطلوب	الوصف
`audio_file`	file (ملف صوتي)	نعم	الملف الصوتي المراد تحويله. الأنواع المدعومة: `mp3, wav, aac, ogg`. الحجم الأقصى: 50 ميجابايت.
`id_voice`	string (معرف)	نعم	المعرف الفريد لمؤدي الصوت المطلوب. يمكن الحصول عليه عبر نقطة النهاية الحصول على الأصوات.
`version`	string (إصدار)	نعم	إصدار النموذج المحدد للاستخدام. حاليًا يجب أن يكون `lahajati_speech_to_speech_pro_v1`.
`professional_quality`	boolean (منطقي)	لا (الافتراضي `0`)	اضبط القيمة على `1` لتمكين المعالجة المحسنة للحصول على مخرجات صوتية بجودة احترافية.

الاستجابة الناجحة

عند النجاح (`200 OK`)، سيحتوي جسم الاستجابة على بيانات الصوت الخام المحول. ترويسة `Content-Type` ستكون `audio/mpeg`.

استجابات الخطأ

بالإضافة إلى الأخطاء العامة، قد تواجه الأخطاء التالية الخاصة بهذه النقطة:

400 طلب غير صالح، عادة بسبب فقدان `audio_file` أو استخدام `Content-Type` غير صحيح.
402 رصيد النقاط غير كافٍ لإجراء عملية التحويل.
403 مفتاح API منتهي الصلاحية أو صلاحيات غير كافية لاستخدام الصوت المحدد.
404 المعرف `id_voice` المحدد غير موجود.
422 فشل التحقق من صحة الإدخال. سيحتوي جسم الاستجابة على تفاصيل الأخطاء.

GETGET الحصول على الأصوات

https://lahajati.ai/api/v1/voices

يجلب قائمة بالأصوات المتاحة التي يمكن استخدامها مع نقاط نهاية تحويل النص إلى كلام وتحويل الصوت إلى صوت، بما في ذلك الأصوات المستنسخة.

معلمات الاستعلام (Query Parameters)

معلمات اختيارية لفلترة النتائج وفرزها وتقسيمها إلى صفحات.

المعلمة	النوع	مطلوب	الوصف
`page`	integer (عدد صحيح)	لا (الافتراضي 1)	رقم الصفحة المطلوب من النتائج.
`per_page`	integer (عدد صحيح)	لا (الافتراضي 15، الأقصى 100)	عدد الأصوات التي يتم إرجاعها في كل صفحة.
`type_voice`	string	لا (الافتراضي `tts`)	تصفية حسب نوع الصوت. القيم المسموح بها: `tts`، `sts`، `all`. القيمة الافتراضية: `tts`.
`search`	string (نص)	لا	مصطلح بحث لفلترة الأصوات حسب الاسم أو العنوان.
`gender`	string (نص)	لا	فلترة حسب الجنس. القيم المسموح بها: `1` (ذكر)، `2` (أنثى)، `3` (أطفال).
`is_cloned`	boolean (منطقي)	لا	فلترة حسب حالة الاستنساخ. استخدم `true` أو `1` للمستنسخة، `false` أو `0` للأصلية.
`accent`	string (نص)	لا	فلترة حسب لهجة الصوت أو اللغة (مثل: "مصري", "سعودي").
`min_rating`	numeric (رقمي)	لا	فلترة الأصوات ذات متوسط تقييم أكبر من أو يساوي هذه القيمة (0.0 إلى 5.0).
`sort_by`	string (نص)	لا (الافتراضي تاريخ الإنشاء)	الحقل الذي يتم فرز النتائج بناءً عليه. القيم المسموح بها: `name`, `rating`, `created_at`.
`sort_direction`	string (نص)	لا (الافتراضي `desc`)	اتجاه فرز النتائج. القيم المسموح بها: `asc` (تصاعدي)، `desc` (تنازلي).

الاستجابة الناجحة (200 OK)

إرجاع قائمة مقسمة إلى صفحات لكائنات الأصوات التي تطابق المعايير.

استجابات الخطأ

بالإضافة إلى الأخطاء العامة، قد تواجه الأخطاء التالية الخاصة بهذه النقطة:

422 فشل التحقق من صحة معلمات الاستعلام. انظر كائن `errors`.

أفضل ممارسات استنساخ الصوت

للحصول على أفضل النتائج عند استخدام ميزة استنساخ الصوت، من الضروري توفير عينات صوتية عالية الجودة. فيما يلي إرشادات وتوصيات لمساعدتك في إعداد ملفاتك الصوتية:

إرشادات جودة الصوت

متحدث واحد فقط: تأكد من أن التسجيل يحتوي على صوت شخص واحد بوضوح (لا توجد أصوات أخرى أو موسيقى في الخلفية).
ثبات الأداء: حافظ على مستوى صوت ونبرة وعاطفة ثابتة قدر الإمكان طوال التسجيل.
وقفات طبيعية: قم بتضمين وقفات قصيرة وطبيعية بين الجمل (يوصى بـ 0.5 ثانية).
بيئة هادئة: سجل في مكان خالٍ من ضوضاء الخلفية والصدى قدر الإمكان.
جودة احترافية (مثالي): إذا أمكن، استخدم معدات تسجيل احترافية (ميكروفون جيد) وفي بيئة معالجة صوتيًا (تقليل صدى الغرفة).

خصائص العينة الصوتية المثالية

المدة الموصى بها: للحصول على أفضل جودة وتنوع في الأداء (مثل القدرة على التعبير عن مشاعر مختلفة)، قدم عينة صوتية تزيد مدتها عن 60 ثانية.
للأداء الثابت: إذا كنت تستهدف أداءً ثابتًا ومحددًا (مثل قراءة الأخبار)، فإن عينة تتراوح مدتها بين 30 و 50 ثانية بصوت واضح وأداء ثابت قد تكون كافية.
وضوح ونقاء: يجب أن تكون العينة الصوتية خالية تمامًا من الضوضاء والتشويش (تجنب قص الصوت أو التشويه). الصوت الواضح والنقي هو المفتاح.
التدريب الذكي: سيقوم نظام الذكاء الاصطناعي لدينا بتحليل وتدريب نفسه على لهجة الصوت، نبرته، وأسلوب الأداء (سواء كان سعيدًا، متحمسًا، رسميًا، إلخ) من العينة المقدمة.

تنسيقات الملفات المعتمدة

نقبل مجموعة متنوعة من تنسيقات ملفات الصوت (كما هو محدد في معلمة `audio_file` لنقطة نهاية إنشاء صوت مستنسخ).

التوصية: للحصول على توازن جيد بين الجودة وحجم الملف، نوصي باستخدام تنسيق MP3 بمعدل بت 192kbps أو أعلى. التنسيقات غير المضغوطة (مثل WAV) قد لا تقدم فائدة ملحوظة مقارنةً بزيادة حجم الملف ووقت المعالجة.

POSTPOST إنشاء صوت مستنسخ

https://lahajati.ai/api/v1/voices/cloned

يسمح بإنشاء صوت مستنسخ جديد عن طريق تحميل ملف صوتي للتدريب وتوفير البيانات الوصفية اللازمة. الصوت المستنسخ سيكون متاحًا للاستخدام في تحويل النص إلى كلام بعد اكتمال المعالجة.

ملاحظة هامة: يجب إرسال الطلبات إلى نقطة النهاية هذه باستخدام `multipart/form-data`.
ملاحظة: عند استخدام `FormData` في JavaScript أو ما يعادلها في المكتبات الأخرى، يقوم المتصفح/المكتبة تلقائيًا بتعيين ترويسة `Content-Type: multipart/form-data` مع `boundary` الصحيح. لا تقم بتعيينها يدويًا.

راجع قسم أفضل ممارسات استنساخ الصوت للحصول على أفضل النتائج.

معلمات الطلب (Form Data)

المعلمة	النوع	مطلوب	الوصف
`voice_name`	string (نص)	نعم	الاسم المراد إعطاؤه للصوت المستنسخ. (الحد الأقصى: 25 حرفًا).
`gender`	integer (صحيح)	نعم	جنس الصوت. القيم المسموح بها: `1` (ذكر)، `2` (أنثى)، `3` (طفل).
`voice_image`	file (صورة)	نعم	صورة للصوت المستنسخ. الأنواع المدعومة: `jpeg, png, jpg, gif, webp`. الحجم الأقصى: 2 ميجابايت.
`audio_file`	file (ملف صوتي)	نعم	ملف صوتي واحد للتدريب على استنساخ الصوت. الأنواع المدعومة: `mp3, wav, aac, ogg, flac, m4a`. الحجم الأقصى: 50 ميجابايت. (جودة جيدة ووضوح بدون ضوضاء خلفية يعطي أفضل النتائج).
`enhance_audio`	boolean (منطقي)	لا (الافتراضي `false`)	اضبط على `true` لتحسين جودة ملف الصوت التدريبي قبل إرساله لنموذج الاستنساخ (قد يزيد من وقت المعالجة).
`voice_tags`	string (نص)	لا	كلمات مفتاحية أو تصنيفات اختيارية للصوت المستنسخ، مفصولة بفاصلة (مثال: "هادئ, رسمي"). (الحد الأقصى: 255 حرفًا).
`preview_audio_sample`	file (ملف صوتي)	لا	ملف صوتي اختياري كعينة لمعاينة الصوت المستنسخ. الأنواع المدعومة: `mp3, wav`. الحجم الأقصى: 10 ميجابايت. (متاح فقط للمستخدمين برتبة معينة).

الاستجابة الناجحة (201 Created)

عند الإنشاء الناجح، يتم إرجاع تفاصيل الصوت المستنسخ الذي تم إنشاؤه. قد يستغرق الصوت بعض الوقت ليصبح نشطًا بالكامل.

استجابات الخطأ (إنشاء صوت مستنسخ)

بالإضافة إلى الأخطاء العامة، قد تواجه الأخطاء التالية الخاصة بهذه النقطة:

403 تم الوصول إلى الحد الأقصى المسموح به لعدد الأصوات المستنسخة.
422 فشل التحقق من صحة المدخلات (مثل: اسم مفقود، نوع ملف غير صالح، حجم ملف كبير جدًا).
500 خطأ أثناء الاتصال بخدمة استنساخ الصوت الخارجية أو فشل في معالجة الطلب هناك.

PUTPUT تعديل صوت مستنسخ

https://lahajati.ai/api/v1/voices/cloned/{id_voice}

يسمح بتعديل البيانات الوصفية لصوت مستنسخ موجود (مثل الاسم، الجنس، الصورة، العلامات). لا يمكن تعديل عينة الصوت التدريبية الأصلية.

ملاحظة هامة: ملاحظة: استخدم `multipart/form-data` فقط إذا كنت تقوم بتحميل ملف `voice_image` جديد. بخلاف ذلك، يمكن إرسال البيانات كـ `application/x-www-form-urlencoded` أو `application/json`. إذا كنت تستخدم `multipart/form-data`، لا تقم بتعيين ترويسة `Content-Type` يدويًا في JavaScript أو المكتبات المماثلة.

ملاحظة هامة: جميع المعلمات في جسم الطلب اختيارية. أرسل فقط تلك التي تريد تعديلها.

معلمة المسار (Path Parameter)

المعلمة	النوع	مطلوب	الوصف
`{id_voice}`	string (معرف)	نعم	المعرف الفريد للصوت المستنسخ المراد تعديله (الذي يبدأ بـ `lvc_`). يتم تمريره كجزء من عنوان URL.

معلمات الطلب الاختيارية (Form Data / JSON)

المعلمة	النوع	مطلوب	الوصف
`voice_name`	string (نص)	لا	الاسم المراد إعطاؤه للصوت المستنسخ. (الحد الأقصى: 25 حرفًا).
`gender`	integer (صحيح)	لا	جنس الصوت. القيم المسموح بها: `1` (ذكر)، `2` (أنثى)، `3` (طفل).
`voice_image`	file (صورة)	لا	صورة للصوت المستنسخ. الأنواع المدعومة: `jpeg, png, jpg, gif, webp`. الحجم الأقصى: 2 ميجابايت.
`voice_tags`	string (نص)	لا	كلمات مفتاحية أو تصنيفات اختيارية للصوت المستنسخ، مفصولة بفاصلة (مثال: "هادئ, رسمي"). (الحد الأقصى: 255 حرفًا).

الاستجابة الناجحة (200 OK)

عند التعديل الناجح، يتم إرجاع تفاصيل الصوت المستنسخ المحدثة.

استجابات الخطأ (تعديل صوت مستنسخ)

بالإضافة إلى الأخطاء العامة، قد تواجه الأخطاء التالية الخاصة بهذه النقطة:

404 الصوت المستنسخ غير موجود، أو لا تملك الصلاحية لتعديله.
422 فشل التحقق من صحة المدخلات (مثل: اسم مفقود، نوع ملف غير صالح، حجم ملف كبير جدًا).

DELETEDELETE حذف صوت مستنسخ

https://lahajati.ai/api/v1/voices/cloned/{id_voice}

يقوم بحذف صوت مستنسخ بشكل دائم من النظام ومن أي خدمات خارجية مرتبطة به.

معلمة المسار (Path Parameter)

المعلمة	النوع	مطلوب	الوصف
`{id_voice}`	string (معرف)	نعم	المعرف الفريد للصوت المستنسخ المراد تعديله (الذي يبدأ بـ `lvc_`). يتم تمريره كجزء من عنوان URL.

الاستجابة الناجحة (200 OK)

رسالة تأكيد على الحذف الناجح.

استجابات الخطأ (حذف صوت مستنسخ)

بالإضافة إلى الأخطاء العامة، قد تواجه الأخطاء التالية الخاصة بهذه النقطة:

404 الصوت المستنسخ غير موجود، أو لا تملك الصلاحية لتعديله.
500 فشل حذف الصوت المستنسخ (قد يكون بسبب مشكلة في خدمة خارجية).

تحويل النص إلى كلام احترافي

أمثلة الطلب

curl -X POST "https://lahajati.ai/api/v1/text-to-speech-pro" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: audio/mpeg" \
-d '{
  "text": "مرحبًا بك في لهجتي.",
  "id_voice": "some_voice_id_example",
  "version": "lahajati_text_to_speech_pro_v1",
  "professional_quality": 0,
  "speech_speed": 1.0
}' \
--output output_tts.mp3

أمثلة الطلب

use Illuminate\Support\Facades\Http;
use Illuminate\Support\Facades\Storage;

$apiKey = 'YOUR_API_KEY';
$apiUrl = 'https://lahajati.ai/api/v1/text-to-speech-pro';

$response = Http::withToken($apiKey)
    ->accept('audio/mpeg')
    ->post($apiUrl, [
        'text'     => 'مرحبًا بك في لهجتي.',
        'id_voice' => 'some_voice_id_example',
        'version'  => 'lahajati_text_to_speech_pro_v1',
    ]);

if ($response->successful()) {
    Storage::disk('public')->put('tts_output.mp3', $response->body());
     echo "Audio saved to public/tts_output.mp3!";
} else {
    echo "Error: " . $response->status() . "\n";
    echo $response->body(); // Show error details
}

أمثلة الطلب

const apiKey = 'YOUR_API_KEY';
const apiUrl = 'https://lahajati.ai/api/v1/text-to-speech-pro';

const data = {
    text: "مرحبًا بك في لهجتي.",
    id_voice: "some_voice_id_example",
    version: "lahajati_text_to_speech_pro_v1"
};

async function fetchTTS() {
    try {
        const response = await fetch(apiUrl, {
            method: 'POST',
            headers: {
                'Authorization': `Bearer ${apiKey}`,
                'Content-Type': 'application/json',
                'Accept': 'audio/mpeg'
            },
            body: JSON.stringify(data)
        });

        if (!response.ok) {
           const errorData = await response.json().catch(() => ({ message: response.statusText }));
           throw new Error(`HTTP error ${response.status}: ${errorData.message || 'Unknown error'}`);
        }

        const audioBlob = await response.blob();
        console.log('Audio received!');
        const audioUrl = URL.createObjectURL(audioBlob);
        // const audio = new Audio(audioUrl);
        // audio.play();
        // Or offer for download:
        // const link = document.createElement('a');
        // link.href = audioUrl;
        // link.download = 'tts_output.mp3';
        // document.body.appendChild(link);
        // link.click();
        // document.body.removeChild(link);

    } catch (e) {
        console.error('API Error:', e);
    }
}

fetchTTS();

أمثلة الطلب

import requests
import json

api_key = 'YOUR_API_KEY'
api_url = 'https://lahajati.ai/api/v1/text-to-speech-pro'

headers = {
    'Authorization': f'Bearer {api_key}',
    'Content-Type': 'application/json',
    'Accept': 'audio/mpeg'
}
data = {
    "text": "مرحبًا بك في لهجتي.",
    "id_voice": "some_voice_id_example",
    "version": "lahajati_text_to_speech_pro_v1"
}

response = requests.post(api_url, headers=headers, json=data, stream=True)

if response.status_code == 200:
    with open('tts_output.mp3', 'wb') as f:
       for chunk in response.iter_content(chunk_size=8192): # Larger chunk size
             if chunk: # filter out keep-alive new chunks
                f.write(chunk)
    print("Audio saved successfully to tts_output.mp3")
else:
    print(f"Error ({response.status_code}): {response.text}")

أمثلة الاستجابة

الاستجابة الناجحة (200 OK)

HTTP/1.1 200 OK
Content-Type: audio/mpeg
Content-Length: 123456

[... raw binary audio data ...]

مثال على جسم استجابة 422

{
  "message": "The given data was invalid.",
  "errors": {
    "id_voice": [ "The selected id voice is invalid." ],
    "text": [ "The text field is required." ]
  }
}

تحويل الصوت إلى صوت احترافي

أمثلة الطلب

curl -X POST "https://lahajati.ai/api/v1/speech-to-speech-pro" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: audio/mpeg" \
-F "audio_file=@/path/to/your/source_audio.mp3" \
-F "id_voice=target_voice_id_example" \
-F "version=lahajati_speech_to_speech_pro_v1" \ 
--output sts_output.mp3

أمثلة الطلب

use Illuminate\Support\Facades\Http;
use Illuminate\Support\Facades\Storage;

$apiKey = 'YOUR_API_KEY';
$apiUrl = 'https://lahajati.ai/api/v1/speech-to-speech-pro';
$audioFilePath = storage_path('app/public/source_audio.mp3'); // Example path

$response = Http::withToken($apiKey)
    ->accept('audio/mpeg')
    ->attach(
        'audio_file', file_get_contents($audioFilePath), basename($audioFilePath)
     )
    ->post($apiUrl, [
        'id_voice'         => 'target_voice_id_example',
        'version'          => 'lahajati_speech_to_speech_pro_v1', 
    ]);

if ($response->successful()) {
     Storage::disk('public')->put('sts_output.mp3', $response->body());
     echo "Converted audio saved to public/sts_output.mp3!";
} else {
    echo "Error: " . $response->status() . "\n";
    echo $response->body();
}

أمثلة الطلب

Assumes an HTML input: <input type="file" id="stsAudioFileJs">

const apiKey = 'YOUR_API_KEY';
const apiUrl = 'https://lahajati.ai/api/v1/speech-to-speech-pro';
const audioFileInput = document.getElementById('stsAudioFileJs');

async function submitSTS() {
    if (!audioFileInput || audioFileInput.files.length === 0) {
         console.error("Please select an audio file.");
         return;
    }

    const formData = new FormData();
    formData.append('audio_file', audioFileInput.files[0]);
    formData.append('id_voice', 'target_voice_id_example');
    formData.append('version', 'lahajati_speech_to_speech_pro_v1'); 

    try {
        const response = await fetch(apiUrl, {
            method: 'POST',
            headers: {
                'Authorization': `Bearer ${apiKey}`,
                'Accept': 'audio/mpeg'
                // Content-Type is set by the browser for FormData
            },
            body: formData
        });

        if (!response.ok) {
            const errorData = await response.json().catch(() => ({ message: response.statusText }));
            throw new Error(`HTTP error ${response.status}: ${errorData.message || 'Unknown error'}`);
        }
        const audioBlob = await response.blob();
        console.log('STS Audio received!');
        // Process audioBlob (e.g., play or download)
    } catch (e) {
        console.error('API Error:', e);
    }
}
// Example: Call submitSTS() when a button is clicked or file is selected
// audioFileInput.addEventListener('change', submitSTS);

أمثلة الطلب

import requests

api_key = 'YOUR_API_KEY'
api_url = 'https://lahajati.ai/api/v1/speech-to-speech-pro'
audio_file_path = 'source_audio.mp3' # Path to your source audio file

headers = {
    'Authorization': f'Bearer {api_key}',
    'Accept': 'audio/mpeg'
    # Content-Type for multipart/form-data is handled by requests when files are passed
}

data_payload = {
    "id_voice": "target_voice_id_example",
    "version": "lahajati_speech_to_speech_pro_v1", 
}

try:
    with open(audio_file_path, 'rb') as audio_f:
        files_payload = {'audio_file': (audio_file_path, audio_f)}
        response = requests.post(
          api_url,
          headers=headers,
          data=data_payload,
          files=files_payload,
          stream=True
        )

    if response.status_code == 200:
        with open('sts_output.mp3', 'wb') as f:
            for chunk in response.iter_content(chunk_size=8192):
                if chunk:
                    f.write(chunk)
        print("STS Audio saved successfully to sts_output.mp3.")
    else:
       print(f"Error ({response.status_code}): {response.text}")

except FileNotFoundError:
    print(f"Error: Source audio file not found at {audio_file_path}")
except Exception as e:
    print(f"An error occurred: {e}")

أمثلة الاستجابة

الاستجابة الناجحة (200 OK)

HTTP/1.1 200 OK
Content-Type: audio/mpeg
Content-Length: 123456

[... raw binary audio data ...]

مثال على جسم استجابة 422 (STS) (مثال لخطأ التحقق من الملف)

{
  "message": "The given data was invalid.",
  "errors": {
    "audio_file": [
      "The audio file must be a file of type: mp3, wav, aac, ogg, m4a, flac."
    ],
    "id_voice": [
      "The id voice field is required."
    ]
  }
}

الحصول على الأصوات

أمثلة الطلب

طلب مفلتر ومفرز (الأصوات المصرية الذكورية، مرتبة حسب التقييم، الصفحة 2)

curl -X GET "https://lahajati.ai/api/v1/voices?gender=1&accent=مصري&per_page=3&sort_by=rating&sort_direction=desc" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"

أمثلة الطلب

use Illuminate\Support\Facades\Http;

$apiKey = 'YOUR_API_KEY';
$apiUrl = 'https://lahajati.ai/api/v1/voices';

$response = Http::withToken($apiKey)
    ->acceptJson()
    ->get($apiUrl, [
       'gender' => '1', // Male
       'accent' => 'مصري',
       'per_page' => 3,
       'sort_by' => 'rating',
       'sort_direction' => 'desc'
     ]);

if ($response->successful()) {
    $voicesData = $response->json();
     // print_r($voicesData['data'] ?? $voicesData); // Access the 'data' array
     echo json_encode($voicesData, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
} else {
     echo "Error: " . $response->status() . "\n";
     echo $response->body();
}

أمثلة الطلب

const apiKey = 'YOUR_API_KEY';
const params = new URLSearchParams({
    gender: '1',
    accent: 'مصري',
    per_page: '3',
    sort_by: 'rating',
    sort_direction: 'desc'
});
const apiUrl = `https://lahajati.ai/api/v1/voices?${params.toString()}`;

async function fetchVoices() {
    try {
        const response = await fetch(apiUrl, {
            method: 'GET',
            headers: {
                'Authorization': `Bearer ${apiKey}`,
                'Accept': 'application/json'
            }
        });
        if (!response.ok) {
            const errorData = await response.json().catch(() => ({ message: response.statusText }));
            throw new Error(`HTTP error ${response.status}: ${errorData.message || 'Unknown error'}`);
        }
        const data = await response.json();
        console.log('Voices:', data.data); // Access the 'data' array
    } catch (e) {
        console.error('API Error:', e);
    }
}
fetchVoices();

أمثلة الطلب

import requests
import json

api_key = 'YOUR_API_KEY'
api_url = 'https://lahajati.ai/api/v1/voices'
headers = {
    'Authorization': f'Bearer {api_key}',
    'Accept': 'application/json'
}
params = {
    'gender': '1',
    'accent': 'مصري',
    'per_page': 3,
    'sort_by': 'rating',
    'sort_direction': 'desc'
}

response = requests.get(api_url, headers=headers, params=params)

if response.status_code == 200:
    # print(json.dumps(response.json()['data'], indent=2, ensure_ascii=False)) # Access 'data'
    print(json.dumps(response.json(), indent=2, ensure_ascii=False))
else:
    print(f"Error ({response.status_code}): {response.text}")

أمثلة الاستجابة

مثال على استجابة ناجحة (200 OK)

{
  "success": true,
  "data": [
    {
      "id_voice": "voice_id_1_example",
      "display_name": "أحمد (مصري)",
      "gender": "male",
      "is_cloned": false,
      "accent": "مصري",
      "category": "عام",
      "average_rating": 4.8,
      "preview_url": "https://..."
    },
    {
      "id_voice": "lvc_cloned_voice_example",
      "display_name": "صوتي المستنسخ",
      "gender": "female",
      "is_cloned": true,
      "accent": "سعودي",
      "category": "خاص",
      "average_rating": null, // Or actual rating if available
      "preview_url": "https://..."
    }
    // ... more voice objects
  ],
  "links": {
    "first": "https://lahajati.ai/api/v1/voices?page=1",
    "last": "https://lahajati.ai/api/v1/voices?page=5",
    "prev": null,
    "next": "https://lahajati.ai/api/v1/voices?page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 5,
    "links": [ /* ... pagination links ... */ ],
    "path": "https://lahajati.ai/api/v1/voices",
    "per_page": 3,
    "to": 3,
    "total": 15
  }
}

مثال على استجابة خطأ التحقق (422 Unprocessable Entity) (مثال لخطأ في معلمات الفرز)

{
    "message": "The given data was invalid.",
    "errors": {
        "sort_by": [
            "The selected sort by is invalid. Allowed values are name, rating, created_at."
        ]
    }
}

إنشاء صوت مستنسخ

أمثلة الطلب

curl -X POST "https://lahajati.ai/api/v1/voices/cloned" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json" \
-F "voice_name=صوتي الجديد الرائع" \
-F "gender=1" \
-F "voice_image=@/path/to/your/avatar.jpg" \
-F "audio_file=@/path/to/your/training_sample.wav" \
-F "voice_tags=تجريبي,عربي"

أمثلة الطلب

use Illuminate\Support\Facades\Http;
use Illuminate\Support\Facades\Storage;

$apiKey = 'YOUR_API_KEY';
$apiUrl = 'https://lahajati.ai/api/v1/voices/cloned';
$imagePath = storage_path('app/public/avatar.jpg'); // Example path
$audioPath = storage_path('app/public/training_sample.wav'); // Example path

// Ensure files exist before attempting to read
if (!file_exists($imagePath) || !file_exists($audioPath)) {
    die("Error: One or both files not found.");
}

$response = Http::withToken($apiKey)
    ->acceptJson()
    ->attach('voice_image', file_get_contents($imagePath), basename($imagePath))
    ->attach('audio_file', file_get_contents($audioPath), basename($audioPath))
    ->post($apiUrl, [
        'voice_name'    => 'صوتي الجديد PHP',
        'gender'        => '1', // 1 for Male, 2 for Female, 3 for Child
        'voice_tags'    => 'تجريبي,PHP',
        'enhance_audio' => 'false' // Send as string for form-data
    ]);

if ($response->successful()) {
    echo "Cloned Voice Created Successfully:\n";
    echo json_encode($response->json(), JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
} else {
     echo "Error: " . $response->status() . "\n";
     echo $response->body();
}

أمثلة الطلب

Assumes HTML inputs: <input type="file" id="cvImageFileJs"> and <input type="file" id="cvAudioFileJs">

const apiKey = 'YOUR_API_KEY';
const apiUrl = 'https://lahajati.ai/api/v1/voices/cloned';

const imageInput = document.getElementById('cvImageFileJs');
const audioInput = document.getElementById('cvAudioFileJs');
// const voiceNameInput = document.getElementById('voiceNameInput'); // Example
// const genderSelect = document.getElementById('genderSelect'); // Example

async function createClonedVoice() {
    if (!imageInput.files[0] || !audioInput.files[0]) {
        console.error("Please select an image and an audio file.");
        return;
    }

    const formData = new FormData();
    formData.append('voice_name', 'صوتي الجديد JS' /* voiceNameInput.value */);
    formData.append('gender', '1' /* genderSelect.value */);
    formData.append('voice_image', imageInput.files[0]);
    formData.append('audio_file', audioInput.files[0]);
    formData.append('voice_tags', 'تجريبي,JavaScript');
    // formData.append('enhance_audio', 'true'); // Optional

    try {
        const response = await fetch(apiUrl, {
            method: 'POST',
            headers: {
                'Authorization': `Bearer ${apiKey}`,
                'Accept': 'application/json'
                // Content-Type is set by browser for FormData
            },
            body: formData
        });

        const result = await response.json();
        if (!response.ok) {
            throw new Error(`HTTP error ${response.status}: ${result.message || 'Unknown error'}. Errors: ${JSON.stringify(result.errors)}`);
        }
        console.log('Cloned Voice Created:', result);
    } catch (e) {
        console.error('API Error:', e);
    }
}
// Example: Call createClonedVoice() when a button is clicked
// document.getElementById('createCloneBtn').addEventListener('click', createClonedVoice);

أمثلة الطلب

import requests
import json

api_key = 'YOUR_API_KEY'
api_url = 'https://lahajati.ai/api/v1/voices/cloned'
image_path = 'avatar.jpg' # Path to your image file
audio_path = 'training_sample.wav' # Path to your audio file

headers = {
    'Authorization': f'Bearer {api_key}',
    'Accept': 'application/json'
    # Content-Type for multipart/form-data is handled by requests
}
data = {
    'voice_name': 'صوتي الجديد Python',
    'gender': '1', # 1: Male, 2: Female, 3: Child
    'voice_tags': 'تجريبي,Python',
    # 'enhance_audio': 'true' # Optional
}

try:
    with open(image_path, 'rb') as img_f, open(audio_path, 'rb') as audio_f:
        files = {
            'voice_image': (image_path, img_f),
            'audio_file': (audio_path, audio_f)
        }
        response = requests.post(api_url, headers=headers, data=data, files=files)

    if response.status_code == 201: # Created
         print("Cloned Voice Created Successfully:")
         print(json.dumps(response.json(), indent=2, ensure_ascii=False))
    else:
        print(f"Error ({response.status_code}): {response.text}")

except FileNotFoundError as e:
    print(f"File not found: {e.filename}")
except Exception as e:
    print(f"An error occurred: {e}")

أمثلة الاستجابة

الاستجابة الناجحة (201 Created) (201 Created)

{
  "success": true,
  "message": "Cloned voice created successfully. Processing may take some time.",
  "voice": {
    "id_voice": "lvc_a1b2c3d4e5f6",
    "name": "صوتي الجديد الرائع",
    "gender": "male", // or "female", "child"
    "image_url": "https://yourdomain.com/storage/cloned_voices_images/avatar.jpg",
    "is_cloned": true,
    "tags": "تجريبي,عربي",
    "status": "processing" // Could be 'active', 'processing', 'failed'
  }
}

فشل التحقق من صحة المدخلات (مثل: اسم مفقود، نوع ملف غير صالح، حجم ملف كبير جدًا). (مثال لخطأ التحقق)

{
    "message": "The given data was invalid.",
    "errors": {
        "voice_name": [
            "The voice name field is required."
        ],
        "audio_file": [
            "The audio file failed to upload.",
            "The audio file must be a file of type: mp3, wav, aac, ogg, flac, m4a."
        ]
    }
}

تعديل صوت مستنسخ

أمثلة الطلب

لتحديث البيانات فقط (بدون ملف صورة جديد، باستخدام JSON):

VOICE_ID="lvc_xxxxxxxxxxxx"
curl -X PUT "https://lahajati.ai/api/v1/voices/cloned/${VOICE_ID}" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
  "voice_name": "اسم محدث للصوت",
  "voice_tags": "محدث,رسمي"
}'

لتحديث البيانات مع ملف صورة جديد (استخدام `multipart/form-data` مع `POST` و `_method=PUT` لـ Laravel):

VOICE_ID="lvc_xxxxxxxxxxxx"
curl -X POST "https://lahajati.ai/api/v1/voices/cloned/${VOICE_ID}" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -F "_method=PUT" \
  -F "voice_name=اسم محدث مع صورة" \
  -F "voice_image=@/path/to/new_avatar.png"

أمثلة الطلب

use Illuminate\Support\Facades\Http;

$apiKey = 'YOUR_API_KEY';
$voiceId = 'lvc_xxxxxxxxxxxx'; // Update with actual ID
$apiUrl = str_replace('{id_voice}', $voiceId, 'https://lahajati.ai/api/v1/voices/cloned/{id_voice}');

$dataToUpdate = [
    'voice_name' => 'الاسم المحدث عبر PHP',
    'gender' => '2', // Female
    'voice_tags' => 'محدث,PHP'
];
$newImagePath = null; // storage_path('app/public/new_avatar.png'); // Optional: Path to new image file

$request = Http::withToken($apiKey)->acceptJson();

if ($newImagePath && file_exists($newImagePath)) {
    // If sending a file, it must be multipart. Laravel's Http client handles this.
    // We will use PUT directly if the server route is Route::put()
    $request->attach('voice_image', file_get_contents($newImagePath), basename($newImagePath));
    $response = $request->put($apiUrl, $dataToUpdate);
} else {
    // If not sending a file, we can send as JSON
    $response = $request->asJson()->put($apiUrl, $dataToUpdate);
}

if ($response->successful()) {
    echo "Cloned Voice Updated Successfully:\n";
    echo json_encode($response->json(), JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
} else {
     echo "Error: " . $response->status() . "\n";
     echo $response->body();
}

أمثلة الطلب

Assumes an HTML input for new image: <input type="file" id="cvUpdateImageFileJs">

const apiKey = 'YOUR_API_KEY';
const voiceId = 'lvc_xxxxxxxxxxxx'; // Update with actual ID
const apiUrl = `https://lahajati.ai/api/v1/voices/cloned/{id_voice}`.replace('{id_voice}', voiceId);

const updateImageInput = document.getElementById('cvUpdateImageFileJs');
// const updatedVoiceNameInput = document.getElementById('updatedVoiceName'); // Example

async function updateClonedVoice() {
    let headers = {
        'Authorization': `Bearer ${apiKey}`,
        'Accept': 'application/json'
    };
    let body;
    const method = 'PUT'; // Directly use PUT

    const dataToUpdate = {
        voice_name: 'الاسم المحدث JS' /* updatedVoiceNameInput.value */,
        voice_tags: 'محدث,JavaScript'
    };

    if (updateImageInput && updateImageInput.files[0]) {
        // Sending a file, use FormData
        const formData = new FormData();
        formData.append('voice_name', dataToUpdate.voice_name);
        formData.append('voice_tags', dataToUpdate.voice_tags);
        // formData.append('gender', '2'); // Example if updating gender
        formData.append('voice_image', updateImageInput.files[0]);
        body = formData;
        // Don't set Content-Type for FormData, browser does it.
    } else {
        // Sending JSON data
        headers['Content-Type'] = 'application/json';
        body = JSON.stringify(dataToUpdate);
    }

    try {
        const response = await fetch(apiUrl, {
            method: method,
            headers: headers,
            body: body
        });

        const result = await response.json();
        if (!response.ok) {
            throw new Error(`HTTP error ${response.status}: ${result.message || 'Unknown error'}. Errors: ${JSON.stringify(result.errors)}`);
        }
        console.log('Cloned Voice Updated:', result);
    } catch (e) {
        console.error('API Error:', e);
    }
}
// Example: document.getElementById('updateCloneBtn').addEventListener('click', updateClonedVoice);

أمثلة الطلب

import requests
import json

api_key = 'YOUR_API_KEY'
voice_id = 'lvc_xxxxxxxxxxxx' # Update with actual ID
api_url = f"https://lahajati.ai/api/v1/voices/cloned/{id_voice}".replace('{id_voice}', voice_id)

new_image_path = None # 'new_avatar.png' # Optional: Path to new image file

headers = {
    'Authorization': f'Bearer {api_key}',
    'Accept': 'application/json'
}
# Data to update (only send fields you want to change)
data_payload = {
    'voice_name': 'الاسم المحدث Python',
    'voice_tags': 'محدث,Python'
}
files_payload = None
img_f_to_close = None

if new_image_path:
    try:
        img_f_to_close = open(new_image_path, 'rb')
        files_payload = {'voice_image': (new_image_path, img_f_to_close)}
        # When sending files, requests will use multipart/form-data for PUT
    except FileNotFoundError:
        print(f"New image file not found: {new_image_path}")


if not files_payload: # Sending JSON
    headers['Content-Type'] = 'application/json'
    response = requests.put(api_url, headers=headers, json=data_payload)
else: # Sending multipart/form-data
    response = requests.put(api_url, headers=headers, data=data_payload, files=files_payload)

if img_f_to_close:
    img_f_to_close.close()

if response.status_code == 200:
     print("Cloned Voice Updated Successfully:")
     print(json.dumps(response.json(), indent=2, ensure_ascii=False))
else:
    print(f"Error ({response.status_code}): {response.text}")

أمثلة الاستجابة

الاستجابة الناجحة (200 OK) (200 OK)

{
  "success": true,
  "message": "Cloned voice updated successfully.",
  "voice": {
    "id_voice": "lvc_xxxxxxxxxxxx",
    "name": "الاسم المحدث للصوت",
     "gender": "female", // Example if gender was updated
     "image_url": "https://yourdomain.com/storage/cloned_voices_images/new_avatar.png", // If image updated
     "is_cloned": true,
     "tags": "محدث,رسمي",
     "status": "active"
  }
}

الصوت المستنسخ غير موجود، أو لا تملك الصلاحية لتعديله.

{
    "success": false,
    "message": "Cloned voice not found or you do not have permission to edit it."
}

حذف صوت مستنسخ

أمثلة الطلب

VOICE_ID="lvc_xxxxxxxxxxxx"
curl -X DELETE "https://lahajati.ai/api/v1/voices/cloned/${VOICE_ID}" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"

أمثلة الطلب

use Illuminate\Support\Facades\Http;

$apiKey = 'YOUR_API_KEY';
$voiceId = 'lvc_xxxxxxxxxxxx'; // Update with actual ID
$apiUrl = str_replace('{id_voice}', $voiceId, 'https://lahajati.ai/api/v1/voices/cloned/{id_voice}');

$response = Http::withToken($apiKey)
    ->acceptJson()
    ->delete($apiUrl);

if ($response->successful()) {
    echo "Cloned Voice Deleted Successfully:\n";
    echo json_encode($response->json(), JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
} else {
     echo "Error: " . $response->status() . "\n";
     echo $response->body();
}

أمثلة الطلب

const apiKey = 'YOUR_API_KEY';
const voiceId = 'lvc_xxxxxxxxxxxx'; // Update with actual ID
const apiUrl = `https://lahajati.ai/api/v1/voices/cloned/{id_voice}`.replace('{id_voice}', voiceId);

async function deleteClonedVoice() {
    try {
        const response = await fetch(apiUrl, {
            method: 'DELETE',
            headers: {
                'Authorization': `Bearer ${apiKey}`,
                'Accept': 'application/json'
            }
        });
        const result = await response.json();
        if (!response.ok) {
           throw new Error(`HTTP error ${response.status}: ${result.message || 'Unknown error'}`);
        }
        console.log('Delete Result:', result);
    } catch (e) {
        console.error('API Error:', e);
    }
}
// deleteClonedVoice();

أمثلة الطلب

import requests
import json

api_key = 'YOUR_API_KEY'
voice_id = 'lvc_xxxxxxxxxxxx' # Update with actual ID
api_url = f"https://lahajati.ai/api/v1/voices/cloned/{id_voice}".replace('{id_voice}', voice_id)

headers = {
    'Authorization': f'Bearer {api_key}',
    'Accept': 'application/json'
}

response = requests.delete(api_url, headers=headers)

if response.status_code == 200:
     print("Cloned Voice Deleted Successfully:")
     print(json.dumps(response.json(), indent=2, ensure_ascii=False))
else:
    print(f"Error ({response.status_code}): {response.text}")

أمثلة الاستجابة

الاستجابة الناجحة (200 OK) (200 OK)

{
  "success": true,
  "message": "Cloned voice deleted successfully."
}

الصوت المستنسخ غير موجود، أو لا تملك الصلاحية لتعديله. (مثال لخطأ 404)

{
    "success": false,
    "message": "Cloned voice not found or you do not have permission to delete it."
}