Payments and marketplace

Field reference for the model marketplace, covering the catalog card, purchasing a model, and the resulting API key.

The model marketplace lets you purchase model access from connected gateways, paid for on-chain via x402 and provisioned automatically as a usable API key. For the conceptual model, see Trust-fabric integration.

Catalog entry

The dashboard has two places to browse the marketplace: a top-level Marketplace page, and a per-gateway Marketplace tab on a remote gateway’s edit page (shown only when that gateway is a remote gateway exposing a marketplace channel). Both render the same catalog card (image, heading, badges, body text), not a labeled settings form.

FieldDescription
NameCard heading.
ProviderShown as small text under the name, and as the card image’s alt text.
LogoCard image.
RatingA star icon, the numeric rating, and the review count in parentheses, e.g. ★ 4.8 (312).
Context WindowShown as text, e.g. “Context: 128K”.
CategoryShown as a badge on the card, and used for the browser’s filter buttons (a plain button per category, plus two synthetic buttons, All and Purchased, alongside the real category names).
DescriptionShown as body text on the card.
PricingShown as text on the card. Distinct from the on-chain purchase price shown next to the purchase button (see below).
CapabilitiesShown as a row of badges on the card (square-cornered, not rounded pills).
Gateway NameShown as a badge on the card, only when browsing an aggregated, multi-gateway catalog.

Purchasing a model

Selecting Purchase Key on a catalog card (its price shown alongside in USDC) starts an on-chain payment. Once it settles, click Save API Key to Gateway in the confirmation dialog to provision the API key and save it to your Secrets store; Skip for now closes the dialog without creating a secret, even though the payment already went through. That turns a model listed by a connected gateway into something a surface on your own appliance can actually call, with no separate provider account to create and no key to copy in by hand.

  • Purchase when a surface needs a model that isn’t already covered by an existing provider key. Check your Secrets store first so you don’t pay for access you already have.
  • If you skip saving the key right after payment, you’ll need to purchase again to get another chance to save it — the payment itself isn’t refunded or reused.
  • Renew ahead of expiry for any model backing a production surface, since an expired key stops working until renewed; don’t let it lapse on something in active use.
StatusMeaning
Purchase KeyNot yet purchased.
Purchased, with “Expires {date}” shown alongsidePurchased and currently valid.
Renew Key (Expired)A previous key has expired; purchasing again provisions a new one.