All API requests require authentication using a Bearer token.
API Keys
API keys are prefixed with ak_ and can be created in your dashboard.
Keep your API key secret. Do not share it or commit it to version control.
Use your API key
Include your API key in the Authorization header:
curl https://api.auriko.ai/v1/chat/completions \
-H "Authorization: Bearer $AURIKO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "Hello"}]}'
SDK Authentication
import os
from auriko import Client
# Option 1: Pass via environment variable (recommended)
client = Client(
api_key=os.environ["AURIKO_API_KEY"],
base_url="https://api.auriko.ai/v1"
)
# Option 2: Auto-detect from AURIKO_API_KEY env var
client = Client(base_url="https://api.auriko.ai/v1")
Environment Variables
Set your API key as an environment variable for security:
export AURIKO_API_KEY=ak_your_api_key_here
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["AURIKO_API_KEY"],
base_url="https://api.auriko.ai/v1",
)
Error Responses
| Status | Code | Description |
|---|
| 401 | invalid_api_key | API key is invalid or missing |
{
"error": {
"message": "API key is invalid.",
"type": "authentication_error",
"param": null,
"code": "invalid_api_key",
"doc_url": "https://docs.auriko.ai/errors/invalid_api_key"
}
}
Authentication summary
| Category | Auth method | Token prefix |
|---|
API key endpoints (/v1/chat/completions, /v1/responses, /v1/messages, /v1/models, /v1/me) | API key | ak_ |
Workspace management (/v1/workspaces/{workspace_id}/*) | API key + scopes | ak_ |
Public catalog (/v1/registry/*, /v1/directory/*, /v1/byok/providers*) | None required | — |
