Keys & Billing

Create a free-tier API key with an email (no auth required)

Instant free-tier signup: send an email address and an app name, get a working insr_live_ key in the response. Free tier = 10 free verifications plus 100 requests a day. The key string is returned exactly once, in this response; it is never emailed (a management link is emailed instead). One free key per email; keys are also rate-limited per client address. For paid tiers use POST /v1/keys/checkout (card) or POST /v1/keys/purchase (crypto); for wallet-native keys with no email use POST /v1/keys/buy. Every key minted here (and on every other creation path) signs under the v2 scheme: attest responses carry kid: insumer-attest-v2, trust responses insumer-trust-v2, and /v1/attest thresholds must be decimal strings (a JSON number is rejected with 400). Pre-cutover v1 keys keep their original behavior. Response envelope note: standalone endpoint — returns a flat {success, key, ...} object, NOT the {ok, data, meta} envelope.

post/v1/keys/create

Request

  • Base URL: https://api.insumermodel.com
  • URL: https://api.insumermodel.com/v1/keys/create
  • Auth: none required

Request body

emailstring email required

Owner email. One free key per email.

appNamestring required

Name for this key (your app or agent name).

tier'free' required

Must be 'free'. Paid tiers use /v1/keys/checkout or /v1/keys/purchase.

Response

Key created (shown once — save it now)

successboolean
keystring
namestring
tierstring
dailyLimitinteger
apiKeyCreditsinteger

Example response

{
  "success": true,
  "key": "insr_live_...",
  "tier": "free",
  "dailyLimit": 100,
  "apiKeyCredits": 10
}

Changes

No recorded changes to this operation across all 1 revision of this API.