API تحلیل احساسات متن با هوش مصنوعی

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

نحوه استفاده

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

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

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

هدرها

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

Authorization: Bearer YOUR_API_KEY
    

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

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

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

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

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

خروجی

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

{
    "result": {
        "code": 200,
        "message": "Success",
        "result": "[positive, 0.8]",
        "token_used": 105
    }
}
    

در این خروجی:

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

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

نتایج قطعی به صورت negative, neutral, positive در نتیجه اعلام میشوند.

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

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

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

نمونه کد PHP

$url = 'https://api.talkbot.ir/v1/analysis/sentiment/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/sentiment/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)
sentiment-analysis-api	700TPU
نحوه محاسبه توکن

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

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

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

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