English Arabic Français Deutsch 日本語 한국어 Português Русский Español

Novita AI と OpenAI 互換 TypeScript SDK: ベース URL、モデル ID、および例

著者 / / LLM / 3 分で読めます
Novita AI と OpenAI 互換 TypeScript SDK: ベース URL、モデル ID、および例
目次
  1. Novita AI と OpenAI TypeScript SDK: 変更される点と変わらない点
  2. Novita AI で OpenAI TypeScript SDK をセットアップする方法
  3. Novita AI での Python OpenAI SDK 相当のコード
  4. OpenAI SDK で Novita Agent Sandbox を使用するケース
  5. より良い開発者体験のための OpenAI SDK 移行のヒント
  6. FAQ

スタックがすでに OpenAI を中心に構築された AI SDK を使用している場合、Novita AI への移行は、ベース URL、API キー、モデル ID の変更がほとんどです。公式の OpenAI TypeScript SDK はカスタムエンドポイントをサポートしており、Novita のドキュメントでは OpenAI 互換のチャット補完が https://api.novita.ai/openai/v1/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 パッケージを維持します。
ベース URL OpenAI エンドポイント https://api.novita.ai/openai SDK がバージョン付きパスを追加します。
API キー OpenAI API キー 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);

まずはチャット補完から始めます。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": "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 移行のヒント

  • https://api.novita.ai/openai を SDK のベース URL として使用します。OpenAI SDK がバージョン付きパスを自動的に追加するため、手動で /v1 を追加する必要はありません。
  • テストする前に、Novita がサポートするモデル ID に置き換えます。SDK コードは同じままで問題ありませんが、モデル ID はプロバイダー固有です。
  • OpenAI 互換性は移行のショートカットとして扱います。新しいプラットフォーム機能がすべて同じように動作するという保証ではありません。展開前に現在の Novita ドキュメントを確認してください。
  • ワークフローが生成コード、ファイル操作、またはブラウザ操作を実行する場合は、ローカルマシンではなく Agent Sandbox に実行を移してください。

FAQ

OpenAI TypeScript SDK だけで十分ですか?

モデル呼び出しには十分です。分離された実行には不十分です。アプリがエージェント型の場合は、Agent Sandbox と組み合わせてください。

JavaScript と TypeScript で同じコードを維持できますか?

はい。SDK の使用方法は同じです。

次に何を読むべきですか?

Novita LLM API ガイド と チャット補完リファレンス を読み、本番環境で使用する前にモデルライブラリで正確なモデル ID を確認してください。

関連記事