P Pitchbar مستندات

عملیات

هزینه‌ها و مصرف API کلودفلر

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

راه‌اندازی — مجوزهای توکن

توکن API را در My Profile → API Tokens Create TokenGet started — Create Custom Token ایجاد کنید. تمام مجوزهای زیر را در محدوده حساب اضافه کنید، در غیر این صورت برخی قابلیت‌ها بی‌صدا از کار می‌افتند (هوش مصنوعی کار می‌کند، Vectorize خطای ۱۰۰۰۰ می‌دهد؛ یا خزش کار می‌کند، جستجوی هوشمند ناموفق می‌شود؛ و غیره).

مجوز سطح در صورت نبودن، چه چیزی خراب می‌شود
Account → Workers AI خواندن همه پاسخ‌های چت و همه جستجوهای هوشمند (پیام‌های بازدیدکنندگان، پردازش خودکار) — کل فرآیند RAG.
Account → Vectorize ویرایش در اولین اجرا، شاخص تکه‌ها را ایجاد می‌کند، بردارها را ذخیره/جستجو می‌کند. بدون آن: code 10000 Authentication error یا code 40040 Index not found در هر بازیابی.
Account → Browser Rendering ویرایش خزش با اجرای جاوااسکریپت برای سایت‌هایی که HTTP ساده یک پوسته خالی برمی‌گرداند (Shopify، Next.js، Vue، Angular SPA). بدون آن: به Browserless (در صورت پیکربندی) یا HTTP ساده بازمی‌گردد — بسیاری از سایت‌ها تکه‌ای تولید نمی‌کنند.
Account → Workers R2 Storage ویرایش اختیاری. فقط زمانی نیاز است که دارایی‌های برند یا فایل‌های PDF منبع آپلود شده را در R2 (در مقابل دیسک محلی / S3) ذخیره می‌کنید.
Account → Workers Scripts ویرایش دکمه "استقرار پردازشگر Cron" را در تنظیمات ← سیستم ← پردازشگر زمان‌بندی قدرت می‌دهد، که یک پردازشگر کوچک را برای تیک زدن صف شما هر ۶۰ ثانیه ارسال می‌کند. بدون آن: به cron cPanel یا یک پینگ uptime خارجی که به /api/v1/internal/queue-tick درخواست می‌زند نیاز دارید.

حوزه منابع — در پایین فرم ایجاد توکن، "Account Resources" و "Zone Resources" را مشاهده خواهید کرد. Account Resources → Include — All accounts را تنظیم کنید، یا به‌طور صریح همان حسابی را انتخاب کنید که شناسه آن را در تنظیمات ← سیستم ← سرویس‌های هوش مصنوعی ← Cloudflare ← شناسه حساب وارد می‌کنید. توکن‌های با حساب نامطابق، دلیل شماره یک خطای code 10000 Authentication error هستند — لیست مجوزها درست به نظر می‌رسد اما توکن نمی‌تواند حساب شما را ببیند.

تأیید در ۱۰ ثانیه — پس از دریافت توکن، از هر ترمینالی تست کنید:

curl -H "Authorization: Bearer YOUR_TOKEN" \
     https://api.cloudflare.com/client/v4/accounts/YOUR_ACCOUNT_ID/vectorize/v2/indexes

پاسخ ۲۰۰ با یک لیست JSON (خالی یا حاوی pitchbar-chunks) به این معنی است که توکن و حساب مطابقت دارند. پاسخ ۱۰۰۰۰ به این معنی است که مطابقت ندارند. پاسخ ۴۰۰۴۰ به این معنی است که مطابقت دارند اما شاخص هنوز وجود ندارد — این مشکلی نیست، Pitchbar آن را در اولین اجرای پردازش خودکار ایجاد می‌کند.

