به محتوای اصلی

API هوش مصنوعی ایرانی با پرداخت تومانی؛ ایجنت در محصول شما

API هوش مصنوعی ایرانی با پرداخت تومانی: سه راه را مقایسه کنید و ببینید ایجنت چطور از جدول‌هایتان جواب می‌دهد، با تأیید کاربر ثبت می‌کند و در کدتان می‌نشیند.

عاطفه امیری۷ دقیقه مطالعهبه‌روزرسانی
در این مطلب

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

چرا API هوش مصنوعی خارجی برای برنامه‌نویس ایرانی سخت است؟

مشکل اول پرداخت است. سرویس‌های خارجی هوش مصنوعی کارت بانکی ایرانی نمی‌پذیرند و برای شارژ حساب کارت بین‌المللی می‌خواهند. مشکل دوم دسترسی است. در تست دسترسی سرویس‌ها از سرور داخل ایران دیدیم که API یکی از مدل‌های بزرگ با خطای ۴۰۳ رد می‌شود. چند API دیگر جواب دادند، ولی آن تست نمی‌سنجد که با کلید واقعی و حساب پرداخت‌شده هم باز می‌مانند یا نه.

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

سه نوع API هوش مصنوعی ایرانی؛ فرقشان چیست؟

معیارواسط مدل با پرداخت ریالیمدل بومیایجنت (API آماده برای یک کار)
چیزی که می‌خریددسترسی مستقیم به مدلدسترسی به مدل داخلیجواب نهایی یک کار مشخص
داده‌ی کسب‌وکار شماخودتان در پرامپت می‌گذاریدهماندانسته‌ها و جدول‌های وصل‌شده؛ PDF و لینک هم وارد می‌شود
ثبت و ویرایش در دیتابیسکد ابزار و تأییدش با شماستهماناز راه تابع خودتان، با تأیید کاربر
رسیدن به کاربررابطش را خودتان می‌سازیدهمانAPI، ویجت سایت، بازوی بله، کد فانکشن
خروجی ساختاریافتهسنجشش با شماستسنجشش با شماستسرور با شکل تعریف‌شده می‌سنجد
کنترل خرجمعمولاً با کد خودتانمعمولاً با کد خودتانسقف ماهانه در پنل
مناسب برایمحصولی که خود مدل هسته‌ی آن استوقتی مدل داخلی شرط کار استوقتی هوش مصنوعی باید کاری را در محصول شما تمام کند

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

با API خام مدل، چه کدی را خودتان می‌نویسید؟

دسترسی به مدل یعنی متن می‌فرستید و متن می‌گیرید. هر چیزی که آن متن را به یک محصول قابل‌اعتماد تبدیل کند با شماست:

  • پرامپت از دستورالعمل و دانسته‌ها، و واداشتن مدل به اینکه بیرون از آن‌ها «نمی‌دانم» بگوید
  • query امن روی دیتابیس، بی آنکه ستون محرمانه به جواب برسد
  • اجرای ابزار (tool calling) با سنجش آرگومان و صفحه‌ی تأیید پیش از ثبت
  • سنجش خروجی JSON، ویجت چت، ثبت پرسش‌ها و سقف خرج هر کلید

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

ایجنت فیکارو؛ API هوش مصنوعی که کسب‌وکار شما را می‌شناسد

ایجنت را از تب «هوش مصنوعی (AI)» پنل می‌سازید، بدون اینکه پروژه‌ای لازم باشد:

  • رفتار: یکی از هفت قالب آماده (از پاسخ‌گوی FAQ تا دسته‌بند تیکت و نوشتن توضیح محصول) یا دستورالعمل فارسی خودتان.
  • دانسته‌ها: متن تایپی، یا فهرست قیمت و قوانینتان از PDF، عکس یا لینک یک صفحه، که پیش از ذخیره بازبینی می‌کنید.
  • داده‌ی زنده: جدول‌های پروژه‌تان؛ ایجنت برای هر سؤال query فقط‌خواندنی می‌نویسد و ستون‌های مخفی، ایمیل و تلفن هرگز به آن نمی‌رسند.
  • کار واقعی: تا سه تابع از پروژه‌تان، مثل پیگیری سفارش یا تابعی که با «اجازه‌ی نوشتن» چیزی ثبت می‌کند.
  • مدل: یکی از مدل‌های Gemini و GPT که پلن ایجنت دارد؛ فهرستشان در صفحه‌ی قیمت‌ها است.

