تخصيص نموذج لغة باستخدام واجهة برمجة تطبيقات Azure Video Indexer
يتيح لك Azure Video Indexer (المعروف سابقا باسم Azure Video Analyzer for Media) إنشاء نماذج لغة مخصصة لتخصيص التعرف على الكلام عن طريق تحميل نص التكيف، أي النص من المجال الذي تريد أن يتكيف المحرك مع مفرداته. بمجرد تدريب النموذج الخاص بك ، سيتم التعرف على الكلمات الجديدة التي تظهر في نص التكيف.
للحصول على نظرة عامة مفصلة وأفضل الممارسات لنماذج اللغات المخصصة، راجع تخصيص نموذج لغة باستخدام مفهرس فيديو Azure.
يمكنك استخدام واجهات برمجة تطبيقات Azure Video Indexer لإنشاء نماذج لغات مخصصة وتحريرها في حسابك، كما هو موضح في هذا الموضوع. يمكنك أيضا استخدام موقع ويب، كما هو موضح في نموذج تخصيص اللغة باستخدام موقع Azure Video Indexer على الويب.
إنشاء نموذج لغة
تنشئ واجهة برمجة تطبيقات إنشاء نموذج لغة نموذجا مخصصا جديدا في الحساب المحدد. يمكنك تحميل ملفات لنموذج اللغة في هذه المكالمة. بدلا من ذلك، يمكنك إنشاء نموذج اللغة هنا وتحميل ملفات للنموذج لاحقا عن طريق تحديث نموذج اللغة.
ملاحظة
لا يزال يتعين عليك تدريب النموذج بملفاته الممكنة للنموذج لمعرفة محتويات ملفاته. الاتجاهات حول تدريب لغة ما موجودة في القسم التالي.
لتحميل الملفات المراد إضافتها إلى نموذج اللغة، يجب تحميل الملفات في النص الأساسي باستخدام FormData بالإضافة إلى توفير قيم للمعلمات المطلوبة أعلاه. هناك طريقتان للقيام بهذه المهمة:
- سيكون المفتاح هو اسم الملف وستكون القيمة هي ملف txt.
- سيكون المفتاح هو اسم الملف وستكون القيمة عنوان URL لملف txt.
الاستجابة
توفر الاستجابة بيانات وصفية حول نموذج اللغة الذي تم إنشاؤه حديثا إلى جانب بيانات وصفية على كل ملف من ملفات النموذج باتباع تنسيق إخراج JSON المثالي:
{
"id": "dfae5745-6f1d-4edd-b224-42e1ab57a891",
"name": "TestModel",
"language": "En-US",
"state": "None",
"languageModelId": "00000000-0000-0000-0000-000000000000",
"files": [
{
"id": "25be7c0e-b6a6-4f48-b981-497e920a0bc9",
"name": "hellofile",
"enable": true,
"creator": "John Doe",
"creationTime": "2018-04-28T11:55:34.6733333"
},
{
"id": "33025f5b-2354-485e-a50c-4e6b76345ca7",
"name": "worldfile",
"enable": true,
"creator": "John Doe",
"creationTime": "2018-04-28T11:55:34.86"
}
]
}
تدريب نموذج لغة
تقوم واجهة برمجة تطبيقات تدريب نموذج لغة بتدريب نموذج لغة مخصص في الحساب المحدد مع محتويات الملفات التي تم تحميلها وتمكينها في نموذج اللغة.
ملاحظة
يجب عليك أولا إنشاء نموذج اللغة وتحميل ملفاته. يمكنك تحميل الملفات عند إنشاء نموذج اللغة أو عن طريق تحديث نموذج اللغة.
الاستجابة
توفر الاستجابة بيانات وصفية عن نموذج اللغة المدرب حديثا إلى جانب بيانات وصفية على كل ملف من ملفات النموذج باتباع تنسيق إخراج JSON المثالي:
{
"id": "41464adf-e432-42b1-8e09-f52905d7e29d",
"name": "TestModel",
"language": "En-US",
"state": "Waiting",
"languageModelId": "531e5745-681d-4e1d-b124-12e5ab57a891",
"files": [
{
"id": "84fcf1ac-1952-48f3-b372-18f768eedf83",
"name": "RenamedFile",
"enable": false,
"creator": "John Doe",
"creationTime": "2018-04-27T20:10:10.5233333"
},
{
"id": "9ac35b4b-1381-49c4-9fe4-8234bfdd0f50",
"name": "hellofile",
"enable": true,
"creator": "John Doe",
"creationTime": "2018-04-27T20:10:10.68"
}
]
}
المعرف الذي تم إرجاعه id هو معرف فريد يستخدم للتمييز بين نماذج اللغات، بينما languageModelId يستخدم لتحميل فيديو لفهرستهوإعادة فهرسة واجهات برمجة تطبيقات الفيديو (المعروف أيضا باسم linguisticModelId واجهات برمجة تطبيقات تحميل/إعادة فهرسة فيديو Azure).
حذف نموذج لغة
تحذف واجهة برمجة تطبيقات حذف نموذج لغة مخصص من الحساب المحدد. سيحتفظ أي فيديو كان يستخدم نموذج اللغة المحذوف بنفس الفهرس حتى تعيد فهرسة الفيديو. إذا أعدت فهرسة الفيديو، يمكنك تعيين نموذج لغة جديد للفيديو. وإلا، فسيستخدم Azure Video Indexer نموذجه الافتراضي لإعادة فهرسة الفيديو.
الاستجابة
لا يوجد محتوى تم إرجاعه عند حذف نموذج اللغة بنجاح.
تحديث نموذج لغة
تحديث واجهة برمجة تطبيقات نموذج اللغة تحديث نموذج شخص لغة مخصص في الحساب المحدد.
ملاحظة
يجب أن تكون قد أنشأت بالفعل نموذج اللغة. يمكنك استخدام هذه المكالمة لتمكين كافة الملفات الموجودة ضمن النموذج أو تعطيلها، وتحديث اسم نموذج اللغة، وتحميل الملفات لإضافتها إلى نموذج اللغة.
لتحميل الملفات المراد إضافتها إلى نموذج اللغة، يجب تحميل الملفات في النص الأساسي باستخدام FormData بالإضافة إلى توفير قيم للمعلمات المطلوبة أعلاه. هناك طريقتان للقيام بهذه المهمة:
- سيكون المفتاح هو اسم الملف وستكون القيمة هي ملف txt.
- سيكون المفتاح هو اسم الملف وستكون القيمة عنوان URL لملف txt.
الاستجابة
توفر الاستجابة بيانات وصفية عن نموذج اللغة المدرب حديثا إلى جانب بيانات وصفية على كل ملف من ملفات النموذج باتباع تنسيق إخراج JSON المثالي:
{
"id": "41464adf-e432-42b1-8e09-f52905d7e29d",
"name": "TestModel",
"language": "En-US",
"state": "Waiting",
"languageModelId": "531e5745-681d-4e1d-b124-12e5ab57a891",
"files": [
{
"id": "84fcf1ac-1952-48f3-b372-18f768eedf83",
"name": "RenamedFile",
"enable": true,
"creator": "John Doe",
"creationTime": "2018-04-27T20:10:10.5233333"
},
{
"id": "9ac35b4b-1381-49c4-9fe4-8234bfdd0f50",
"name": "hellofile",
"enable": true,
"creator": "John Doe",
"creationTime": "2018-04-27T20:10:10.68"
}
]
}
id استخدم الملفات التي تم إرجاعها في الاستجابة لتنزيل محتويات الملف.
تحديث ملف من نموذج لغة
يسمح لك تحديث ملف بتحديث اسم الملف وحالته enable في نموذج لغة مخصص في الحساب المحدد.
الاستجابة
توفر الاستجابة بيانات تعريف على الملف الذي قمت بتحديثه باتباع تنسيق إخراج JSON المثال أدناه.
{
"id": "84fcf1ac-1952-48f3-b372-18f768eedf83",
"name": "RenamedFile",
"enable": false,
"creator": "John Doe",
"creationTime": "2018-04-27T20:10:10.5233333"
}
استخدم الملف الذي id تم إرجاعه في الاستجابة لتنزيل محتويات الملف.
الحصول على نموذج لغة معين
تقوم واجهة برمجة تطبيقات Get بإرجاع معلومات حول نموذج اللغة المحدد في الحساب المحدد مثل اللغة والملفات الموجودة في نموذج اللغة.
الاستجابة
توفر الاستجابة بيانات وصفية حول نموذج اللغة المحدد إلى جانب بيانات التعريف على كل ملف من ملفات النموذج باتباع تنسيق إخراج JSON المثالي:
{
"id": "dfae5745-6f1d-4edd-b224-42e1ab57a891",
"name": "TestModel",
"language": "En-US",
"state": "None",
"languageModelId": "00000000-0000-0000-0000-000000000000",
"files": [
{
"id": "25be7c0e-b6a6-4f48-b981-497e920a0bc9",
"name": "hellofile",
"enable": true,
"creator": "John Doe",
"creationTime": "2018-04-28T11:55:34.6733333"
},
{
"id": "33025f5b-2354-485e-a50c-4e6b76345ca7",
"name": "worldfile",
"enable": true,
"creator": "John Doe",
"creationTime": "2018-04-28T11:55:34.86"
}
]
}
استخدم الملف الذي id تم إرجاعه في الاستجابة لتنزيل محتويات الملف.
احصل على جميع نماذج اللغات
تعرض واجهة برمجة تطبيقات Get all جميع نماذج اللغات المخصصة في الحساب المحدد في قائمة.
الاستجابة
توفر الاستجابة قائمة بجميع نماذج اللغات في حسابك وكل من بيانات التعريف والملفات الخاصة بها باتباع تنسيق إخراج JSON المثالي:
[
{
"id": "dfae5745-6f1d-4edd-b224-42e1ab57a891",
"name": "TestModel",
"language": "En-US",
"state": "None",
"languageModelId": "00000000-0000-0000-0000-000000000000",
"files": [
{
"id": "25be7c0e-b6a6-4f48-b981-497e920a0bc9",
"name": "hellofile",
"enable": true,
"creator": "John Doe",
"creationTime": "2018-04-28T11:55:34.6733333"
},
{
"id": "33025f5b-2354-485e-a50c-4e6b76345ca7",
"name": "worldfile",
"enable": true,
"creator": "John Doe",
"creationTime": "2018-04-28T11:55:34.86"
}
]
},
{
"id": "dfae5745-6f1d-4edd-b224-42e1ab57a892",
"name": "AnotherTestModel",
"language": "En-US",
"state": "None",
"languageModelId": "00000000-0000-0000-0000-000000000001",
"files": []
}
]
حذف ملف من نموذج لغة
تقوم واجهة برمجة تطبيقات الحذف بحذف الملف المحدد من طراز اللغة المحدد في الحساب المحدد.
الاستجابة
لا يوجد محتوى تم إرجاعه عند حذف الملف من نموذج اللغة بنجاح.
الحصول على بيانات التعريف على ملف من نموذج لغة
تقوم واجهة برمجة تطبيقات الحصول على البيانات الوصفية لملف بإرجاع محتويات الملف المحدد وبياناته الوصفية من نموذج اللغة المختار في حسابك.
الاستجابة
توفر الاستجابة محتويات الملف وبياناته الوصفية بتنسيق JSON، على غرار هذا المثال:
{
"content": "hello\r\nworld",
"id": "84fcf1ac-1952-48f3-b372-18f768eedf83",
"name": "Hello",
"enable": true,
"creator": "John Doe",
"creationTime": "2018-04-27T20:10:10.5233333"
}
ملاحظة
محتويات ملف المثال هذا هي الكلمات "مرحبا" و "العالم" في سطرين منفصلين.
تنزيل ملف من نموذج لغة
تقوم واجهة برمجة تطبيقات تنزيل ملف بتنزيل ملف نصي يحتوي على محتويات الملف المحدد من طراز اللغة المحدد في الحساب المحدد. يجب أن يتطابق هذا الملف النصي مع محتويات الملف النصي الذي تم تحميله في الأصل.
الاستجابة
ستكون الاستجابة هي تنزيل ملف نصي يحتوي على محتويات الملف بتنسيق JSON.