کلودفلر ارائه‌دهنده پیش‌فرض توصیه‌شده است زیرا تمام اجزای مورد نیاز Pitchbar (هوش مصنوعی، جستجوی هوشمند، ذخیره‌ساز جستجوی هوشمند، خزنده) را تحت یک حساب با سطوح رایگان سخاوتمندانه جمع می‌کند. اگر ترجیح می‌دهید از کلودفلر استفاده نکنید، کلیدها را در تنظیمات ← سیستم خالی بگذارید و Pitchbar به OpenAI یا OpenRouter بازمی‌گردد — مشاهده کنید متغیرهای محیطی.

Pitchbar از کلودفلر برای چه مواردی استفاده می‌کند

منبع کاربرد سطح رایگان (تا سال ۲۰۲۶)
Workers AI — چت هر پاسخ بازدیدکننده را با استفاده از @cf/meta/llama-3.3-70b-instruct-fp8-fast به‌طور پیش‌فرض تولید می‌کند. یک فراخوانی در هر نوبت بازدیدکننده. ۱۰,۰۰۰ نورون در روز (معادل چند هزار پاسخ کوتاه). پس از آن، حدود ۰.۰۱۱ دلار به ازای هر ۱,۰۰۰ توکن ورودی و ۰.۰۱۱ دلار به ازای هر ۱,۰۰۰ توکن خروجی.
Workers AI — جستجوی هوشمند هر تکه خزش‌شده و هر سوال بازدیدکننده را به یک بردار ۷۶۸ بعدی از طریق @cf/baai/bge-base-en-v1.5 تبدیل می‌کند. یک فراخوانی به ازای هر تکه در زمان پردازش خودکار، یک فراخوانی به ازای هر نوبت بازدیدکننده. در همان استخر نورون Workers AI محاسبه می‌شود. فراخوانی‌های جستجوی هوشمند ارزان هستند — معمولاً کمتر از ۱٪ هزینه چت.
Workers AI — رتبه‌بندی مجدد بهترین تکه‌های بازگردانده شده توسط Vectorize را با استفاده از @cf/baai/bge-reranker-base دوباره امتیازدهی می‌کند تا هوش مصنوعی مرتبط‌ترین زمینه را دریافت کند. یک فراخوانی در هر نوبت بازدیدکننده. همان استخر نورون Workers AI. در مقایسه با چت ناچیز است.
Vectorize پایگاه داده جستجوی هوشمند که داده‌های محتوای اسکن‌شده شما را ذخیره می‌کند و به پرسش‌های نزدیک‌ترین همسایه در هر نوبت بازدیدکننده پاسخ می‌دهد. ۳۰ میلیون بعد ذخیره‌شده + ۵۰ میلیون بعد جستجو‌شده در ماه رایگان. یک سایت معمولی (۵۰۰ صفحه، حدود ۵,۰۰۰ تکه) از حدود ۳.۸ میلیون بعد استفاده می‌کند — به‌خوبی در سطح رایگان قرار می‌گیرد.
بارگذاری کامل صفحات صفحات سنگین جاوااسکریپت (React / Vue / Shopify Hydrogen) را خزش می‌کند تا بتوانیم محتوایی را که دریافت ایستا نمی‌تواند ببیند، پردازش خودکار کنیم. در زمان پردازش خودکار استفاده می‌شود، هرگز در مسیر اصلی بازدیدکننده. برای سایت‌های ایستا به‌طور خودکار به HTTP ساده بازمی‌گردد. ۱۰ دقیقه در روز در پلن رایگان Workers؛ ۱۰ ساعت در روز در پلن پولی (۵ دلار در ماه). خزش کامل یک سایت ۵۰۰ صفحه‌ای معمولاً ۵ تا ۱۵ دقیقه طول می‌کشد.

اعداد سطح رایگان، مقادیر منتشر شده کلودفلر در زمان نگارش هستند — صفحه قیمت‌گذاری Workers AI، صفحه قیمت‌گذاری Vectorize و صفحه قیمت‌گذاری Browser Rendering منبع حقیقت هستند — کلودفلر آنها را دوره‌ای به‌روز می‌کند.

