Authentication

Pour exécuter un modèle (transcription, OCR, chat, etc.), vous devez utiliser une clé API valide. L’appel GET /models (liste du catalogue) est public : aucune clé n’est requise pour consulter les identifiants disponibles.

Get your API key

  1. Log in to your AlphaEdge dashboard
  2. Go to the API Keys section
  3. Generate a new API key or use an existing one
  4. Copy your API key (it will only be shown once)

Use your API key

Pour les requêtes d’inférence, incluez la clé dans l’en-tête X-API-Key (sauf GET /models et GET /models/{slug} qui sont publics) :

Deux formats d’en-tête sont acceptés et équivalents :

  • X-API-Key: TA_CLE (format historique recommandé)
  • Authorization: Bearer TA_CLE (compatible avec les SDK habituels)

Si les deux en-têtes sont envoyés, X-API-Key prime. En l’absence de clé valide, l’API renvoie 401 avec : {"detail": "Clé API manquante : fournissez l’en-tête X-API-Key ou Authorization: Bearer <clé>."}

Les exemples ci-dessous supposent un corps JSON. Pour OCR ou transcription (multipart), n’envoyez pas Content-Type: application/json ni un boundary construit à la main — voir les pages OCR et Audio.

bash
# Avec X-API-Key (recommandé)
curl https://api-endpoints.alphaedge-ai.com/account/me \
  -H "X-API-Key: TA_CLE"

# Équivalent : Authorization: Bearer
curl https://api-endpoints.alphaedge-ai.com/account/me \
  -H "Authorization: Bearer TA_CLE"
javascript
// Avec X-API-Key
const response = await fetch('https://api-endpoints.alphaedge-ai.com/account/me', {
  headers: { 'X-API-Key': 'TA_CLE' }
});

// Équivalent : Authorization: Bearer
const response2 = await fetch('https://api-endpoints.alphaedge-ai.com/account/me', {
  headers: { 'Authorization': 'Bearer TA_CLE' }
});
python
import requests

# Avec X-API-Key (recommandé)
response = requests.get(
    'https://api-endpoints.alphaedge-ai.com/account/me',
    headers={'X-API-Key': 'TA_CLE'},
    timeout=30,
)

# Équivalent : Authorization: Bearer
response = requests.get(
    'https://api-endpoints.alphaedge-ai.com/account/me',
    headers={'Authorization': 'Bearer TA_CLE'},
    timeout=30,
)

Security

Important: Never share your API key publicly. Do not commit it to your Git repositories. Use environment variables to store your API key.