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 (معرف)	نعم	المعرف الفريد لمؤدي الصوت المطلوب. يمكن الحصول عليه عبر نقطة النهاية الحصول على الأصوات.
`privacy`	boolean (منطقي)	لا (الافتراضي `0`)	اضبط القيمة على `1` لخصوصية أكثر ( عند ضبطها 1 يتم التعامل مع التحويل كمجهول ولايتم حفظ العملية إطلاقا في قواعدنا ).
`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 (معرف)	نعم	المعرف الفريد لمؤدي الصوت المطلوب. يمكن الحصول عليه عبر نقطة النهاية الحصول على الأصوات.
`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)	عدد الأصوات التي يتم إرجاعها في كل صفحة.
`gender`	string (نص)	لا	فلترة حسب الجنس. القيم المسموح بها: `1` (ذكر)، `2` (أنثى)، `3` (أطفال).

الاستجابة الناجحة (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` (طفل).
`audio_file`	file (ملف صوتي)	نعم	ملف صوتي واحد للتدريب على استنساخ الصوت. الأنواع المدعومة: `mp3, wav, aac, ogg, flac, m4a`. الحجم الأقصى: 50 ميجابايت. (جودة جيدة ووضوح بدون ضوضاء خلفية يعطي أفضل النتائج).
`enhance_audio`	boolean (منطقي)	لا (الافتراضي `false`)	اضبط على `true` لتحسين جودة ملف الصوت التدريبي قبل إرساله لنموذج الاستنساخ (قد يزيد من وقت المعالجة).
`voice_image`	file (صورة)	لا	صورة للصوت المستنسخ. الأنواع المدعومة: `jpeg, png, jpg, gif, webp`. الحجم الأقصى: 2 ميجابايت.
`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 فشل حذف الصوت المستنسخ (قد يكون بسبب مشكلة في خدمة خارجية).

التحكم المطلق في توليد الكلام

توفر نقاط النهاية هذه تحكمًا دقيقًا ومتقدمًا في عملية توليد الكلام. يمكنك تحديد اللهجة وأسلوب الأداء بشكل منفصل أو توفير توجيهات نصية مخصصة (prompt) للحصول على المخرجات الصوتية المطلوبة بدقة.

GETGET الحصول على أصوات التحكم المطلق

https://lahajati.ai/api/v1/voices-absolute-control

يجلب قائمة بالأصوات المتاحة خصيصًا للاستخدام مع نقطة نهاية "توليد الكلام بالتحكم المطلق".

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

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

المعلمة	النوع	مطلوب	الوصف
`page`	integer (عدد صحيح)	لا (الافتراضي 1)	رقم الصفحة المطلوب من النتائج.
`per_page`	integer (عدد صحيح)	لا (الافتراضي 15، الأقصى 100)	عدد الأصوات التي يتم إرجاعها في كل صفحة.
`gender`	string (نص)	لا	فلترة حسب الجنس. القيم المسموح بها: `1` (ذكر)، `2` (أنثى)، `3` (أطفال).

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

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

GETGET الحصول على أنماط الأداء

https://lahajati.ai/api/v1/performance-absolute-control

يجلب قائمة بأنماط الأداء المتاحة (مثل درامي، إخباري، إعلاني) التي يمكن استخدامها لتوجيه نموذج توليد الكلام.

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

المعلمة	النوع	مطلوب	الوصف
`page`	integer (عدد صحيح)	لا (الافتراضي 1)	رقم الصفحة المطلوب من النتائج.
`per_page`	integer (عدد صحيح)	لا (الافتراضي 15، الأقصى 100)	عدد الأصوات التي يتم إرجاعها في كل صفحة.

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

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

GETGET الحصول على اللهجات

https://lahajati.ai/api/v1/dialect-absolute-control

يجلب قائمة باللهجات المتاحة (مثل المصرية، السعودية النجدية) التي يمكن استخدامها لتوجيه نموذج توليد الكلام.

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

المعلمة	النوع	مطلوب	الوصف
`page`	integer (عدد صحيح)	لا (الافتراضي 1)	رقم الصفحة المطلوب من النتائج.
`per_page`	integer (عدد صحيح)	لا (الافتراضي 15، الأقصى 100)	عدد الأصوات التي يتم إرجاعها في كل صفحة.

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

إرجاع قائمة مقسمة إلى صفحات لكائنات اللهجات.

POSTPOST توليد الكلام بالتحكم المطلق

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

يولد كلامًا من نص باستخدام صوت محدد وتحكم دقيق في الأداء عبر وضعين: الوضع المنظم (باستخدام معرفات الأداء واللهجة) أو وضع التوجيه المخصص.

فهم معلمة `input_mode`

هذه المعلمة هي مفتاح التحكم في هذه النقطة. لديها وضعان:

الوضع `0` (المنظم): في هذا الوضع، تقوم بتمرير `performance_id` و/أو `dialect_id` (اختياريان). سيقوم النظام بإنشاء التوجيه المناسب للذكاء الاصطناعي بناءً على اختياراتك. هذا هو الخيار الموصى به لمعظم حالات الاستخدام.
الوضع `1` (المخصص): في هذا الوضع، يتم تجاهل `performance_id` و `dialect_id`. بدلاً من ذلك، تقوم بتمرير توجيه نصي حر ومفصل في `custom_prompt_text`، مما يمنحك تحكمًا كاملاً. مثال: "تحدث ببطء وبهدوء، مع وقفات بين الجمل، كأنك تروي قصة أطفال.".

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

المعلمة	النوع	مطلوب	الوصف
`text`	string (نص)	نعم	النص المراد تحويله إلى كلام.
`id_voice`	string (معرف)	نعم	GET الحصول على أصوات التحكم المطلق: المعرف الفريد لمؤدي الصوت المطلوب. يمكن الحصول عليه عبر نقطة النهاية الحصول على الأصوات.
`input_mode`	string ("0" or "1")	نعم	يحدد وضع التحكم. `0` للوضع المنظم (باستخدام معرفات)، `1` لوضع التوجيه المخصص.
`performance_id`	string (معرف)	لا (مطلوب إذا كان `input_mode` هو `0`)	معرف نمط الأداء. يتم الحصول عليه من نقطة نهاية الحصول على أنماط الأداء.
`dialect_id`	string (معرف)	لا (مطلوب إذا كان `input_mode` هو `0`)	معرف اللهجة. يتم الحصول عليه من نقطة نهاية الحصول على اللهجات.
`custom_prompt_text`	string (نص)	لا (مطلوب إذا كان `input_mode` هو `1`)	توجيه نصي مخصص ومفصل لوصف الأداء المطلوب.

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

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

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

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

401 ليس لديك الإذن أو الباقة اللازمة لاستخدام هذا الصوت.
401 رصيد نقاطك غير كافٍ لإتمام عملية توليد الصوت.
404 المعرف `id_voice` المحدد غير موجود.
422 فشل التحقق من صحة الإدخال. تأكد من أن المعلمات المطلوبة لكل `input_mode` موجودة.

توليد الكلام بالتحكم المطلق

مثال على الوضع المنظم (`input_mode: "0"`)

curl -X POST "https://lahajati.ai/api/v1/text-to-speech-absolute-control" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: audio/mpeg" \
-d '{
  "text": "هذا اختبار للوضع المنظم.",
  "id_voice": "ac_voice_xyz789",
  "input_mode": "0",
  "performance_id": "perf_1",
  "dialect_id": "dialect_10"
}' \
--output structured_output.mp3

