SDK TypeScript Compatível com OpenAI com Novita AI: URL Base, IDs de Modelo e Exemplos

Se sua stack já utiliza um SDK de IA construído em torno da OpenAI, a Novita AI é basicamente uma mudança de URL base, chave de API e ID de modelo. O SDK oficial da OpenAI para TypeScript suporta endpoints personalizados, e a documentação da Novita expõe conclusões de chat compatíveis com OpenAI em https://api.novita.ai/openai/v1/chat/completions, então o primeiro passo da migração é pequeno. Se você também está escolhendo qual modelo aberto conectar a esse SDK, comece pelo Open Source LLM Leaderboard for Coding Agents in 2026.

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

É especialmente útil para:

• Aplicações Next.js ou Node que já chamam openai
• ferramentas internas que precisam de um caminho de migração rápido para o SDK da OpenAI
• backends de agentes que posteriormente serão combinados com o Novita Agent Sandbox
• equipes que desejam que TypeScript e Python compartilhem a mesma estrutura de API compatível com OpenAI

SDK TypeScript da OpenAI 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 cliente	openai	openai	Mantenha o mesmo pacote TypeScript.
URL base	Endpoint OpenAI	https://api.novita.ai/openai	O SDK adiciona o caminho versionado.
Chave de API	Chave OpenAI	Chave de API Novita	A autenticação muda, não a forma da chamada.
Nome do modelo	ID do modelo OpenAI	ID do modelo 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 SDK TypeScript da OpenAI com Novita AI

Instale o SDK:

npm install openai

Em seguida, aponte 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: "Você é um assistente técnico conciso." },
    { role: "user", content: "Mostre-me a configuração mais curta do SDK Novita em TypeScript." },
  ],
});

console.log(response.choices[0]?.message?.content);

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

Equivalente do SDK Python da 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": "Explique a configuração da Novita em um parágrafo."}
    ],
)

print(response.choices[0].message.content)

Quando Usar o Novita Agent Sandbox com o SDK da 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 do navegador ou trabalho com arquivos em ambiente isolado. Essa separação mantém inferência e execução distintas, que é a estrutura adequada para agentes de codificação.

Se você estiver migrando mais de um SDK, consulte também o guia do SDK Python da OpenAI e o guia da API LLM da Novita.

Dicas de Migração do SDK da OpenAI para uma Melhor Experiência do Desenvolvedor

• Use https://api.novita.ai/openai como URL base do SDK. O SDK da OpenAI anexa o caminho versionado para você, então não é necessário adicionar /v1 manualmente.
• Substitua 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 de cada provedor.
• Trate a compatibilidade com OpenAI como um atalho de migração, não como uma garantia de que todos os recursos mais recentes da plataforma se comportarão da mesma forma. Verifique a documentação atual da Novita antes da implantação.
• Se seu fluxo de trabalho executa código gerado, operações de arquivos ou ações do navegador, mova a execução para o Agent Sandbox em vez de 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 a aplicação é baseada em agentes, 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 conclusões de chat, depois confirme o ID exato do modelo na biblioteca de modelos antes do uso em produção.