خروجی هم با شماست: متن آزاد، یک برچسب از فهرست بسته، یا JSON با فیلدهای مشخص که سرور پیش از تحویل می‌سنجد.

یک درخواست HTTP؛ صدا زدن ایجنت از سرور

curl -X POST "https://api.fikaro.ir/ai/v1/bots/{botId}/ask" \
  -H "Authorization: Bearer apck_bot_..." \
  -H "Content-Type: application/json" \
  -d '{"input": "ساعت کاری پشتیبانی چیه؟"}'

جواب همیشه یک شکل دارد: answered می‌گوید ایجنت جواب را داشت یا نه، answer متن جواب است، output خروجی شکل‌دار، sources ردیف‌هایی از جدول که پشت جواب‌اند، و handoff می‌گوید این گفت‌وگو بهتر است به یک آدم برسد. برای پرسش دنباله‌دار مثل «و جمعه‌ها؟»، چند پیام قبلی را در فیلد history همراه پرسش می‌فرستید. فهرست کامل فیلدها و کدهای خطا در راهنمای ایجنت‌ها آمده است.

کسب‌وکار شما در این مسیر فقط با یک سرویس ایرانی طرف است. حساب خارجی و کارت بین‌المللی لازم ندارد، و کاربرانتان بدون فیلترشکن به api.fikaro.ir می‌رسند.

ایجنتی که کار را تمام می‌کند، نه فقط جواب

فرق ایجنت با یک چت بات معمولی همین‌جاست. فرض کنید تابع «ثبت لید» را با یک کلیک در صفحه‌ی «توابع» ایجنت ساخته‌اید و «پیش از انجام از کاربر تأیید بگیر» روشن است. کاربر می‌نویسد «اسمم علیه، شماره‌م ۰۹۱۲۱۲۳۴۵۶۷، می‌خوام برای پنل سازمانی باهام تماس بگیرید». ایجنت هنوز چیزی ثبت نکرده و جواب این است:

{
  "answered": true,
  "answer": "برای انجام این کار تأیید شما لازم است: ثبت لید — نام: علی، شماره‌ی تماس: ۰۹۱۲۱۲۳۴۵۶۷، یادداشت: پنل سازمانی",
  "pendingAction": {
    "fn": "capture_lead",
    "summary": "ثبت لید — نام: علی، شماره‌ی تماس: ۰۹۱۲۱۲۳۴۵۶۷، یادداشت: پنل سازمانی",
    "token": "eyJ…",
    "expiresAt": "2026-10-21T10:05:00Z"
  }
}

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

curl -X POST "https://api.fikaro.ir/ai/v1/bots/{botId}/confirm" \
  -H "Authorization: Bearer apck_bot_..." \
  -H "Content-Type: application/json" \
  -d '{"token": "eyJ…"}'

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

هوش مصنوعی داخل بک‌اند خودتان؛ ctx.ai.ask

کلید ایجنت (apck_bot_…) یک راز خرج‌کننده است و جایش داخل اپ موبایل نیست. اگر بک‌اند اپتان روی فیکاروست، اپ یک فانکشن پروژه را با توکن کاربر واردشده صدا می‌زند و فانکشن، بی کلید ایجنت، از ایجنت می‌پرسد. فانکشن ask_support با سطح دسترسی «کلید API + کاربران واردشده»:

const AGENT = "<شناسه‌ی ایجنت>";
const question = String(ctx.input.question || "").trim();
if (!question) ctx.reject("سؤال را بنویسید");

let r;
try {
  r = ctx.ai.ask(AGENT, question, { history: ctx.input.history });
} catch (e) {
  ctx.log("ایجنت جواب نداد:", e.code);
  ctx.respond(503, { error: "الان امکان پاسخ نیست" });
}
ctx.respond({ answer: r.answer, handoff: r.handoff });

ctx.respond را عمداً بیرون از try گذاشته‌ایم: ctx.respond اجرا را با پرتاب کردن تمام می‌کند و catch آن را هم می‌گرفت.

اپ همان آدرس همیشگی فانکشن را صدا می‌زند:

curl -X POST "https://api.fikaro.ir/{slug}/v1/fn/ask_support" \
  -H "Authorization: Bearer eyJ..." \
  -H "Content-Type: application/json" \
  -d '{"question": "ارسال به شیراز چند روز طول می‌کشه؟"}'

