مستندات / سیستم توکن

درک سیستم توکن

توکن‌ها واحد استفاده در anonym.legal هستند. آن‌ها را مثل سکه تصور کنید: هر عملیات Analyze، Anonymize یا Decrypt تعداد کمی از آن‌ها را مصرف می‌کند و می‌توانید هزینه دقیق را پیش از هر اجرا ببینید.

توکن چیست؟

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

توجه: در anonym.legal کلمه «توکن» دو معنای متفاوت دارد. این صفحه درباره توکن‌های صورت‌حساب است — اعتباراتی که برای عملیات خرج می‌کنید. در جاهای دیگر سایت درباره اطلاعات شناسایی شخصی توکن‌شده نیز صحبت می‌کنیم، که نگه‌دارنده فنی (مانند <PERSON_1>) است که جایگزین یک نام در متن شما می‌شود. این‌ها واحد صورت‌حساب نیستند و مستقیماً برای آن‌ها پرداخت نمی‌کنید.

در یک نگاه

  • Free
    200/چرخه
    کافی برای امتحان پلتفرم روی چند سند کوچک.
  • Basic — €3 / ماه
    1,000/چرخه
    مناسب برای ناشناس‌سازی گاه‌گاهی اسناد.
  • Pro — €15 / ماه
    4,000/چرخه
    پردازش منظم روی اسناد متعدد.
  • Business — €29 / ماه
    10,000/چرخه
    استفاده روزانه سنگین، کارهای دسته‌ای، و یکپارچگی‌های API.

تخصیص‌های توکن در پایان هر چرخه صورت‌حساب بازنشانی می‌شوند (30 روز برای Free، 31 روز برای طرح‌های پولی). توکن‌های استفاده‌نشده منتقل نمی‌شوند.

چه چیزی توکن مصرف می‌کند؟

Analyze

اسکن متن و گزارش اطلاعات شناسایی شخصی موجود در آن. رایج‌ترین عملیات.

Anonymize

شناسایی اطلاعات شناسایی شخصی و تبدیل آن (جایگزینی، حذف، ماسک، هش، یا رمزگذاری). کمی بیشتر از Analyze هزینه دارد.

Decrypt

بازیابی اصل‌ها از خروجی رمزگذاری‌شده. ارزان‌تر از Analyze.

AI Entity Creation

ایجاد یک شناساگر موجودیت سفارشی با هوش مصنوعی. هزینه ثابت 50 توکن به ازای هر درخواست.

اقدامات رایگان: بررسی موجودی توکن و دریافت تخمین هزینه صفر توکن می‌برد. می‌توانید قیمت را پیش از هر فراخوانی پولی پیش‌نمایش کنید.

هزینه‌های واقعی بر اساس اندازه سند

اندازه‌گیری‌شده روی متن انگلیسی با اطلاعات شناسایی شخصی متراکم (تعداد موجودیت‌ها همان چیزی است که تحلیل‌گر واقعاً یافته). این‌ها اعدادی هستند که در محیط تولید از حسابتان کسر می‌شود:

کاراکترهاموجودیت‌های یافت‌شدهتوکن‌های کسرشدهتقریباً
504441 توکن به ازای ~13 کاراکتر
20014091 توکن به ازای ~22 کاراکتر
500387211 توکن به ازای ~24 کاراکتر
1,000745391 توکن به ازای ~26 کاراکتر
5,0003,7761931 توکن به ازای ~26 کاراکتر
10,0007,5663851 توکن به ازای ~26 کاراکتر

قانون سرانگشتی: تقریباً 1 توکن به ازای 25 کاراکتر از متن انگلیسی با اطلاعات شناسایی شخصی متراکم، به علاوه سربار کوچکی به ازای هر موجودیت. متن کم‌تراکم‌تر حتی کمتر هزینه دارد چون جمله موجودیت کوچک‌تر می‌شود.

آیا نوع عملیات اهمیت دارد؟

