스택이 이미 OpenAI 기반 AI SDK를 사용하고 있다면, Novita AI는 대부분 Base URL, API 키, 모델 ID만 변경하면 됩니다. 공식 OpenAI TypeScript SDK는 사용자 지정 엔드포인트를 지원하며, Novita 문서는 https://api.novita.ai/openai/v1/chat/completions에서 OpenAI 호환 chat completions를 제공하므로 첫 마이그레이션 단계는 간단합니다. 해당 SDK에 어떤 오픈 모델을 연결할지도 고르고 있다면 2026년 코딩 에이전트용 오픈 소스 LLM 리더보드부터 확인하세요.
따라서 기존 SDK 워크플로를 유지하면서 앱을 다시 작성하지 않고 다른 모델 백엔드를 테스트하려는 경우 Novita는 실용적인 선택입니다.
특히 다음 경우에 유용합니다:
- 이미
openai를 호출하는 Next.js 또는 Node 앱 - 빠른 OpenAI SDK 마이그레이션 경로가 필요한 내부 도구
- 이후 Novita Agent Sandbox와 함께 사용할 에이전트 백엔드
- TypeScript와 Python이 동일한 OpenAI 호환 API 형태를 공유하려는 팀
Novita AI와 OpenAI 호환 TypeScript SDK: 변경되는 것과 유지되는 것
| 항목 | OpenAI SDK 기본값 | Novita AI 설정 | 중요한 이유 |
|---|---|---|---|
| 클라이언트 라이브러리 | openai |
openai |
동일한 TypeScript 패키지를 유지합니다. |
| Base URL | OpenAI 엔드포인트 | https://api.novita.ai/openai |
SDK가 버전 경로를 추가합니다. |
| API 키 | OpenAI 키 | Novita API 키 | 호출 형태가 아닌 인증 방식이 변경됩니다. |
| 모델 이름 | OpenAI 모델 ID | Novita 모델 ID | 모델 ID는 제공자별로 다르게 취급하세요. |
| 첫 요청 | chat.completions.create() |
chat.completions.create() |
동일한 요청 패턴으로 시작하세요. |
Novita AI에서 OpenAI TypeScript SDK 설정 방법
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 경로가 문서화되어 있으므로, 이것이 가장 안전한 첫 테스트입니다.
Novita AI에서 Python OpenAI SDK 동일 패턴
동일한 패턴이 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)
OpenAI SDK와 함께 Novita Agent Sandbox를 사용해야 하는 경우
모델 호출에는 SDK를 사용하고, 코드 실행, 브라우저 작업 또는 파일 작업을 격리된 환경에서 수행해야 할 때는 Novita Agent Sandbox를 사용하세요. 이렇게 분리하면 추론과 실행이 분리되어 코딩 에이전트에 적합한 구조가 됩니다.
둘 이상의 SDK를 마이그레이션하는 경우 OpenAI Python SDK 가이드와 Novita LLM API 가이드도 참조하세요.
더 나은 개발자 환경을 위한 OpenAI SDK 마이그레이션 팁
- SDK Base URL로
https://api.novita.ai/openai를 사용하세요. 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를 확인하세요.
