Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.auriko.ai/llms.txt

Use this file to discover all available pages before exploring further.

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
Then use the SDK without passing the key directly:
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AURIKO_API_KEY"],
    base_url="https://api.auriko.ai/v1",
)

Error Responses

StatusCodeDescription
401invalid_api_keyAPI key is invalid or missing
401 Response
{
  "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

CategoryAuth methodToken prefix
Inference (/v1/chat/completions, /v1/models, /v1/me)API keyak_
Discovery (/v1/registry/*, /v1/directory/*)None required