مثال على وضع التوجيه المخصص (`input_mode: "1"`)

curl -X POST "https://lahajati.ai/api/v1/text-to-speech-absolute-control" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: audio/mpeg" \
-d '{
  "text": "هذا اختبار للتوجيه المخصص.",
  "id_voice": "ac_voice_xyz789",
  "input_mode": "1",
  "custom_prompt_text": "اقرأ النص التالي بصوت عالٍ وواضح، كأنك تقدم نشرة إخبارية عاجلة."
}' \
--output custom_prompt_output.mp3

مثال على الوضع المنظم (`input_mode: "0"`)

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

$response = Http::withToken('YOUR_API_KEY')
    ->accept('audio/mpeg')
    ->post('https://lahajati.ai/api/v1/text-to-speech-absolute-control', [
        'text'           => 'هذا اختبار للوضع المنظم.',
        'id_voice'       => 'ac_voice_xyz789',
        'input_mode'     => '0',
        'performance_id' => 'perf_1',
        'dialect_id'     => 'dialect_10'
    ]);

if ($response->successful()) {
    Storage::disk('public')->put('structured_output.mp3', $response->body());
}

مثال على وضع التوجيه المخصص (`input_mode: "1"`)

$response = Http::withToken('YOUR_API_KEY')
    ->accept('audio/mpeg')
    ->post('https://lahajati.ai/api/v1/text-to-speech-absolute-control', [
        'text'               => 'هذا اختبار للتوجيه المخصص.',
        'id_voice'           => 'ac_voice_xyz789',
        'input_mode'         => '1',
        'custom_prompt_text' => 'اقرأ النص التالي بصوت عالٍ وواضح، كأنك تقدم نشرة إخبارية عاجلة.'
    ]);

if ($response->successful()) {
    Storage::disk('public')->put('custom_prompt_output.mp3', $response->body());
}