حالا فقط کاربران واردشده‌ی اپ شما می‌پرسند و کلید ایجنت هیچ‌جا بیرون نیست. ctx.ai.ask همزمان است و جوابش دقیقاً همان بدنه‌ی API ایجنت است؛ با همین یک خط تیکت هنگام ثبت برچسب می‌خورد یا فیلدهای یک آگهی از متن آزاد بیرون کشیده و ذخیره می‌شود. هر اجرای فانکشن حداکثر ۲ بار می‌پرسد، و این کار در فانکشن‌ها ممکن است، نه در قانون‌ها. کدهای خطا در راهنمای فانکشن‌ها آمده است.

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

هزینه به تومان چطور حساب می‌شود؟

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

  • هزینه‌ی ساعتی ایجنت روشن، از ۵۰ تومان در ساعت برای پلن اسپرسو. ایجنت خاموش هیچ هزینه‌ای ندارد. جدول همه‌ی پلن‌ها با سقف‌ها و مدل‌هایشان در صفحه‌ی قیمت‌ها است.
  • هزینه‌ی هر جواب، بر پایه‌ی هزینه‌ی واقعی مدل برای همان پرسش، به تومان. ویجت، بله و ctx.ai.ask هیچ هزینه‌ی ماهانه‌ی جدایی ندارند؛ هر پرسش همان یک پرسش است.

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

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

از کجا شروع کنم؟

اگر اولین کارتان یک چت بات برای سایت یا اپ است، راهنمای ساخت چت بات هوش مصنوعی از ساختن ایجنت تا نصب ویجت و بله پیش می‌رود. اگر به‌جای جواب متنی برچسب یا JSON می‌خواهید که مستقیم در جدول ذخیره شود، دسته‌بندی خودکار پیام و تیکت با هوش مصنوعی همان را با خروجی شکل‌دار و ctx.ai.ask نشان می‌دهد. برای فروشگاه، هوش مصنوعی برای فروشگاه اینترنتی از جواب موجودی تا ثبت سفارش با تأیید مشتری را می‌گوید.

سوالات متداول

API هوش مصنوعی ایرانی رایگان هست؟
رایگانِ همیشگی کمیاب است، چون هر جواب مدل هزینه‌ی واقعی دارد. در فیکارو رایگان شروع می‌کنید: حساب تازه اعتبار هدیه‌ی ثبت‌نام برای هزینه‌ی ساعتی ایجنت و ۵۰۰۰ تومان اعتبار هدیه‌ی هوش مصنوعی برای جواب‌ها دارد.
فیکارو به مدل‌های هوش مصنوعی دسترسی مستقیم می‌دهد؟
نه. فیکارو ایجنت می‌فروشد، نه دسترسی خام به مدل. ایجنت را در پنل با دستورالعمل، دانسته‌ها، جدول‌ها، توابع و شکل خروجی تعریف می‌کنید و آدرس API آن کار را تا آخر انجام می‌دهد. مدل ایجنت را از میان مدل‌های Gemini و GPT که پلنش دارد انتخاب می‌کنید.
ایجنت می‌تواند در دیتابیس من چیزی ثبت کند؟
بله، فقط از راه تابعی از پروژه‌تان که خودتان با «اجازه‌ی نوشتن» به ایجنت وصل کرده‌اید، و اگر بخواهید پس از تأیید خود کاربر. ایجنت فقط پارامترهایی را پر می‌کند که اعلام کرده‌اید و کد تابع شما آن‌ها را اعتبارسنجی می‌کند. جدول‌های وصل‌شده را فقط می‌خواند.
برای خرید API هوش مصنوعی کارت ارزی لازم است؟
برای سرویس‌های خارجی بله، چون کارت بانکی ایرانی نمی‌پذیرند. ایجنت‌های فیکارو با کیف پول تومانی و درگاه زرین‌پال شارژ می‌شوند.
API هوش مصنوعی را می‌شود مستقیم از اپ موبایل صدا زد؟
می‌شود، ولی کلید ایجنت داخل اپ قابل استخراج است و هر کس آن را داشته باشد از کیف پول شما خرج می‌کند. راه بهتر این است که اپ یک فانکشن پروژه را با توکن کاربر صدا بزند و فانکشن با ctx.ai.ask از ایجنت بپرسد. روی سایت هم ویجت با کلید عمومی خودش کار می‌کند. در هر حال سقف ماهانه‌ی ایجنت را بگذارید.

مطالب مرتبط