Clés API

• Authentifier les requêtes adressées à Novita AI avec une clé API Bearer.
• Créer une clé API dans la console et la stocker en toute sécurité.
• Définir la clé comme variable d’environnement sous Linux, macOS ou Windows.
• Vérifier combien de temps une clé reste valide et quelles opérations sur les clés l’OpenAPI prend en charge.
• Configurer les politiques d’accès aux modèles et au réseau pour une clé.

​

Authentification

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

​

Créer une clé API

​

Configurer les contrôles d’accès

• Accès aux modèles pour les clés API contrôle quels modèles une clé peut appeler dans la plage de modèles activée de votre équipe.
• Accès réseau pour les clés API contrôle quelles adresses IP sources peuvent utiliser une clé pour l’invocation de modèles.

​

Format et validité de la clé

• Chaque clé commence par le préfixe sk_.
• Une clé n’est affichée en entier qu’une seule fois, lors de sa création. Ensuite, la console affiche une forme masquée.
• Chaque compte peut créer jusqu’à 10 clés API.

​

Ce que couvre l’OpenAPI

• Lister les clés API — liste les clés de votre équipe, avec un récapitulatif facultatif des accès aux modèles.
• Obtenir la politique d’accès aux modèles d’une clé API — lit la politique d’accès aux modèles d’une seule clé.
• Définir la politique d’accès aux modèles d’une clé API — définit ou met à jour la politique d’accès aux modèles d’une clé.
• Réinitialiser la politique d’accès aux modèles d’une clé API — réinitialise la politique d’accès aux modèles d’une clé à la valeur par défaut. Cela réinitialise uniquement la politique ; cela ne supprime pas la clé elle-même.
• Obtenir la politique d’accès IP d’une clé API — lit la politique d’accès réseau d’une seule clé.
• Définir la politique d’accès IP d’une clé API — définit ou met à jour les adresses IP sources autorisées pour une clé.
• Supprimer la politique d’accès IP d’une clé API — efface la politique d’accès réseau d’une clé, rétablissant l’absence de restriction sur les IP sources.

​

Stocker votre clé comme variable d’environnement

​

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

​

La variable est définie mais le code ne la trouve toujours pas

​

Voir aussi

• Codes d’erreur courants — résoudre les réponses 401 et 403 liées aux clés.
• Limites de débit — limites de requêtes et de jetons qui s’appliquent à votre compte.