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

Как получить и использовать API ключ для работы с Aijora API

Для работы с Aijora API вам нужен API ключ. Это уникальный идентификатор, который подтверждает ваше право использовать сервис и позволяет отслеживать использование.

Быстрый старт

Зарегистрируйтесь на платформе

Перейдите на api.aijora.ru/register и создайте аккаунт. Регистрация занимает меньше минуты.

Пополните баланс

Перейдите в раздел Управление балансом и пополните баланс на любую сумму. Оплата происходит по факту использования — вы платите только за реальные запросы к моделям.

Создайте API ключ

Откройте раздел API ключи в консоли управления и нажмите "Создать ключ". Сохраните ключ в безопасном месте — он больше не отобразится.

Важно: API ключ даёт полный доступ к вашему балансу. Никогда не публикуйте его в открытом коде и не передавайте третьим лицам.

Формат аутентификации

Все запросы к API должны содержать ваш API ключ в заголовке Authorization:

Authorization: Bearer ВАШ_API_КЛЮЧ

Формат называется Bearer Token Authentication и является стандартом для HTTP API.

Примеры использования

curl https://api.aijora.com/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {
        "role": "user",
        "content": "Привет!"
      }
    ]
  }'

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

export AIJORA_API_KEY="ваш-api-ключ"

curl https://api.aijora.com/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AIJORA_API_KEY" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "Привет!"}]
  }'

С fetch (Node.js / Browser)

const apiKey = process.env.AIJORA_API_KEY; // Храните ключ в переменных окружения

const response = await fetch('https://api.aijora.com/api/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${apiKey}`
  },
  body: JSON.stringify({
    model: 'gpt-4o-mini',
    messages: [
      { role: 'user', content: 'Привет!' }
    ]
  })
});

const data = await response.json();
console.log(data);

С OpenAI SDK

import OpenAI from 'openai';

const openai = new OpenAI({
  apiKey: process.env.AIJORA_API_KEY,
  baseURL: 'https://api.aijora.com/api/v1'
});

const completion = await openai.chat.completions.create({
  model: 'gpt-4o-mini',
  messages: [
    { role: 'user', content: 'Привет!' }
  ]
});

console.log(completion.choices[0].message.content);

С requests

import os
import requests

api_key = os.getenv('AIJORA_API_KEY')  # Храните ключ в переменных окружения

response = requests.post(
    'https://api.aijora.com/api/v1/chat/completions',
    headers={
        'Content-Type': 'application/json',
        'Authorization': f'Bearer {api_key}'
    },
    json={
        'model': 'gpt-4o-mini',
        'messages': [
            {'role': 'user', 'content': 'Привет!'}
        ]
    }
)

data = response.json()
print(data)

С OpenAI SDK

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.getenv('AIJORA_API_KEY'),
    base_url='https://api.aijora.com/api/v1'
)

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

print(completion.choices[0].message.content)

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

Используйте переменные окружения

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

# В файле .env
AIJORA_API_KEY=ваш-api-ключ

// В коде
const apiKey = process.env.AIJORA_API_KEY;

Не коммитьте ключи в git

Добавьте .env в .gitignore:

# .gitignore
.env
.env.local

Используйте разные ключи для разных окружений

Создайте отдельные ключи для:

Разработки (development)
Тестирования (staging)
Продакшена (production)

Это позволит легко отозвать ключ в случае утечки без остановки работы других окружений.

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

Для безопасности рекомендуется периодически менять API ключи (каждые 3-6 месяцев):

Создайте новый ключ в консоли
Обновите переменные окружения в ваших приложениях
Протестируйте работу с новым ключом
Удалите старый ключ

Совет: При ротации не удаляйте старый ключ сразу. Дайте время на обновление всех сервисов, которые его используют (1-2 дня).

Лучшие практики

Делайте	Не делайте
Храните ключи в переменных окружения	Не публикуйте ключи в публичных репозиториях
Используйте разные ключи для разных проектов	Не отправляйте ключи по email или мессенджерам
Устанавливайте лимиты расходов на ключ	Не используйте один ключ для всех проектов
Регулярно проверяйте статистику использования	Не игнорируйте уведомления о подозрительной активности
Немедленно удаляйте скомпрометированные ключи	Не храните ключи в коде напрямую

Содержание