Начало работы

Авторизация

Как аутентифицировать запросы к 42GPU API.

Формат API ключа

API ключи 42GPU имеют следующий формат:

sk-air-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Префикс sk-air- обозначает ключ 42GPU
Ключ состоит из 32 символов после префикса
Ключи можно создавать и отзывать в личном кабинете

Заголовки авторизации

42GPU поддерживает два способа передачи API ключа:

Authorization: Bearer (рекомендуется)

Стандартный способ OAuth 2.0, совместимый с OpenAI SDK:

Terminal

curl https://api.42gpu.ru/v1/chat/completions \
  -H "Authorization: Bearer sk-air-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4-turbo", "messages": [{"role": "user", "content": "Hello"}]}'

X-API-Key

Альтернативный способ через кастомный заголовок:

Terminal

curl https://api.42gpu.ru/v1/chat/completions \
  -H "X-API-Key: sk-air-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4-turbo", "messages": [{"role": "user", "content": "Hello"}]}'

Примеры для SDK

Python

auth.py

1from openai import OpenAI
2
3# Способ 1: Через параметр api_key
4client = OpenAI(
5    base_url="https://api.42gpu.ru/v1",
6    api_key="sk-air-your-api-key"
7)
8
9# Способ 2: Через переменную окружения
10# export OPENAI_API_KEY="sk-air-your-api-key"
11# export OPENAI_BASE_URL="https://api.42gpu.ru/v1"
12client = OpenAI()  # Автоматически подхватит из env

JavaScript / TypeScript

auth.js

1import OpenAI from 'openai';
2
3const client = new OpenAI({
4  baseURL: 'https://api.42gpu.ru/v1',
5  apiKey: 'sk-air-your-api-key',
6});
7
8// Или через переменные окружения
9// OPENAI_API_KEY=sk-air-your-api-key
10// OPENAI_BASE_URL=https://api.42gpu.ru/v1

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

Рекомендуем хранить ключ в переменных окружения:

.env

# .env
GPU42_API_KEY=sk-air-your-api-key
GPU42_BASE_URL=https://api.42gpu.ru/v1

Безопасность

Важно

Никогда не храните API ключи в коде или публичных репозиториях. Используйте переменные окружения или секретные хранилища.

Ротация ключей

Регулярно меняйте API ключи, особенно если подозреваете утечку. Вы можете создать несколько ключей для разных сервисов.

Ограничение доступа

Используйте отдельные ключи для development и production. Отзывайте неиспользуемые ключи.

Мониторинг

Следите за использованием API в личном кабинете. Настройте алерты при аномальной активности.

Ошибки авторизации

Код	Описание	Решение
`401`	Неверный API ключ	Проверьте правильность ключа
`403`	Доступ запрещён	Ключ отозван или заблокирован
`402`	Недостаточно средств	Пополните баланс