Skip to content
Ruvicode logo
Ruvicode
USD

Authentication

How to authenticate Ruvicode API requests with Bearer API keys. Create keys, set rate limits and spend limits, restrict models, rotate or revoke access anytime.

Every API request must include your Ruvicode API key in the Authorization header.

API key format

Ruvicode API keys start with rvcd_ followed by 32 random hex characters:

rvcd_a1b2c3d4e5f6...

Making authenticated requests

curl https://api.ruvicode.com/v1/chat/completions \
  -H "Authorization: Bearer rvcd_..." \
  -H "Content-Type: application/json" \
  -d '{...}'

Key management

  • Create keys in Dashboard → API Keys
  • Name keys for identification (e.g., "production-app", "dev-testing")
  • Set spend limits per key (daily or monthly)
  • Set rate limits per key (requests per minute, default 100, max 700; all keys share one 700 RPM account budget)
  • Restrict models per key so a key used by one integration can only call the models it needs (chat and image models alike)
  • Reveal a key again from the key list with the eye icon
  • Revoke keys to permanently disable them, they stop working immediately

Security

  • Keys are hashed (SHA-256) before storage, the stored hash cannot be reversed into the key
  • The eye icon reveals your key again, it is stored encrypted at rest and only decryptable on the server
  • Never commit keys to version control
  • Use environment variables to manage keys in your application

Errors

If authentication fails, you'll receive a 401 response:

{
  "error": {
    "message": "Invalid API key",
    "type": "authentication_error"
  }
}

A revoked key returns the same 401. A 403 means the key itself is fine but it is not allowed to do what you asked, most commonly the model is outside the key's allowed model list. A 404 on the model means the model id does not exist at all. See Error Handling for the full table.

Public endpoints

GET /v1/models is public and needs no API key. Coding tools (OpenCode, OpenClaw, and other OpenAI-compatible clients) discover custom providers by fetching the model list without credentials, so it stays open. Everything else, including all chat completions and image requests, requires your rvcd_ key.