Agentowe płatności

Agenci AI stają się coraz bardziej autonomiczni w swoich działaniach: piszą kod, pobierają dane, przydzielają zasoby i nie tylko. Aby działać całkowicie niezależnie, potrzebują sposobu na dokonywanie „mikropłatności” za usługi w sposób programistyczny, w czasie rzeczywistym i przy minimalnych kosztach. Tradycyjne systemy płatności nie sprawdzają się w przypadku mikropłatności. Opłaty poniżej centa i finalność transakcji w czasie poniżej sekundy w sieci Solana sprawiają, że jest to technicznie i ekonomicznie możliwe.

Dlaczego to jest ważne?

Wyobraź sobie na przykład, że deweloper korzystający z LLM do budowy aplikacji potrzebuje danych z płatnego API. Aby pobrać ważne dane, deweloper musiałby przerwać swoją pracę, poszukać API, wybrać dostawcę, założyć konto, dodać metodę płatności, wygenerować klucz API, skopiować go do swojego środowiska, a następnie wrócić do pracy. Taka bariera przerywa stan skupienia. W przypadku workflow wspieranych przez AI to poważna przeszkoda.

Zamiast tego, dzięki agentowym płatnościom, agent może złożyć żądanie, zapłacić za nie i kontynuować pracę. Bez kont. Bez kluczy API. Bez ręcznej ingerencji.

Płać za API za pomocą pay.sh

pay.sh to warstwa płatności dla agentów HTTP i narzędzi wiersza poleceń. Zapoznaj się z dokumentacją pay.sh, aby zainstalować pay. Interfejs wiersza poleceń pay opakowuje narzędzia takie jak curl, codex i claude, dzięki czemu mogą wywoływać płatne API bez kont dostawców lub kluczy API. Gdy API zwraca wyzwanie MPP lub x402 z kodem 402 Payment Required, pay prosi lokalny portfel o zatwierdzenie podpisania.

Protokół x402

Płatności agentowe wymagają sposobu negocjowania warunków płatności między klientami a serwerami przez standardową infrastrukturę internetową bez zakłócania tradycyjnych interfejsów webowych. Przestrzeń mikropłatności jest wciąż w fazie początkowej i prawdopodobnie pojawią się nowe narzędzia i standardy w miarę rozwoju tej dziedziny. Jednak protokół x402 wyłonił się jako wczesny standard z silnym wsparciem ekosystemu. x402 wykorzystuje kod statusu HTTP 402 "Payment Required" — standard od czasu HTTP/1.1, który stał się praktyczny dopiero z rozliczeniami blockchain.

Jak to działa

Klient wysyła żądanie, otrzymuje odpowiedź 402 z warunkami płatności, a następnie ponawia próbę z podpisaną płatnością. Serwer deleguje weryfikację i rozliczenie do facylitatora — opcjonalnego pośrednika, który obsługuje przesyłanie transakcji onchain. Po potwierdzeniu rozliczenia przez facylitatora, serwer zwraca żądaną treść. To rozdzielenie pozwala dostawcom API akceptować płatności bez bezpośredniego zarządzania jakąkolwiek infrastrukturą onchain.

Diagram przepływu x402

Protokół jest bezstanowy (bez sesji ani kluczy API), działa ze standardową infrastrukturą HTTP i obsługuje dowolny token SPL akceptowany przez serwer. Oto fragment kodu pokazujący, jak skonfigurować serwer Express z wykorzystaniem middleware x402:

app.use(
  paymentMiddleware(
    {
      "GET /costly-data": {
        accepts: [
          {
            scheme: "exact",
            price: "$0.001",
            network: "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
            payTo: svmAddress
          }
        ],
        description: "Costly data",
        mimeType: "application/json"
      }
    },
    new x402ResourceServer(facilitatorClient).register(
      "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
      new ExactSvmScheme()
    )
  )
);

app.get("/costly-data", (req, res) => {
  res.send({
    report: {
      data: "costly data"
    }
  });
});

Aby dowiedzieć się więcej na temat x402, sprawdź nasze przewodniki:

Narzędzia x402