Claves de API

• Autenticar solicitudes a Novita AI con una clave de API Bearer.
• Crear una clave de API en la consola y almacenarla de forma segura.
• Establecer la clave como variable de entorno en Linux, macOS o Windows.
• Comprobar cuánto tiempo permanece válida una clave y qué operaciones de claves admite la OpenAPI.
• Configurar políticas de acceso a modelos y red para una clave.

​

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

​

Crear una clave de API

​

Configurar controles de acceso

• Acceso a modelos para claves de API controla qué modelos puede invocar una clave dentro del rango de modelos habilitados de tu equipo.
• Acceso de red para claves de API controla qué IP de origen pueden usar una clave para la invocación de modelos.

​

Formato y validez de las claves

• Todas las claves comienzan con el prefijo sk_.
• Una clave se muestra completa solo una vez, cuando se crea. Después de eso, la consola muestra una forma enmascarada.
• Cada cuenta puede crear hasta 10 claves de API.

​

Qué cubre la OpenAPI

• Listar claves de API — lista las claves de tu equipo, con un resumen opcional del acceso a modelos.
• Obtener política de acceso a modelos de la clave de API — lee la política de acceso a modelos de una sola clave.
• Establecer política de acceso a modelos de la clave de API — establece o actualiza la política de acceso a modelos de una clave.
• Restablecer 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 solo restablece la política; no elimina la clave en sí.
• Obtener política de acceso IP de la clave de API — lee la política de acceso de red de una sola clave.
• Establecer política de acceso IP de la clave de API — establece o actualiza las IP de origen permitidas para una clave.
• Eliminar política de acceso IP de la clave de API — borra la política de acceso de red de una clave, restaurando la ausencia de restricción de IP de origen.

​

Almacena tu clave como 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á establecida, pero el código aún no la encuentra

​

Relacionado

• Códigos de error comunes — resuelve respuestas 401 y 403 relacionadas con claves.
• Límites de velocidad — límites de solicitudes y tokens que se aplican a tu cuenta.