محدوده هزینه واقعی ماهانه

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

  • سایت سرگرمی (حداکثر ۵۰۰ بازدیدکننده در ماه، کمتر از ۱۰۰ صفحه پردازش‌شده) — تقریباً مطمئناً ۰ دلار در ماه. همه چیز در سطوح رایگان قرار می‌گیرد.
  • سایت کسب‌وکار کوچک (۵,۰۰۰ بازدیدکننده در ماه، ۵۰۰ صفحه پردازش‌شده، خزش مجدد هفتگی) — معمولاً ۰ تا ۵ دلار در ماه. پلن پولی Browser Rendering (۵ دلار در ماه ثابت) محتمل‌ترین آیتم صورتحساب است اگر سایت شما سنگین JS باشد.
  • سایت متوسط (۵۰,۰۰۰ بازدیدکننده در ماه، ۵,۰۰۰ صفحه پردازش‌شده، خزش مجدد روزانه) — معمولاً ۲۰ تا ۶۰ دلار در ماه، که بیشتر آن مربوط به توکن‌های چت Workers AI است.

صورتحساب را کجا ببینید

کلودفلر مستقیماً از طریق داشبورد خود صورتحساب می‌دهد:

  1. با همان حسابی که شناسه حساب آن را در Pitchbar وارد کرده‌اید، در dash.cloudflare.com وارد شوید.
  2. Manage Account → Billing را برای فاکتورها باز کنید، یا AI → Workers AI → Analytics / AI → Vectorize → Analytics را برای نمودارهای مصرف زنده براساس مدل باز کنید.
  3. برای هزینه روزانه Workers AI، داشبورد Workers AI یک نمودار "نورون‌های استفاده شده" نشان می‌دهد که مستقیماً به مصرف صورتحساب‌شده نگاشت می‌شود.

محدود کردن هزینه

دو اهرم ایمنی در Pitchbar تعبیه شده است:

  • کنترل‌های هوش مصنوعی در سطح پلن. صفحه پلن‌های مدیریت پلتفرم یک max_tokens به ازای هر پیام و یک سقف پیام ماهانه تنظیم می‌کند. رسیدن به سقف، به‌جای مصرف توکن‌های بیشتر، یک پیام ارتقا به بازدیدکننده نشان می‌دهد.
  • محدودیت هزینه در سمت کلودفلر. در dash.cloudflare.com → Billing → Notifications می‌توانید یک هشدار بودجه تنظیم کنید و کلودفلر زمانی که مصرف از آستانه عبور می‌کند، به شما ایمیل بزند.

تغییر سرویس‌دهنده

اگر ترجیح می‌دهید اصلاً از کلودفلر استفاده نکنید:

  • شناسه حساب و توکن API کلودفلر را در تنظیمات ← سیستم خالی بگذارید و OPENAI_API_KEY را تنظیم کنید — زنجیره سرویس‌دهنده Pitchbar (Cloudflare → OpenRouter → OpenAI) به‌طور خودکار به OpenAI بازمی‌گردد.
  • مدل‌های چت OpenAI معمولاً به ازای هر نوبت گران‌تر از Workers AI هستند اما کیفیت استاندارد صنعتی را روی gpt-4o-mini و مشابه آن ارائه می‌دهند.
  • ذخیره‌سازی جستجوی هوشمند در این حالت به یک نمونه Qdrant که خودتان میزبانی می‌کنید بازمی‌گردد — مشاهده کنید متغیرهای محیطی.

نتیجه نهایی. کلودفلر ارزان‌ترین و ساده‌ترین راه برای اجرای Pitchbar است. اکثر نصب‌ها در سطوح رایگان باقی می‌مانند؛ حتی نصب‌های پرترافیک به‌ندرت از ۵۰ دلار در ماه عبور می‌کنند. شما همیشه دید کامل دارید — صورتحساب در داشبورد کلودفلر شماست، نه در Pitchbar.

زبان خود را انتخاب کنید