Authentication
Gateway API requests authenticate with Accly API keys.
Create an API key
API keys are created in the Accly app:
- Open chat.accly.net .
- Open settings.
- Go to API Keys.
- Create a new key.
- Copy the key immediately.
The full key is shown only once. If you lose it, create a new key.
Plan requirement
API keys are available on paid plans: Starter, Pro, and Max.
Free does not support API keys. If a paid subscription is suspended or the account is restricted, the gateway rejects API requests from existing keys.
Authorization header
Send the key in the Authorization header:
Authorization: Bearer sk-your-accly-api-keyExample:
curl https://api.accly.net/v1/chat/completions \
-H "Authorization: Bearer sk-your-accly-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-opus-4-7",
"messages": [{"role": "user", "content": "Hello"}]
}'Key types
When creating a key, choose the key type based on the API format your client or tool expects. The key type controls which protocol family or endpoint channel the key can use through the gateway.
| Key type | Endpoint family | Best for | Notes |
|---|---|---|---|
openai | OpenAI-compatible endpoints | OpenAI-compatible clients, agents, and /v1/chat/completions | Best default for most API users |
anthropic | Anthropic-style Messages API | Anthropic-native requests and tool behavior | Use when your integration expects Anthropic’s API shape |
google | Google/Gemini-style Generate Content | Gemini-native request format | Use when your integration expects Google’s API shape |
universal | OpenAI-compatible multi-model routing | One OpenAI-style interface for many supported models | Does not guarantee provider-native features |
Universal lets you use many supported models through a common OpenAI-compatible interface, but provider-native endpoint behavior may require the matching provider key type.
Keep keys secret
Treat Accly API keys like passwords.
- Never expose API keys in browser code or mobile client bundles.
- Do not commit keys to Git.
- Store keys in server-side environment variables or a secrets manager.
- Use separate keys for separate apps or environments when possible.
- Revoke keys you no longer use.
Rotate a leaked key
If a key is exposed:
- Revoke the key in the Accly app settings.
- Create a new key.
- Update your server, tool, or automation configuration.
- Review recent usage for unexpected activity.
Revoked keys are rejected by the gateway.