API تشخیص بی احترامی و ناسزا در متن با هوش مصنوعی

API تشخیص بی احترامی و ناسزا در متن که بر پایه هوش مصنوعی و درک عمیق از محتوای متن اولیه طراحی شده است، توسط تاک بات به عنوان یک راهکار نوآورانه معرفی می‌شود. این API قادر است بی احترامی و ناسزا را در متون مختلف شناسایی و بررسی کند. این ابزار برای ارتقاء تجربه کاربری، مدیریت محتوا و ایجاد محیط مناسب تعامل بسیار مفید است.

نحوه استفاده

ارسال درخواست

برای استفاده از این API، باید یک درخواست POST به آدرس زیر ارسال کنید:

https://api.talkbot.ir/v1/analysis/profanity/REQ

هدرها

در هدرهای درخواست، باید یک توکن بیرر (Bearer token) به عنوان اعتبارنامه ارسال کنید:

Authorization: Bearer YOUR_API_KEY
    

پارامترهای درخواست

در بدنه درخواست، دو پارامتر اختیاری و اجباری وجود دارد:

• base-text: این پارامتر اختیاری است و شامل متن اولیه‌ای که بی احترامی و ناسزاهای متن پارامتر text باید بر اساس آن تحلیل شود.
• text: این پارامتر اجباری است و شامل متنی است که باید بی احترامی و ناسزاهای آن تحلیل شود.

نمونه بدنه درخواست:

{
    "base-text": "متن اولیه", // اختیاری
    "text": "متن دارای بی احترامی و ناسزا"
}
    

خروجی

در پاسخ به درخواست، یک جسون با ساختار زیر ارائه می‌شود:

{
    "result": {
        "code": 200,
        "message": "Success",
        "result": "[is_profane=true, profanity_score=0.8]",
        "token_used": 105
    }
}
    

در این خروجی:

• code: کد وضعیت پاسخ است که در صورت موفقیت آمیز بودن درخواست، مقدار 200 خواهد بود.
• message: پیام وضعیت پاسخ است که در صورت موفقیت آمیز بودن درخواست، مقدار Success خواهد بود.
• result: نتیجه تشخیص بی احترامی و ناسزا در متن است که به صورت [وجود بی احترامی/ناسزا, احتمال] ارائه می‌شود. در مثال بالا، بی احترامی/ناسزا با احتمال ۰.۸ تشخیص داده شده است.
• token_used: تعداد توکن‌های مصرف‌شده در این درخواست است.

در این نتیجه، احتمال به صورت عددی بین 0 تا 1 نمایش داده می‌شود. عدد 0 نشان‌دهنده عدم وجود بی احترامی/ناسزا است. هرچه مقدار به سمت 1 حرکت کند، نشان‌دهنده میزان بیشتر بی احترامی/ناسزا در متن می‌باشد.

نتایج قطعی به صورت true یا false در نتیجه اعلام میشوند.

امکانات و مزایا

API تشخیص بی احترامی و ناسزا هوش مصنوعی تاک بات دارای ویژگی‌های زیر است:

• تشخیص سریع و کارآمد بی احترامی و ناسزا در متن با استفاده از تکنولوژی پیشرفته.
• قابلیت استفاده بدون نیاز به متن اولیه یا با آن، به انتخاب کاربر.
• ارائه نتایج دقیق با میزان احتمالی وجود بی احترامی/ناسزا در متن.
• قابلیت اطمینان بالا در تشخیص بی احترامی و ناسزا در متن.
• قابلیت استفاده در طیف گسترده‌ای از برنامه‌ها و سناریوهای مختلف.
• پشتیبانی فنی و به‌روزرسانی‌های مستمر توسط تیم توسعه‌دهنده.

نمونه کد PHP

$url = 'https://api.talkbot.ir/v1/analysis/profanity/REQ';
$data = array(
    'base-text' => 'با استفاده از فناوری پیشرفته، این مودم به شما امکان اتصال به شبکه‌های نسل پنج را می‌دهد. این مودم به طور خودکار به شبکه متصل می‌شود و تجربه‌ای سریع و روان در دانلود و آپلود فایل‌ها را برای شما به ارمغان می‌آورد.',
    'text' => 'من این مودم رو خریداری کردم. اما آخرین مدل توسط شرکت فلانی عوضی ساخته شده است.'
);
$headers = array(
    'Authorization: Bearer YOUR_API_KEY',
    'Content-Type: application/json'
);

$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($curl);
$result = json_decode($response, true);

print_r($result);

curl_close($curl);

نمونه کد پایتون

import requests
import json

url = 'https://api.talkbot.ir/v1/analysis/profanity/REQ'
headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
}
data = {
    'base-text': 'هوش مصنوعی، فناوری نوینی است که توانمندی سیستم ها و ماشین ها را در تفکر و عمل شبیه به انسان ها گسترش می دهد.',
    'text': 'به نظر من این فناوری لعنتی هیچ کاری انجام نمی‌دهد. واقعا بد است!'
}

response = requests.post(url, headers=headers, data=json.dumps(data))
result = response.json()

print(result)

در این نمونه‌ها، به جای `'YOUR_API_KEY'` باید توکن اعتبارسنجی خود را قرار دهید.

هزینه هر بار فراخوانی:

نام مدل	هزینه (TPU)
profanity-detection-api	500TPU
نحوه محاسبه توکن

آزمایش رایگان:

برای آزمایش و تست رایگان این وب سرویس (API) ابتدا در سایت ثبتنام کنید، و سپس از طریق کنترل پنل کاربری، کلید اختصاصی خود را ایجاد کنید. پس از ایجاد کلید، آن را در نمونه کدهای بالا جایگزاری کرده و خروجی را مشاهده کنید. امکان استفاده از کلید آزمایشی فقط تا 15000 توکن میسر است.

سایر وب سرویس ها:

با خرید بسته یاقوتی و یا یکی از بسته های فرایاقوتی، شما علاوه بر وب سرویس یا API پیش رو، از وب سرویس های زیر نیز میتوانید استفاده کنید.