مثال على الوضع المنظم (`input_mode: "0"`)

const structuredData = {
    text: "هذا اختبار للوضع المنظم.",
    id_voice: "ac_voice_xyz789",
    input_mode: "0",
    performance_id: "perf_1",
    dialect_id: "dialect_10"
};

fetch('https://lahajati.ai/api/v1/text-to-speech-absolute-control', {
    method: 'POST',
    headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json',
        'Accept': 'audio/mpeg'
    },
    body: JSON.stringify(structuredData)
})
.then(response => response.blob())
.then(blob => console.log('Structured audio received!'))
.catch(error => console.error('Error:', error));

مثال على وضع التوجيه المخصص (`input_mode: "1"`)

const customData = {
    text: "هذا اختبار للتوجيه المخصص.",
    id_voice: "ac_voice_xyz789",
    input_mode: "1",
    custom_prompt_text": "اقرأ النص التالي بصوت عالٍ وواضح، كأنك تقدم نشرة إخبارية عاجلة."
};

fetch('https://lahajati.ai/api/v1/text-to-speech-absolute-control', {
    method: 'POST',
    headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json',
        'Accept': 'audio/mpeg'
    },
    body: JSON.stringify(customData)
})
.then(response => response.blob())
.then(blob => console.log('Custom prompt audio received!'))
.catch(error => console.error('Error:', error));

مثال على الوضع المنظم (`input_mode: "0"`)

import requests

headers = {
    'Authorization': f'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
    'Accept': 'audio/mpeg'
}
structured_data = {
    "text": "هذا اختبار للوضع المنظم.",
    "id_voice": "ac_voice_xyz789",
    "input_mode": "0",
    "performance_id": "perf_1",
    "dialect_id": "dialect_10"
}
response = requests.post('https://lahajati.ai/api/v1/text-to-speech-absolute-control', headers=headers, json=structured_data)

if response.status_code == 200:
    with open('structured_output.mp3', 'wb') as f:
        f.write(response.content)
    print("Structured audio saved.")

مثال على وضع التوجيه المخصص (`input_mode: "1"`)

custom_data = {
    "text": "هذا اختبار للتوجيه المخصص.",
    "id_voice": "ac_voice_xyz789",
    "input_mode": "1",
    "custom_prompt_text": "اقرأ النص التالي بصوت عالٍ وواضح، كأنك تقدم نشرة إخبارية عاجلة."
}
response = requests.post('https://lahajati.ai/api/v1/text-to-speech-absolute-control', headers=headers, json=custom_data)

if response.status_code == 200:
    with open('custom_prompt_output.mp3', 'wb') as f:
        f.write(response.content)
    print("Custom prompt audio saved.")

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

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

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

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

فشل التحقق من صحة الإدخال. تأكد من أن المعلمات المطلوبة لكل `input_mode` موجودة.

{
    "success": false,
    "errors": {
        "input_mode": [
            "The input mode field is required."
        ],
        "custom_prompt_text": [
            "The custom prompt text field is required when input mode is 1."
        ]
    }
}

الحصول على أصوات التحكم المطلق

curl -X GET "https://lahajati.ai/api/v1/voices-absolute-control" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"

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

{
  "success": true,
  "data": [
    {
      "id_voice": "ac_voice_xyz789",
      "display_name": "صوت تحكم مطلق - أحمد",
      "gender": "male",
      "is_cloned": false,
      "average_rating": null
    }
  ],
  "meta": { /* ... pagination info ... */ }
}

الحصول على أنماط الأداء

curl -X GET "https://lahajati.ai/api/v1/performance-absolute-control" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"

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

{
  "success": true,
  "data": [
    {
      "performance_id": "perf_1",
      "display_name": "أداء درامي"
    },
    {
      "performance_id": "perf_2",
      "display_name": "أداء إخباري"
    }
  ],
  "meta": { /* ... pagination info ... */ }
}

الحصول على اللهجات

curl -X GET "https://lahajati.ai/api/v1/dialect-absolute-control" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"

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

{
  "success": true,
  "data": [
    {
      "dialect_id": "dialect_10",
      "display_name": "اللهجة المصرية"
    },
    {
      "dialect_id": "dialect_12",
      "display_name": "اللهجة السعودية (نجدية)"
    }
  ],
  "meta": { /* ... pagination info ... */ }
}

تحويل النص إلى كلام الفائقة

أمثلة الطلب

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", 
  "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', 
    ]);

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", 
};

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

    } 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", 
}

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):
             if chunk:
                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" \ 
