Ключи управления API (Management API Keys)

Регламент создания, распределения и ротации изолированных токенов доступа для серверных бэкендов, тестовых сред и микросервисов.

Безопасность продакшен-систем строится на строгой изоляции доступов. Вместо использования единого мастер-ключа сервиса Api Router позволяет выпускать неограниченное число независимых API-токенов с индивидуальными финансовыми лимитами и привязкой к конкретным средам окружения (production, staging, dev).

Жизненный цикл и ротация токенов

Каждый ключ имеет уникальный префикс и хэшируется в базе данных. Вы можете в любой момент изменить жесткий лимит расходов или отозвать ключ без перезапуска бэкенд-сервисов.

Ключевые технические возможности

  • Изоляция по средам: Раздельные ключи для разработчиков, тестовых стендов CI/CD и боевых серверов.
  • Жесткие квоты (Hard Limits): Автоматическая блокировка ключа при достижении установленной суммы расходов в рублях.
  • Мгновенный отзыв (Revocation): Отозванный токен блокируется на всех пограничных узлах задержки менее 50 мс.
  • Аудит активности: Отслеживание IP-адресов последнего обращения и объемов потребленного трафика.

Пример интеграции в коде

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


import OpenAI from "openai";

// Инициализация стандартного SDK с базовым URL Api Router
const client = new OpenAI({
  baseURL: "https://api-router.velar.plus/v1",
  apiKey: process.env.API_ROUTER_KEY, // Ваш ключ от сервиса
});

async function run() {
  const response = await client.chat.completions.create({
    model: "anthropic/claude-sonnet", // Семейство модели без жесткой привязки к устаревающим номерам
    messages: [
      { role: "system", content: "Вы профессиональный инженер-архитектор." },
      { role: "user", content: "Как настроить надежную маршрутизацию запросов?" }
    ],
    temperature: 0.2,
  });

  console.log("Ответ модели:", response.choices[0].message.content);
}

run();
  

Связанные разделы документации

Для глубокого погружения в тему изучите следующие материалы: