Перейти к основному содержанию

​
Методы аутентификации

​
Bearer Token

Наиболее распространенный метод аутентификации - использование Bearer токена в заголовке Authorization: 
Authorization: Bearer YOUR_API_KEY

​
Заголовок API-ключа (формат Anthropic)

Для Anthropic-совместимых эндпоинтов вы также можете использовать заголовок x-api-key: 
x-api-key: YOUR_API_KEY

​
Получение вашего API-ключа

1

Метод через панель управления

Рекомендуемый метод получения API-ключа - через панель управления MegaLLM:
  1. Посетите megallm.io/dashboard
  2. Перейдите в раздел API Keys
  3. Нажмите “Create New API Key”
  4. Скопируйте ключ (начинается с sk-mega-) и сохраните его безопасно
2

CLI-инструмент

Если у вас установлен MegaLLM CLI:
npx megallm@latest
Следуйте интерактивным подсказкам для настройки вашего API-ключа.

​
Лучшие практики безопасности

Никогда не раскрывайте ваши токены: Всегда храните токены в переменных окружения или защищенных хранилищах, никогда в коде.

​
Переменные окружения

  • Linux/Mac
  • Windows
  • Docker
# Добавьте в ~/.bashrc или ~/.zshrc
export MEGALLM_API_KEY="your_api_key_here"

# Или используйте .env файл
echo "MEGALLM_API_KEY=your_api_key_here" >> .env

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

​
OpenAI SDK

from openai import OpenAI

client = OpenAI(
    base_url="https://ai.megallm.io/v1",
    api_key=os.getenv("MEGALLM_API_KEY")
)

response = client.chat.completions.create(
    model="gpt-4",
    messages=[{"role": "user", "content": "Hello!"}]
)

​
Anthropic SDK

from anthropic import Anthropic

client = Anthropic(
    base_url="https://ai.megallm.io",
    api_key=os.getenv("MEGALLM_API_KEY")
)

message = client.messages.create(
    model="claude-3.5-sonnet",
    max_tokens=100,
    messages=[{"role": "user", "content": "Hello!"}]
)

​
Интеграция LangChain

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    base_url="https://ai.megallm.io/v1",
    api_key=os.getenv("MEGALLM_API_KEY"),
    model="gpt-4"
)

response = llm.invoke("Hello!")

​
Устранение неполадок

​
Распространенные ошибки аутентификации

Код ошибкиСообщениеРешение
401UnauthorizedПроверьте, действителен ли ваш API-ключ и не истек ли срок его действия
403ForbiddenУбедитесь, что API-ключ имеет необходимый доступ
429Rate LimitedПодождите и повторите попытку или свяжитесь со службой поддержки

​
Отладка аутентификации

Включите режим отладки для просмотра подробной информации об аутентификации: 
curl https://ai.megallm.io/v1/chat/completions \
  -H "Authorization: Bearer $MEGALLM_API_KEY" \
  -H "X-Debug-Auth: true" \
  -d '{"model": "gpt-4", "messages": [...]}'
Нужна помощь? Проверьте наш FAQ или свяжитесь со службой поддержки, если у вас возникли проблемы с аутентификацией.