API تشخیص موجودیت های نامدار (NER) در متن با هوش مصنوعی

API تشخیص موجودیت های نامدار (Named Entity Recognition - NER) در متن که بر پایه هوش مصنوعی و درک عمیق از محتوای متن طراحی شده است، توسط تاک بات به عنوان یک راهکار نوآورانه معرفی می‌شود. این API قادر است موجودیت های نامدار مانند افراد، مکان‌ها، سازمان‌ها و غیره را در متون مختلف شناسایی و استخراج کند. این ابزار برای پردازش زبان طبیعی، تحلیل متن و ایجاد کاربردهای هوشمند بسیار مفید است.

نحوه استفاده

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

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

https://api.talkbot.ir/v1/text/NER/REQ

هدرها

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

Authorization: Bearer YOUR_API_KEY
    

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

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

• texts یا text: این پارامتر اجباری است و شامل متن یا آرایه‌ای از متون است که باید موجودیت های نامدار در آن‌ها تحلیل شود.
• lang: این پارامتر اختیاری است و زبان متن را مشخص می‌کند (پیش‌فرض: "auto" برای تشخیص خودکار).
• entity_types: این پارامتر اختیاری است و آرایه‌ای از انواع موجودیت های مورد نظر برای استخراج (مانند PERSON, LOCATION, ORGANIZATION).
• return_offsets: این پارامتر اختیاری است و boolean است (پیش‌فرض: true) که مشخص می‌کند آیا آفست‌های شروع و پایان موجودیت‌ها برگردانده شود یا خیر.

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

{
    "texts": ["متن نمونه برای استخراج موجودیت‌ها", "متن دوم"],
    "lang": "auto",
    "entity_types": ["PERSON", "LOCATION"],
    "return_offsets": true
}
    

خروجی

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

{
    "api_version": "1.2",
    "AI": "NER-TALKBOT",
    "processing_time_ms": 123.45,
    "results": [
        {
            "text": "متن نمونه برای استخراج موجودیت‌ها",
            "language": "fa",
            "entities": [
                {
                    "text": "ایران",
                    "type": "LOCATION",
                    "start": 10,
                    "end": 15
                },
                {
                    "text": "علی",
                    "type": "PERSON",
                    "start": 20,
                    "end": 23
                }
            ]
        }
    ],
    "error": null
}
    

در این خروجی:

• api_version: نسخه API.
• AI: نام مدل یا سرویس.
• processing_time_ms: زمان پردازش به میلی‌ثانیه.
• results: آرایه نتایج برای هر متن، شامل متن اصلی، زبان تشخیص‌داده‌شده، و موجودیت‌ها (با متن، نوع، و آفست‌ها اگر فعال باشد).
• error: در صورت خطا، پیام خطا؛ در غیر این صورت null.

هر موجودیت شامل متن استخراج‌شده، نوع آن، و اگر return_offsets=true باشد، شاخص شروع و پایان در متن اصلی است. محدودیت طول هر متن ۱۰۰۰ کاراکتر است.

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

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

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

نمونه کد PHP

$url = 'https://api.talkbot.ir/v1/text/NER/REQ';
$data = array(
    'texts' => array('علی در تهران زندگی می‌کند و برای شرکت گوگل کار می‌کند.'),
    'lang' => 'auto',
    'entity_types' => array('PERSON', 'LOCATION', 'ORGANIZATION'),
    'return_offsets' => true
);
$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);

echo $response = curl_exec($curl);

curl_close($curl);

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

import requests
import json

url = 'https://api.talkbot.ir/v1/text/NER/REQ'
headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
}
data = {
    'texts': ['علی در تهران زندگی می‌کند و برای شرکت گوگل کار می‌کند.'],
    'lang': 'auto',
    'entity_types': ['PERSON', 'LOCATION', 'ORGANIZATION'],
    'return_offsets': True
}

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

print(result)

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

مرتبط با این API:

API تشخیص محتوای غیراخلاقی و خشونت آمیز ^{اختصاصی} API تشخیص بی احترامی و ناسزا

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

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

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

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

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

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