--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', 
    ]);

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

    try {
        const response = await fetch(apiUrl, {
            method: 'POST',
            headers: {
                'Authorization': `Bearer ${apiKey}`,
                'Accept': 'audio/mpeg'
            },
            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!');
    } catch (e) {
        console.error('API Error:', e);
    }
}

أمثلة الطلب

import requests

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

headers = {
    'Authorization': f'Bearer {api_key}',
    'Accept': 'audio/mpeg'
}

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

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."
    ]
  }
}

الحصول على الأصوات الفائقة

أمثلة الطلب

curl -X GET "https://lahajati.ai/api/v1/voices?gender=1&per_page=25&page=1" \
-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',
       'per_page' => 25
     ]);

if ($response->successful()) {
    $voicesData = $response->json();
    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', 
    'per_page': 25,
});
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'
            }
        });
        const data = await response.json();
        if (!response.ok) {
            throw new Error(data.message || 'Error fetching voices');
        }
        console.log('Voices:', data.data);
    } 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', 
    'per_page': 25,
}

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

if response.status_code == 200:
    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://..."
    }
  ],
  "links": { /* ... */ },
  "meta": { /* ... */ }
}

إنشاء صوت مستنسخ الفائقة

أمثلة الطلب

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;

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

$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',
        'voice_tags'    => 'تجريبي,PHP',
    ]);

if ($response->successful()) {
    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');

async function createClonedVoice() {
    if (!imageInput.files[0] || !audioInput.files[0]) { return; }

    const formData = new FormData();
    formData.append('voice_name', 'صوتي الجديد JS');
    formData.append('gender', '1');
    formData.append('voice_image', imageInput.files[0]);
    formData.append('audio_file', audioInput.files[0]);

    try {
        const response = await fetch(apiUrl, {
            method: 'POST',
            headers: {
                'Authorization': `Bearer ${apiKey}`,
                'Accept': 'application/json'
            },
            body: formData
        });

        const result = await response.json();
        if (!response.ok) { throw new Error(result.message); }
        console.log('Cloned Voice Created:', result);
    } catch (e) {
        console.error('API Error:', e);
    }
}

أمثلة الطلب

import requests
import json

api_key = 'YOUR_API_KEY'
api_url = 'https://lahajati.ai/api/v1/voices/cloned'
image_path = 'avatar.jpg'
audio_path = 'training_sample.wav'

headers = { 'Authorization': f'Bearer {api_key}', 'Accept': 'application/json' }
data = { 'voice_name': 'صوتي الجديد Python', 'gender': '1' }

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:
         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}")

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

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

{
  "success": true,
  "message": "Cloned voice created successfully...",
  "voice": {
    "id_voice": "lvc_a1b2c3d4e5f6",
    "name": "صوتي الجديد الرائع",
    "gender": "male",
    "status": "processing"
  }
}

تعديل صوت مستنسخ الفائقة

أمثلة الطلب

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": "اسم محدث"}'

أمثلة الطلب

use Illuminate\Support\Facades\Http;

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

$response = Http::withToken($apiKey)->acceptJson()->put($apiUrl, [
    'voice_name' => 'الاسم المحدث عبر PHP',
    'gender' => '2'
]);

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

أمثلة الطلب

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

async function updateClonedVoice() {
    const dataToUpdate = { voice_name: 'الاسم المحدث JS' };
    try {
        const response = await fetch(apiUrl, {
            method: 'PUT',
            headers: {
                'Authorization': `Bearer ${apiKey}`,
                'Accept': 'application/json',
                'Content-Type': 'application/json'
            },
            body: JSON.stringify(dataToUpdate)
        });
        const result = await response.json();
        if (!response.ok) { throw new Error(result.message); }
        console.log('Cloned Voice Updated:', result);
    } catch (e) {
        console.error('API Error:', e);
    }
}

أمثلة الطلب

import requests
import json

api_key = 'YOUR_API_KEY'
voice_id = 'lvc_xxxxxxxxxxxx'
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',
    'Content-Type': 'application/json'
}
data_payload = { 'voice_name': 'الاسم المحدث Python' }

response = requests.put(api_url, headers=headers, json=data_payload)

if response.status_code == 200:
     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": "الاسم المحدث للصوت"
  }
}

حذف صوت مستنسخ الفائقة

أمثلة الطلب

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';
$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 json_encode($response->json(), JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
} else {
    echo "Error: " . $response->status() . " " . $response->body();
}

أمثلة الطلب

const apiKey = 'YOUR_API_KEY';
const voiceId = 'lvc_xxxxxxxxxxxx';
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(result.message); }
        console.log('Delete Result:', result);
    } catch (e) {
        console.error('API Error:', e);
    }
}

أمثلة الطلب

import requests
import json

api_key = 'YOUR_API_KEY'
voice_id = 'lvc_xxxxxxxxxxxx'
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(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."
}