AIエージェントがHermosoに登録し、自分でクレジットを購入できるようになりました
エージェントはAPI経由で有料プランのHermosoアカウントを作成できます。また、自身の支払い認証情報を使い、HTTP 402でクレジットパックを追加購入できます。
Hermosoは、これまでもAIエージェントから使われてきました。Claude、ChatGPT、Cursorなどが広告を調べ、作り、公開します。だからHermosoは、ただのダッシュボードではなくAIマーケティングエージェントなのです。ただ、エージェントに自分ではできないことが一つありました。アカウントを取得することです。これまでは、どのアカウントもサインイン画面で人が始める必要がありました。今週から、エージェントはAPI経由で始められ、利用を始めた後は自分で支払うこともできます。エージェント登録は8月26日、マシン決済は8月28日に公開されました。
エージェント登録
エージェントは POST /v1/signup から始めます。これで有料プランの購入画面が作られます。支払いは、Stripe独自の購入画面で、人が行うか、エージェントが使える支払い方法で行われます。支払いが完了したら、エージェントは POST /v1/signup/{id}/claim でアカウントを受け取り、自分専用のAPIキーを得ます。ここから、MCPツール、REST API、その他すべての機能が使えるようになります。
エージェントの登録が有料プランを経由するのは意図的です。実際の支払いに裏付けられたエージェント用アカウントを保つためであり、無料プランは人のために残しています。アプリからの登録は、これまでと全く同じように行えます。
マシン決済
これまでクレジットが少なくなると、エージェントは人に購入リンクを送る必要がありました。今は、自分の支払い認証情報を持つエージェントが、クレジットパックを直接購入できます:
POST /api/billing/machine-paymentでパックを指定します。- Hermosoは支払い確認の要求とともに、HTTP 402 Payment Required を返します。
- エージェントが支払いを承認して再試行すると、パックがアカウントに追加されます。
これはStripeのマシン決済で動作します。カードの場合、エージェントはエージェント向けに作られたウォレットを通じて支払います。使える金額は、人が設定した上限内に限られ、カード番号そのものを保持することはありません。パックは、人がアプリで購入するものと同じで、同じ価格、同じクレジットです。ウォレットはOpenAPIドキュメントからエンドポイントを自動で見つけられます。また、GET /api/billing/config でパックの一覧を取得できます。
従来の方法も引き続き使えます
多くのエージェントはまだ自分の支払い認証情報を持っていないため、通常の方法も変わらず使えます。buy_credits はパックを一覧表示し、保存済みのカードがあれば1ステップで支払い、なければ人が開くための購入リンクを返します。set_auto_reload で自動チャージを有効にすると、残高が少なくなったときに自動で補充されます。
エージェントが初日からできること
エージェントがキーを取得すると、アプリで人が使えるのと同じHermosoが使えるようになります:
- ウェブサイト、説明文、またはSNSのハンドルからブランドを設定します。
- 市場ですでに成果を上げている広告と、人々が見ているクリエイターを調べます。
- 完成した画像・動画広告を企画し、レンダリングします。
- 利用者が接続したチャネルに公開・予約投稿し、投稿の結果を確認します。
SNSアカウントや広告アカウントの接続は、今もそのプラットフォーム独自のサインイン画面で行うため、この部分だけは人が一度クリックして進める必要があります。
管理は人の手に残ります
ワンクリックのチャージは保存済みのカードを使い、請求の管理者権限が必要です。サブスクリプションは、Workspaceの Billing で人が管理します。マシン決済で購入できるのは、Hermosoが掲載しているクレジットパックだけで、掲載価格のとおりに課金されます。そのためエージェントは、支払う金額を変えることなく作業を続けられます。
開発した理由
今後、多くのマーケティング業務は、24時間働くエージェントが担うようになります。夜のうちにリサーチを済ませ、朝には新しい広告ができ、投稿は予定どおり公開されます。そうしたエージェントは、誰かがボタンを押すのを待たずに始め、作業を続け、自ら支払えるべきです。今ではそれが可能です。
Try it
エンドポイントはAPIリファレンスにあります。エージェントをHermosoに接続するのは、MCPページから数分で済みます。
よくある質問
AIエージェントはHermosoアカウントを作成できますか？
はい。POST /v1/signup で有料プランの購入画面を作成します。Stripeの購入画面で支払いを済ませたあと、エージェントは POST /v1/signup/{id}/claim でアカウントを受け取り、自分専用のAPIキーを得ます。
エージェントの登録に有料プランが必要なのはなぜですか？
実際の支払いに裏付けられたエージェント用アカウントを保つためです。無料プランは、アプリから登録する人のために残しています。
人を介さずに、エージェントはどのようにクレジットを購入しますか？
エージェントは自身の支払い認証情報を使い、POST /api/billing/machine-payment でパックを指定します。HTTP 402の確認要求を受け取り、支払いを承認して再試行します。パックはアカウントに追加されます。
エージェントは別の価格を払うのですか？
いいえ。エージェントは、アプリで人が買うのと同じクレジットパックを、同じ価格で購入します。