OpenAI-совместимый TypeScript SDK с Novita AI: базовый URL, ID моделей и примеры

Если ваш стек уже использует AI SDK, построенный вокруг OpenAI, Novita AI — это в основном смена базового URL, API-ключа и ID модели. Официальный OpenAI TypeScript SDK поддерживает пользовательские эндпоинты, а Novita предоставляет OpenAI-совместимые chat completions по адресу https://api.novita.ai/openai/v1/chat/completions, так что первый шаг миграции небольшой. Если вы также выбираете, какую открытую модель подключить к этому SDK, начните с рейтинга открытых LLM для агентов-кодеров в 2026.

Это делает Novita практичным вариантом, когда вы хотите сохранить существующий рабочий процесс SDK и протестировать другой бэкенд модели, не переписывая приложение.

Это особенно полезно для:

• приложений Next.js или Node, которые уже вызывают openai
• внутренних инструментов, которым нужен быстрый путь миграции на OpenAI SDK
• бэкендов агентов, которые позже будут работать в паре с Novita Agent Sandbox
• команд, которые хотят, чтобы TypeScript и Python использовали одну и ту же OpenAI-совместимую структуру API

OpenAI TypeScript SDK с Novita AI: что меняется и что остаётся прежним

Элемент	По умолчанию в OpenAI SDK	Настройка Novita AI	Почему это важно
Клиентская библиотека	openai	openai	Остаётся тот же TypeScript-пакет.
Базовый URL	Эндпоинт OpenAI	https://api.novita.ai/openai	SDK добавляет путь с версией.
API-ключ	Ключ OpenAI	API-ключ Novita	Меняется аутентификация, а не форма вызова.
Имя модели	ID модели OpenAI	ID модели Novita	Считайте ID моделей зависящими от провайдера.
Первый запрос	chat.completions.create()	chat.completions.create()	Начните с того же паттерна запроса.

Как настроить OpenAI TypeScript SDK с Novita AI

Установите SDK:

npm install openai

Затем направьте клиент на Novita:

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.NOVITA_API_KEY,
  baseURL: "https://api.novita.ai/openai",
});

const response = await client.chat.completions.create({
  model: "openai/gpt-oss-120b",
  messages: [
    { role: "system", content: "You are a concise technical assistant." },
    { role: "user", content: "Show me the shortest Novita SDK setup in TypeScript." },
  ],
});

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

Начните с chat completions. В публичной документации Novita на данный момент описан путь OpenAI-совместимых chat completions, так что это самый безопасный первый тест.

Аналог OpenAI SDK на Python в Novita AI

Тот же паттерн работает в Python:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["NOVITA_API_KEY"],
    base_url="https://api.novita.ai/openai",
)

response = client.chat.completions.create(
    model="openai/gpt-oss-120b",
    messages=[
        {"role": "user", "content": "Explain the Novita setup in one paragraph."}
    ],
)

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

Когда использовать Novita Agent Sandbox с OpenAI SDK

Используйте SDK для вызовов моделей, а затем применяйте Novita Agent Sandbox, когда рабочему процессу требуется изолированное выполнение кода, действия в браузере или работа с файлами. Такое разделение держит инференс и выполнение отдельно — именно такая структура нужна агентам-кодерам.

Если вы мигрируете более одного SDK, также посмотрите руководство по OpenAI Python SDK и руководство по Novita LLM API.

Советы по миграции на OpenAI SDK для лучшего опыта разработчиков

• Используйте https://api.novita.ai/openai как базовый URL SDK. OpenAI SDK сам добавляет путь с версией, так что вам не нужно добавлять /v1 вручную.
• Подставьте поддерживаемый Novita ID модели перед тестированием. Код SDK может остаться тем же, но ID моделей зависят от провайдера.
• Относитесь к OpenAI-совместимости как к способу ускорить миграцию, а не как к гарантии, что все новые функции платформы работают одинаково. Проверяйте актуальную документацию Novita перед запуском.
• Если ваш рабочий процесс выполняет сгенерированный код, файловые операции или действия в браузере, перенесите выполнение в Agent Sandbox вместо локальной машины.

FAQ

Достаточно ли OpenAI TypeScript SDK самого по себе?

Да, для вызовов моделей. Нет, для изолированного выполнения. Если приложение построено на агентах, используйте его вместе с Agent Sandbox.

Можно ли использовать один и тот же код в JavaScript и TypeScript?

Да. Использование SDK одинаково.

Что почитать дальше?

Прочитайте руководство по Novita LLM API и справочник по chat completions, затем подтвердите точный ID модели в библиотеке моделей перед использованием в продакшене.