API Keys

Generate Ephemeral API Key

Generate a new ephemeral API key for playground use.

No authentication required. Returns a temporary key that:

  • Expires after 24 hours
  • Limited to 100 API calls
  • Tracked individually (not shared between users)
  • Auto-deletes when expired

Use Cases:

  • Playground users exploring the API
  • Quick testing without signup
  • Trial integrations

Upgrade Path: When limits are reached, users can:

  1. Generate a new ephemeral key (instant, no signup)
  2. Sign up for unlimited access at https://www.bellatorsi.com/pricing

Security:

  • Keys are cryptographically secure (128-bit entropy)
  • Usage tracked per key for abuse prevention
  • Automatic expiry prevents key leakage issues
post/api/v1/keys/ephemeral/generate

Request

  • Base URL: https://api.bellatorsi.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.bellatorsi.com/api/v1/keys/ephemeral/generate
  • Auth: none declared

Response

Ephemeral key generated successfully

api_keystring required

The generated ephemeral API key

expires_atstring required

ISO 8601 expiry timestamp

usage_limitinteger required

Maximum number of API calls allowed

usage_remaininginteger required

Remaining API calls

typestring required

Key type (ephemeral)

tierstring

Issued tier. demo or free.

notestring required

Usage instructions and upgrade information

Changes

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