Skip to main content

​
Public mode (no key required)

You can use the /v1/classify and /v1/tag endpoints without an API key. Requests without a key run in public mode with stricter limits:
  • 1 request/min, 10K tokens/min, 1 concurrent
For higher limits, sign up for a free API key.

​
API Keys

For higher rate limits and full access, authenticate with a Bearer token.

​
Getting your API key

  1. Sign in at classer.ai
  2. Go to API Keys
  3. Click “Create API Key”
  4. Copy and store the key securely
API keys are only shown once. If you lose your key, you’ll need to create a new one.

​
Using your API key

export CLASSER_API_KEY=your-api-key
The SDKs automatically read from this environment variable.

​
Direct configuration

from classer import ClasserClient

client = ClasserClient(api_key="your-api-key")
result = client.classify(
    text="Hello",
    labels=["greeting", "question"]
)

​
HTTP header

For direct API calls, include the key in the Authorization header: 
curl -X POST https://api.classer.ai/v1/classify \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello", "labels": ["greeting", "question"]}'

​
Security best practices

Use environment variables or a secrets manager. Add .env to your .gitignore.
Create separate API keys for each environment.
Delete old keys and create new ones regularly.

​
Error responses

StatusDescription
401 UnauthorizedMissing or invalid API key
403 ForbiddenAPI key doesn’t have permission
429 Too Many RequestsRate limit exceeded