تقریباً هیچ تفاوتی نیست. اینجا همان ورودی 160 کاراکتری به پنج روش مختلف ناشناس‌سازی شده:

عملیاتچه می‌کندتوکن‌ها
replaceتعویض اطلاعات شناسایی شخصی با نگه‌دارنده‌ای مثل <PERSON_1>7
redactسیاه‌پوشانی (حذف دائمی)7
hashهش یک‌طرفه SHA-256/5127
maskماسک جزئی مثل John ****7
encryptAES-256-GCM (قابل برگشت با کلید شما)7

عملیاتی را انتخاب کنید که با هدف حریم خصوصی شما تناسب دارد — هزینه اساساً یکسان است.

آیا زبان اهمیت دارد؟

هزینه بر اساس کاراکترها و موجودیت‌های شناسایی‌شده تعیین می‌شود، نه زبان. متن کوتاه در هر یک از 48 زبان پشتیبانی‌شده چند توکن می‌برد:

زبانکاراکترهاموجودیت‌هاتوکن‌ها
en14842
de14532
es14432
fr14542
it13632
pt14532
nl13732
pl13722
ru13232
ja8422
zh7022
ar12342
Decrypt ارزان‌ترین عملیات است.

بازیابی اصل‌ها از یک بار رمزگذاری‌شده 342 کاراکتری فقط 2 توکن هزینه داشت. اگر ابتدا ناشناس‌سازی و سپس رمزگشایی انجام دهید تا اطلاعات شناسایی شخصی را برای یک بیننده مجاز بازیابی کنید، مرحله رمزگشایی بخش کوچکی از کل هزینه است.

موجودی کم شده؟ شارژ اضافی

در طرح‌های پولی می‌توانید در میانه چرخه توکن اضافی بخرید. کاربران طرح Free شارژ اضافی ندارند — برای فعال‌سازی به Basic ارتقا دهید.

طرحتوکن به ازای €1نرخ مؤثر
Basic250€0.40 / 100 tokens
Pro300€0.33 / 100 tokens
Business350€0.29 / 100 tokens

توکن‌های شارژ اضافی در بازنشانی چرخه بعدی منقضی می‌شوند. آن‌ها هم منتقل نمی‌شوند.

هزینه را پیش از اجرا بررسی کنید

  • در اپلیکیشن وب، پیش‌نمایش هزینه کنار هر دکمه عملیات نمایش داده می‌شود.
  • در API، اندپوینت /api/mcp/balance یا ابزار MCP anonym_legal_estimate_cost را فراخوانی کنید — هر دو رایگان هستند.
  • موجودی فعلی و استفاده اخیر شما همیشه در Settings → Accountقابل مشاهده است.

سؤالات سریع

آیا توکن‌های استفاده‌نشده منتقل می‌شوند؟
خیر. تخصیص‌ها و شارژهای اضافی هر دو در پایان هر چرخه بازنشانی می‌شوند.
اگر در میانه کار موجودی تمام شود چه اتفاقی می‌افتد؟
فراخوانی بعدی یک خطای 402 با کمبود دقیق برمی‌گرداند. یک شارژ اضافی بخرید یا منتظر بازنشانی چرخه بمانید.
آیا عملیات‌های ناموفق توکن می‌برند؟
خیر. توکن‌ها فقط پس از موفقیت عملیات کسر می‌شوند.
آیا انتخاب نوع عملیات قیمت را تغییر می‌دهد؟
خیر — replace، redact، mask، hash و encrypt روی همان ورودی اساساً یکسان هزینه دارند (جدول بالا را ببینید).
چرا برخی عملیات‌ها از بقیه ارزان‌ترند؟
Analyze و Anonymize کار شناسایی انجام می‌دهند (مرحله گران‌قیمت). Decrypt فقط نگاشت ذخیره‌شده را پیمایش می‌کند، بنابراین بسیار ارزان‌تر است.