Premiers pas
Authentification
Authentifiez vos requêtes avec une clé d'API sk-api14 envoyée comme jeton Bearer, et apprenez à créer, protéger et révoquer vos clés.
Chaque requête vers un endpoint facturé est authentifiée avec une clé d'API api14, envoyée comme jeton Bearer dans l'en-tête Authorization.
Authorization: Bearer sk-api14-...
Les SDK OpenAI ajoutent cet en-tête pour vous à partir de l'option apiKey / api_key.
Clés d'API
Créez et gérez vos clés dans Clés d'API.
- Les clés commencent par
sk-api14-et ne s'affichent qu'une seule fois, à leur création. Seul un hash est conservé : une clé perdue ne peut donc pas être récupérée. Créez-en une nouvelle et révoquez l'ancienne. - Chaque clé peut avoir sa propre limite de requêtes par minute, sa limite de dépenses quotidiennes en USD et sa liste de modèles autorisés. Voir Limites de débit.
- Le nombre de clés que vous pouvez détenir dépend de votre forfait : 1 avec Free, 10 avec Pro, davantage avec Team et Enterprise.
- La révocation d'une clé prend effet immédiatement ; les requêtes qui l'utilisent renvoient
401 invalid_api_key.
Utiliser une clé
Conservez la clé dans une variable d'environnement et lisez-la dans votre code :
export API14_API_KEY="sk-api14-..."
curl https://api14.com/api/v1/chat/completions \
-H "Authorization: Bearer $API14_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "openai/gpt-5-mini", "messages": [{"role": "user", "content": "Hello"}]}'
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api14.com/api/v1",
apiKey: process.env.API14_API_KEY,
});
const result = await client.chat.completions.create({
"model": "openai/gpt-5-mini",
"messages": [
{
"role": "user",
"content": "Explain vector databases in two sentences."
}
]
});
console.log(result.choices[0].message.content);
Endpoints sans clé
Ces endpoints de catalogue en lecture seule fonctionnent sans authentification :
| Endpoint | Description |
|---|---|
GET /models | Tous les modèles disponibles |
GET /models/{id} | Un modèle |
GET /images/models | Modèles d'image avec leurs paramètres supplémentaires |
GET /videos/models | Modèles vidéo avec résolutions et durées |
GET /embeddings/models | Modèles d'embeddings |
Tout le reste (endpoints de génération, /credits, /key, /generation et statut des tâches vidéo) nécessite une clé.
Erreurs d'authentification
Une clé absente, mal formée ou révoquée renvoie :
{
"error": {
"message": "Missing or invalid API key. Use \"Authorization: Bearer sk-api14-…\".",
"type": "authentication_error",
"code": "invalid_api_key"
}
}
avec le statut HTTP 401. Une clé restreinte par sa liste de modèles autorisés renvoie 403 model_not_allowed pour les autres modèles. Voir Erreurs.
Protéger vos clés
- Ne placez jamais une clé dans le code d'un navigateur ou d'une application mobile : n'importe qui peut l'y lire. Appelez api14 depuis votre serveur.
- Ne commitez jamais de clés dans votre gestionnaire de versions. Utilisez des variables d'environnement ou un gestionnaire de secrets.
- Utilisez une clé par application ou par environnement, pour pouvoir en révoquer une sans casser les autres.
- Définissez une limite quotidienne en USD sur les clés utilisées par des scripts ou des services moins fiables, pour qu'un bug ne puisse pas vider votre solde.
- Si une clé fuite, révoquez-la immédiatement dans Clés d'API.