あなたのスタックがすでにOpenAIを中心に構築されたAI SDKを使用している場合、Novita AIへの移行は主にベースURL、APIキー、モデルIDの変更で済みます。公式のOpenAI TypeScript SDKはカスタムエンドポイントをサポートしており、Novitaのドキュメントでは https://api.novita.ai/openai/v1/chat/completions でOpenAI互換のチャット補完が公開されているため、最初の移行ステップは小さなものになります。
そのため、既存のSDKワークフローを維持しつつ、アプリを書き換えずに別のモデルバックエンドをテストしたい場合、Novitaは実用的な選択肢となります。
OpenAI TypeScript SDK と Novita AI：何が変わり、何が変わらないか
| 項目 | OpenAI SDK デフォルト | Novita AI 設定 | 重要な理由 |
|---|---|---|---|
| クライアントライブラリ | openai |
openai |
同じTypeScriptパッケージを維持。 |
| ベース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: "簡潔なテクニカルアシスタントとして振る舞ってください。" },
{ role: "user", content: "TypeScriptでの最も短いNovita SDKのセットアップを教えてください。" },
],
});
console.log(response.choices[0]?.message?.content);
チャット補完から始めてください。Novitaの公開ドキュメントは現在、OpenAI互換のチャット補完パスを文書化しているため、それが最も安全な最初のテストです。
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": "Novitaのセットアップを1段落で説明してください。"}
],
)
print(response.choices[0].message.content)
OpenAI SDK と併用する Novita Agent Sandbox の使用タイミング
モデル呼び出しにはSDKを使用し、ワークフローがコード実行、ブラウザ操作、またはファイル処理を分離して必要とする場合は、Novita Agent Sandboxを使用してください。この分割により推論と実行が分離され、コーディングエージェントにとって適切な構成となります。
より良い開発者体験のための OpenAI SDK 移行のヒント
- SDKのベース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ガイドとチャット補完リファレンスを読み、本番環境で使用する前にモデルライブラリで正確なモデルIDを確認してください。
