Authentication
All API requests require authentication. You can use either an API key or a JWT token.
API Key Authentication
Include your API key in the X-API-Key header for every request:
-H "X-API-Key: he-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"Security Note: Never share your API key or commit it to version control. Keep it secure and rotate it regularly.
JWT Token Authentication
For web applications, you can use JWT tokens instead of API keys:
-H "Authorization: Bearer <jwt_token>"When to Use Each Method
- API Keys: Best for server-to-server communication, scripts, and backend services
- JWT Tokens: Best for web applications where users authenticate through your platform
Getting Your API Key
- Visit https://he2.ai/
- Navigate to Settings → API Keys
- Click "Create New API Key"
- Copy the key immediately (you won't be able to see it again)
Important: If you lose your API key, you'll need to create a new one. The old key cannot be recovered.