Zorveus Documentation

Inference keys (zrv_...) authenticate requests against the OpenAI-compatible gateway (https://api.zorveus.com/v1).

Inference Key InserterInteractive

Paste your Zorveus key to dynamically update all code snippets below.

1. Check Live Usage & Spend Cap

You can query the current spending cap, spent amount this period, remaining balance, and reset date directly using the inference key itself.

Public CORS Enabled

GET /inference-keys/usage allows public CORS requests, making it safe and easy to call directly from browser applications, IDE extensions, and client-side frontends.

curl -X GET "https://api.zorveus.com/inference-keys/usage" \
  -H "Authorization: Bearer zrv_your_inference_key"

Response Shape

Capped Connection

{
  "status": "active",
  "app_id": "app_mindspire_123",
  "app_connection_id": "appcon_01j...",
  "currency": "USD",
  "period": "monthly",
  "spend_cap": "50.000000000000",
  "spent_this_period": "12.500000000000",
  "remaining_balance": "37.500000000000",
  "reset_at": "2026-09-01T00:00:00Z"
}

Uncapped Connection

{
  "status": "active",
  "app_id": "app_mindspire_123",
  "app_connection_id": "appcon_01j...",
  "currency": "USD",
  "period": "monthly",
  "spend_cap": null,
  "spent_this_period": "12.500000000000",
  "remaining_balance": null,
  "reset_at": null
}

2. One-Time Plaintext Display

When you generate or rotate an inference key, the plaintext secret is displayed only once:

zrv_live_9a8f7c2b4d1e6f0a5c3e7d9b2a4f6c8e

Zorveus stores only irreversible SHA-256 hashes of keys. If a key is lost, you must rotate or generate a new key.

3. Key Rotation Without Downtime

Create New Key

Under your App Connection, click Create Secondary Key.

Deploy to Production

Update your backend environment variables (ZORVEUS_API_KEY) with the new secret and deploy.

Revoke Old Key

Once traffic shifts, click Revoke on the previous key. Revocation is instantaneous across all edge gateway instances.

Was this page helpful?

Edit this page on GitHub

Inference Keys