Payments and marketplace

Field reference for the model marketplace, covering the catalogue 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.

Catalogue entry

Browse the marketplace on the Marketplace tab of a remote gateway’s edit page. The tab appears only when that gateway exposes a marketplace channel. Each model is shown as a catalogue card (image, heading, badges, body text).

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 (one button per category, plus All and Purchased).
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.

Purchasing a model

Selecting Purchase Key on a catalogue card (its price shown alongside in USDC) starts an on-chain payment. The Marketplace tab sits on the gateway’s edit page, which only Administrators can open by default (see RBAC). 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.
  • Save the key straight after payment. If you skip it, purchase again to get a new key.
  • Renew ahead of expiry for any model backing a production surface, since an expired key stops working until renewed.
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.