Аутентификация

​

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

1. Откройте speshu.ai/profile и войдите в аккаунт.
2. Откройте раздел API-ключей и создайте ключ с понятным вам названием.
3. Сразу сохраните полное значение ключа — например, в менеджере секретов или переменной окружения.

​

Формат ключа

sk-019b1f2c-3d4e-7a10-9c88-2f6b0a5d1e44

​

Сколько ключей можно держать

​

Отзыв ключа

​

Истёкший ключ

​

Передача ключа

​

Примеры

# Authorization: Bearer — то, что использует OpenAI SDK
curl https://speshu.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $SPESHU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Привет!"}]
  }'

# X-Api-Key — то, что использует Anthropic SDK
curl https://speshu.ai/api/v1/messages \
  -H "X-Api-Key: $SPESHU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Привет!"}]
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://speshu.ai/api/v1",
    api_key="sk-ваш-ключ",
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Привет!"}],
)

import anthropic

client = anthropic.Anthropic(
    base_url="https://speshu.ai/api/v1",
    api_key="sk-ваш-ключ",
)

response = client.messages.create(
    model="gpt-4o",
    max_tokens=256,
    messages=[{"role": "user", "content": "Привет!"}],
)

​

Что даёт ключ

• областей видимости — один ключ видит ровно то же, что видит аккаунт;
• списков разрешённых моделей — доступны все модели, доступные аккаунту;
• собственных лимитов запросов.

​

Эндпоинты без ключа

​

Проверка ключа

curl https://speshu.ai/api/v1/balance \
  -H "Authorization: Bearer $SPESHU_API_KEY"

{ "RUB": "1250.00", "USD": "3.75" }

​

Ошибки аутентификации

​

Безопасность ключа

• Храните ключ в переменной окружения или в менеджере секретов, а не в коде.
• Никогда не отправляйте ключ из клиентского кода браузера, мобильного приложения или десктопного клиента. Всё, что попало в клиент, попадёт к пользователю.
• Никогда не коммитьте ключ в репозиторий. Добавьте его в .gitignore заранее, до первой отправки.
• Ротируйте ключ так: создайте новый, переведите на него интеграцию, проверьте и только потом отзовите старый.
• Настройте IP-allow-list, если у вашей инфраструктуры есть стабильные адреса выхода. Это ограничивает круг источников, из которых ключ вообще работает.

​

Что дальше