Authentication
How to authenticate with the VicSee API
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