Authentication

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")

import { Client } from "@auriko/sdk";

// Option 1: Pass via environment variable (recommended)
const client = new Client({
    apiKey: process.env.AURIKO_API_KEY,
    baseUrl: "https://api.auriko.ai/v1",
});

// Option 2: Auto-detect from AURIKO_API_KEY env var
const client = new Client({
    baseUrl: "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",
)

import OpenAI from "openai";

const client = new OpenAI({
    apiKey: process.env.AURIKO_API_KEY,
    baseURL: "https://api.auriko.ai/v1",
});

from auriko import Client

client = Client(base_url="https://api.auriko.ai/v1")

import { Client } from "@auriko/sdk";

const client = new Client({ baseUrl: "https://api.auriko.ai/v1" });

Error Responses

Status	Code	Description
401	`invalid_api_key`	API 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

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	—

​API Keys

​Use your API key

​SDK Authentication

​Environment Variables

​Error Responses

​Authentication summary

API Keys

Use your API key

SDK Authentication

Environment Variables

Error Responses

Authentication summary