TRI1 TRI1 APIapi.tri1space.com

Billing

Billing

How TRI1 Credits meter API and agent usage

TRI1 Credits

API and agent usage is metered in TRI1 Credits: prepaid units redeemable only for TRI1-provided services. Credits are not money: they never transfer between accounts and cannot be cashed out.

How it works

  1. Sign in to the developer dashboard. Your developer account holds the credit balance. Accounts created by TRI1 identity sign-in (challenge and verify) receive a 500-credit starter grant the first time they register; accounts created through the fallback email registration are not linked to a TRI1 identity and cannot hold credits until they sign in with one.
  2. Buy credits from the Billing & Credits page of the dashboard via Stripe Checkout, or call POST /v1/developer/me/credits/checkout with a packageId and an idempotencyKey. To buy an exact amount, send packageId: "custom" plus a whole-number credits value (100 to 100,000); the server prices it at the base rate of 1 credit = $0.01 CAD.
  3. API calls made with your keys consume credits automatically.

Service costs

ServiceCost
1 creditAPI requestAny metered /v1 or /api/tri request
5 creditsAgent messagePOST /v1/agents/:agentId/rooms/:roomId/messages

Metering modes

The platform runs in one of three modes: off (no metering), observe (usage is charged when a funded credit account exists, requests are never blocked), and enforce (requests without sufficient credits receive 402 insufficient_credits; a restricted account receives 402 credit_account_restricted). In observe mode, responses that would have been blocked carry an X-TRI1-Credits-Metering diagnostic header instead.

Retries and idempotency

Send an Idempotency-Key header (or X-Idempotency-Key) on metered requests you may retry: a retry that is byte-identical (same method, URL, and body, with the same key) dedupes to the original charge instead of billing again. A request that differs in any of those is billed as a new request even with the same key.

Charges for requests that fail server-side (a 5xx response) are reversed automatically; client errors (4xx) are billed like successful calls.

Checking your balance

curl -H "Authorization: Bearer $TRI_DEVELOPER_SESSION" \
  https://api.tri1space.com/v1/developer/me/credits

Metered API responses include X-TRI1-Credits-Spent and X-TRI1-Credits-Remaining headers. Promotional credits are spent before purchased credits.

Refunds and disputes

Card refunds remove the purchased credits; if credits were already spent, the account is restricted pending review. See the terms and pricing.