이미 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 워크플로를 유지하면서 앱을 다시 작성하지 않고 다른 모델 백엔드를 테스트하려는 경우 Novita가 실용적인 선택이 됩니다.
OpenAI TypeScript SDK 및 Novita AI: 변경되는 점과 유지되는 점
| 항목 | 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() |
동일한 요청 패턴으로 시작하세요. |
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 경로를 문서화하고 있으므로 가장 안전한 첫 테스트입니다.
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를 사용하세요. 이렇게 분리하면 추론과 실행이 분리되어 코딩 에이전트에 적합한 구조가 됩니다.
더 나은 개발자 경험을 위한 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를 확인하세요.
