وبلاگ

عامل‌های هوش مصنوعی حالا می‌توانند برای Hermoso ثبت‌نام کنند و اعتبار خودشان را بخرند

یک عامل می‌تواند از طریق API یک حساب Hermoso روی پلان پولی بسازد، و با یک اعتبار پرداخت خودش بسته‌های اعتبار را از طریق HTTP 402 شارژ کند.

Hermoso همیشه با عامل‌های هوش مصنوعی کار کرده است. Claude، ChatGPT، Cursor و دوستانشان تبلیغ‌ها را پژوهش، ساخت و منتشر می‌کنند، و همین Hermoso را به یک عامل بازاریابی هوش مصنوعی تبدیل می‌کند، نه یک داشبورد دیگر. اما یک کار بود که عامل برای خودش نمی‌توانست انجام دهد: گرفتن حساب. هر حساب با یک فرد پشت صفحه ورود شروع می‌شد. از این هفته، عامل‌ها می‌توانند از طریق API شروع کنند و بعد از ورود، هزینه خودشان را بپردازند. ثبت‌نام عامل‌ها در 26 اوت و پرداخت‌های ماشینی در 28 اوت راه‌اندازی شد.

ثبت‌نام عامل‌ها

یک عامل با POST /v1/signup شروع می‌کند. این یک صفحه پرداخت برای پلان پولی می‌سازد. پرداخت در صفحه پرداخت خود Stripe انجام می‌شود، توسط یک فرد یا با روش پرداختی که عامل می‌تواند استفاده کند. وقتی پرداخت انجام شد، عامل با POST /v1/signup/{id}/claim حساب را تصاحب می‌کند و کلید API خودش را دریافت می‌کند. از آن به بعد کل پلتفرم در اختیار اوست: ابزارهای MCP، REST API و هر چیز دیگر.

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

پرداخت‌های ماشینی

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

  1. از POST /api/billing/machine-payment یک بسته درخواست می‌کند.
  2. Hermoso با HTTP 402 Payment Required و یک چالش پرداخت جواب می‌دهد.
  3. عامل پرداخت را تأیید می‌کند و درخواست را دوباره می‌فرستد، و بسته به حساب اضافه می‌شود.

این روی پرداخت‌های ماشینی Stripe اجرا می‌شود. برای کارت‌ها، عامل از طریق کیف پولی که برای عامل‌ها ساخته شده پرداخت می‌کند، در محدودیت‌هایی که یک فرد تعیین کرده، و هرگز شماره کارت را خودش نگه نمی‌دارد. بسته‌ها همان‌هایی هستند که افراد در اپ می‌خرند، با همان قیمت‌ها و همان اعتبارها. کیف پول‌ها می‌توانند نقطه پایانی را از سند OpenAPI ما پیدا کنند، و GET /api/billing/config بسته‌ها را فهرست می‌کند.

روش آشنا هم کار می‌کند

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

آنچه یک عامل در روز اول می‌تواند انجام دهد

وقتی عامل کلیدش را گرفت، همان Hermoso را دارد که یک فرد در اپ دارد:

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

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

کنترل‌ها در دست افراد می‌ماند

شارژهای یک‌کلیکی با کارت ذخیره‌شده انجام می‌شوند و به دسترسی مدیر صورتحساب نیاز دارند. اشتراک‌ها را یک فرد در Workspace، Billing مدیریت می‌کند. و یک پرداخت ماشینی فقط می‌تواند بسته‌های اعتباری را بخرد که Hermoso فهرست کرده، با قیمت‌های اعلام‌شده، پس عامل می‌تواند کار کند بدون اینکه بتواند آنچه را می‌پردازد تغییر دهد.

چرا آن را ساختیم

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

Try it

نقاط پایانی در مرجع API هستند، و وصل کردن یک عامل به Hermoso از صفحه MCP چند دقیقه طول می‌کشد.

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

آیا یک عامل هوش مصنوعی می‌تواند حساب Hermoso بسازد؟

بله. POST /v1/signup یک صفحه پرداخت برای پلان پولی می‌سازد. بعد از پرداخت در صفحه Stripe، عامل با POST /v1/signup/{id}/claim حساب را تصاحب می‌کند و کلید API خودش را می‌گیرد.

چرا ثبت‌نام عامل به پلان پولی نیاز دارد؟

این کار حساب‌های عامل را با یک پرداخت واقعی پشتیبانی می‌کند. پلان رایگان برای افرادی که در اپ ثبت‌نام می‌کنند باقی می‌ماند.

عامل بدون فرد چطور اعتبار می‌خرد؟

با اعتبار پرداخت خودش، عامل یک بسته را در POST /api/billing/machine-payment درخواست می‌کند، یک چالش HTTP 402 دریافت می‌کند، پرداخت را تأیید می‌کند و درخواست را دوباره می‌فرستد. بسته به حساب اضافه می‌شود.

آیا عامل‌ها قیمت‌های متفاوتی می‌پردازند؟

نه. عامل‌ها همان بسته‌های اعتباری را با همان قیمت‌های افراد در اپ می‌خرند.