OpenAI TypeScript SDK com Novita AI: URL base, exemplos e Agent Sandbox

Se a sua stack já usa um SDK de IA construído em torno da OpenAI, a Novita AI é, na maior parte, uma mudança de URL base, chave de API e ID do modelo. O SDK TypeScript oficial da OpenAI suporta endpoints personalizados, e a documentação da Novita expõe chat completions compatíveis com a OpenAI em https://api.novita.ai/openai/v1/chat/completions, então o primeiro passo de migração é pequeno.

Isso torna a Novita uma opção prática quando você quer manter seu fluxo de trabalho atual com o SDK e testar um backend de modelo diferente sem reescrever seu aplicativo.

OpenAI TypeScript SDK com Novita AI: o que muda e o que permanece igual

Item	Padrão do SDK OpenAI	Configuração Novita AI	Por que é importante
Biblioteca do cliente	openai	openai	Mantenha o mesmo pacote TypeScript.
URL base	Endpoint da OpenAI	https://api.novita.ai/openai	O SDK adiciona o caminho versionado.
Chave de API	Chave da OpenAI	Chave da API Novita	A autenticação muda, mas a forma da chamada não.
Nome do modelo	ID de modelo da OpenAI	ID de modelo da Novita	Trate os IDs de modelo como específicos do provedor.
Primeira requisição	chat.completions.create()	chat.completions.create()	Comece com o mesmo padrão de requisição.

Como configurar o OpenAI TypeScript SDK com a Novita AI

Instale o SDK:

npm install openai

Em seguida, aponte-o para a 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);

Comece com chat completions. A documentação pública da Novita atualmente documenta o caminho de chat completions compatível com a OpenAI, então esse é o teste inicial mais seguro.

Equivalente em Python do SDK OpenAI na Novita AI

O mesmo padrão funciona em 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)

Quando usar o Novita Agent Sandbox com o SDK OpenAI

Use o SDK para chamadas de modelo e, em seguida, use o Novita Agent Sandbox quando o fluxo de trabalho precisar de execução de código, ações de navegador ou trabalho com arquivos de forma isolada. Essa separação mantém a inferência e a execução separadas, o que é o formato certo para agentes de codificação.

Dicas de migração do SDK OpenAI para uma melhor experiência de desenvolvimento

• Use https://api.novita.ai/openai como URL base do SDK. O SDK OpenAI acrescenta o caminho versionado para você, então não é necessário adicionar /v1 manualmente.
• Troque por um ID de modelo suportado pela Novita antes de testar. O código do SDK pode permanecer o mesmo, mas os IDs de modelo são específicos do provedor.
• Trate a compatibilidade com a OpenAI como um atalho de migração, não como uma garantia de que todos os recursos mais novos da plataforma se comportam da mesma forma. Verifique a documentação atual da Novita antes do lançamento.
• Se o seu fluxo de trabalho executa código gerado, operações de arquivo ou ações de navegador, mova a execução para o Agent Sandbox em vez da sua máquina local.

FAQ

O SDK TypeScript da OpenAI é suficiente por si só?

Sim para chamadas de modelo. Não para execução isolada. Se o aplicativo for agêntico, combine-o com o Agent Sandbox.

Posso manter o mesmo código em JavaScript e TypeScript?

Sim. O uso do SDK é o mesmo.

O que devo ler em seguida?

Leia o guia da API LLM da Novita e a referência de chat completions e confirme o ID exato do modelo na biblioteca de modelos antes do uso em produção.