Authentication

Secure authentication for VicSee API using Bearer tokens. Get your API key from the dashboard, manage multiple keys, and implement proper authorization headers for all requests.

The VicSee API uses API keys to authenticate requests. You can manage your API keys from your dashboard.

Getting Your API Key

Sign in to your VicSee account
Go to Dashboard → API Keys
Click Create API Key
Copy and securely store your key

Your API key grants access to your account. Keep it secret and never share it publicly or commit it to version control.

Using Your API Key

Include your API key in the Authorization header as a Bearer token:

curl https://vicsee.com/api/v1/models \
  -H "Authorization: Bearer sk-your-api-key"

API Key Format

VicSee API keys start with sk- followed by a unique identifier:

sk-abc123def456...

Error Responses

Code	Error	Description
401	`MISSING_AUTH_HEADER`	No Authorization header provided
401	`INVALID_KEY_FORMAT`	Key doesn't start with `sk-`
401	`INVALID_API_KEY`	Key not found or inactive

Example Error Response

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Invalid or inactive API key"
  }
}

Security Best Practices

Environment variables - Store keys in environment variables, not code
Rotate regularly - Create new keys periodically and revoke old ones
Limit scope - Use separate keys for different applications
Monitor usage - Check your dashboard for unusual activity