Authentication

Запросы к AllTokens API авторизуются с помощью Bearer-токена (API-ключ).

Заголовок

Authorization: Bearer <API_KEY>

Либо (если клиент поддерживает только один заголовок для ключа):

X-API-Key: <API_KEY>

Используйте один из способов. Рекомендуется Authorization: Bearer.

Получение API-ключа

Личный кабинет — создайте ключ в разделе API/Keys.
Через API — зарегистрируйтесь (POST /api/auth/register), затем создайте ключ для пользователя: POST /api/platform/users/{userId}/apikeys с телом {"label": "my-key"}. В ответе придёт поле key (показывается один раз).

Без валидного ключа запросы к /api/v1/* возвращают 401 Unauthorized.

Пример (curl)

bash

curl -X POST "https://api.alltokens.ru/api/v1/chat/completions" \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"router","messages":[{"role":"user","content":"Hi"}]}'

Использование с OpenAI SDK

Укажите base URL AllTokens и ваш API-ключ:

python

from openai import OpenAI
client = OpenAI(
  base_url="https://api.alltokens.ru/api/v1",
  api_key="YOUR_API_KEY",
)
response = client.chat.completions.create(
  model="router",
  messages=[{"role": "user", "content": "Hello"}],
)

typescript

import OpenAI from 'openai';
const client = new OpenAI({
  baseURL: 'https://api.alltokens.ru/api/v1',
  apiKey: 'YOUR_API_KEY',
});
const completion = await client.chat.completions.create({
  model: 'router',
  messages: [{ role: 'user', content: 'Hello' }],
});