Chaves de API

• Autenticar requisições para a Novita AI com uma chave de API Bearer.
• Criar uma chave de API no console e armazená-la com segurança.
• Definir a chave como uma variável de ambiente no Linux, macOS ou Windows.
• Verificar por quanto tempo uma chave permanece válida e quais operações de chave a OpenAPI oferece suporte.
• Configurar políticas de acesso a modelos e à rede para uma chave.

​

Autenticação

Authorization: Bearer <API Key>

curl "https://api.novita.ai/openai/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $NOVITA_API_KEY" \
  -d '{
    "model": "deepseek/deepseek-v4.1-flash",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

​

Criar uma chave de API

​

Configurar controles de acesso

• Acesso a modelos para chaves de API controla quais modelos uma chave pode chamar dentro do intervalo de modelos habilitados da sua equipe.
• Acesso de rede para chaves de API controla quais IPs de origem podem usar uma chave para invocação de modelos.

​

Formato e validade da chave

• Toda chave começa com o prefixo sk_.
• Uma chave é exibida por completo apenas uma vez, quando é criada. Depois disso, o console exibe uma forma mascarada.
• Cada conta pode criar até 10 chaves de API.

​

O que a OpenAPI abrange

• Listar chaves de API — lista as chaves da sua equipe, com um resumo opcional de acesso a modelos.
• Obter política de acesso a modelos de chave de API — lê a política de acesso a modelos de uma única chave.
• Definir política de acesso a modelos de chave de API — define ou atualiza a política de acesso a modelos de uma chave.
• Redefinir política de acesso a modelos de chave de API — redefine a política de acesso a modelos de uma chave para o padrão. Isso redefine apenas a política; não exclui a própria chave.
• Obter política de acesso de IP de chave de API — lê a política de acesso de rede de uma única chave.
• Definir política de acesso de IP de chave de API — define ou atualiza os IPs de origem permitidos para uma chave.
• Excluir política de acesso de IP de chave de API — limpa a política de acesso de rede de uma chave, restaurando a ausência de restrição de IP de origem.

​

Armazene sua chave como uma variável de ambiente

​

Temporária vs. permanente

# Temporary: current session only
export NOVITA_API_KEY="<Your API Key>"

# Permanent: append to your shell profile, then reload
echo 'export NOVITA_API_KEY="<Your API Key>"' >> ~/.bashrc
source ~/.bashrc

# Temporary: current session only
export NOVITA_API_KEY="<Your API Key>"

# Permanent: append to your shell profile, then reload
# Newer macOS uses zsh (~/.zshrc); older setups use bash (~/.bash_profile)
echo 'export NOVITA_API_KEY="<Your API Key>"' >> ~/.zshrc
source ~/.zshrc

# Temporary: current PowerShell session only
$env:NOVITA_API_KEY = "<Your API Key>"

# Permanent: persist for the current user, then open a new terminal
setx NOVITA_API_KEY "<Your API Key>"

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.novita.ai/openai",
    api_key=os.environ.get("NOVITA_API_KEY"),
)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.novita.ai/openai",
  apiKey: process.env.NOVITA_API_KEY,
});

​

A variável está definida, mas o código ainda não a encontra

​

Relacionados

• Códigos de erro comuns — resolva respostas 401 e 403 relacionadas a chaves.
• Limites de taxa — limites de requisições e tokens que se aplicam à sua conta.