API-sleutels

• Verzoeken aan Novita AI te authenticeren met een Bearer API-sleutel.
• Een API-sleutel in de console te maken en veilig op te slaan.
• De sleutel als omgevingsvariabele in te stellen op Linux, macOS of Windows.
• Te controleren hoelang een sleutel geldig blijft en welke sleutelbewerkingen de OpenAPI ondersteunt.
• Model- en netwerktoegangsbeleid voor een sleutel te configureren.

​

Authenticatie

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"}]
  }'

​

Een API-sleutel maken

​

Toegangsbeheer configureren

• Modeltoegang voor API-sleutels bepaalt welke modellen een sleutel kan aanroepen binnen het ingeschakelde modelbereik van uw team.
• Netwerktoegang voor API-sleutels bepaalt welke bron-IP’s een sleutel kunnen gebruiken voor modelaanroepen.

​

Sleutelformaat en geldigheid

• Elke sleutel begint met het voorvoegsel sk_.
• Een sleutel wordt slechts één keer volledig weergegeven, bij het aanmaken. Daarna toont de console een gemaskeerde vorm.
• Elk account kan maximaal 10 API-sleutels aanmaken.

​

Wat de OpenAPI ondersteunt

• API-sleutels weergeven — geeft de sleutels van uw team weer, met een optionele samenvatting van modeltoegang.
• Modeltoegangsbeleid voor API-sleutel ophalen — leest het modeltoegangsbeleid van één sleutel.
• Modeltoegangsbeleid voor API-sleutel instellen — stelt het modeltoegangsbeleid van een sleutel in of werkt het bij.
• Modeltoegangsbeleid voor API-sleutel opnieuw instellen — zet het modeltoegangsbeleid van een sleutel terug naar de standaardwaarde. Dit stelt alleen het beleid opnieuw in; het verwijdert de sleutel zelf niet.
• IP-toegangsbeleid voor API-sleutel ophalen — leest het netwerktoegangsbeleid van één sleutel.
• IP-toegangsbeleid voor API-sleutel instellen — stelt de toegestane bron-IP’s van een sleutel in of werkt deze bij.
• IP-toegangsbeleid voor API-sleutel verwijderen — wist het netwerktoegangsbeleid van een sleutel, waardoor er weer geen beperking op bron-IP’s geldt.

​

Uw sleutel als omgevingsvariabele opslaan

​

Tijdelijk vs. permanent

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

​

De variabele is ingesteld, maar de code kan deze nog steeds niet vinden

​

Gerelateerd

• Veelvoorkomende foutcodes — los 401- en 403-responsen op die gerelateerd zijn aan sleutels.
• Snelheidslimieten — aanvraag- en tokenlimieten die op uw account van toepassing zijn.