Claves de API

• Autenticar solicitudes a Novita AI con una clave de API Bearer.
• Crear una clave de API desde la consola y almacenarla de forma segura.
• Configurar tu clave como una variable de entorno en Linux, macOS y Windows.
• Entender cuánto tiempo sigue siendo válida una clave y qué cubre y no cubre OpenAPI.

​

Autenticación

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-r1",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

​

Crear una clave de API

​

Formato y validez de la clave

• Cada clave comienza con el sk_ prefijo.
• Una clave se muestra completa solo una vez, al crearla. Después, la consola muestra una forma enmascarada.
• Una clave permanece válida indefinidamente una vez creada. Sigue funcionando hasta que la eliminas en la consola.
• Cada cuenta puede crear hasta 10 claves de API.

​

Qué cubre la OpenAPI

• Listar claves de API — enumera las claves de tu equipo, con un resumen opcional del acceso a modelos.
• Obtener la política de acceso a modelos de la clave de API — lee la política de acceso a modelos de una clave individual.
• Establecer la política de acceso a modelos de una clave de API — establecer o actualizar la política de acceso a modelos de una clave.
• Restablecer la política de acceso a modelos de la clave de API — restablece la política de acceso a modelos de una clave al valor predeterminado. Esto restablece solo la política; no elimina la clave en sí.

​

Almacena tu clave como una variable de entorno

​

Temporal 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,
});

​

La variable está configurada, pero el código aún no puede encontrarla

​

Relacionado

• Acceso a modelos para claves de API — restringe a qué modelos puede llamar una clave.
• Códigos de error comunes — resolver 401 y 403 respuestas relacionadas con claves.
• Límites de tasa — límites de solicitudes y de tokens que se aplican a tu cuenta.