TypeScript и Node.js (openai)

Руководство по интеграции официального пакета openai в серверные и серверлесс-приложения на Node.js, Next.js App Router, Express и NestJS с полноценной поддержкой строгой типизации.

TypeScript / Node.js Base URL: https://api-router.velar.plus/v1

Пакет openai для Node.js и TypeScript включает строгие интерфейсы типов для всех параметров и структур ответов. Он идеально интегрируется в серверные роуты Next.js App Router, микросервисы NestJS и обработчики Express, поддерживая асинхронные генераторы для потокового чтения данных через цикл for await.

1. Установка пакета

npm install openai

2. Пример кода и отправка запроса

Ниже приведен готовый к запуску пример кода с правильной структурой авторизации и параметров:


import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://api-router.velar.plus/v1',
  apiKey: process.env.API_ROUTER_KEY
});

async function main() {
  const stream = await client.chat.completions.create({
    model: 'anthropic/claude-sonnet',
    messages: [{ role: 'user', content: 'Объясните паттерн Dependency Injection в TypeScript.' }],
    stream: true
  });

  for await (const chunk of stream) {
    process.stdout.write(chunk.choices[0]?.delta?.content || '');
  }
}

main();
  

3. Преимущества единого шлюза

  • Оплата в рублях: Расходы списываются с единого баланса, пополняемого через карты РФ, СБП или безналичный расчет.
  • Без иностранных прокси: Все запросы маршрутизируются напрямую на серверы без необходимости использования зарубежной инфраструктуры.
  • Отказоустойчивость: При перегрузке одного поставщика запрос автоматически подхватывается резервным узлом (выбор провайдера).

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

Рекомендуем также изучить смежные технические руководства и спецификации: