Installation

The AlphaEdge API is a REST API you can call from any programming language. No SDK installation is required; you can use HTTP requests directly.

Prerequisites

To use the AlphaEdge API, you need:

  • Une clé API (obtenez-la depuis votre tableau de bord)
  • An HTTP client (curl, Postman, or your preferred programming language)
  • An internet connection

API base URL

All requests must be sent to the following base URL:

text
https://api-endpoints.alphaedge-ai.com

Request format

Les réponses sont en JSON. Pour les endpoints dont le corps est un objet JSON (chat, complétions, etc.), envoyez au minimum :

http
Content-Type: application/json
X-API-Key: TA_CLE

Pour l’OCR et la transcription (multipart/form-data : fichier + champs optionnels), ne fixez pas Content-Type vous-même et surtout pas application/json. Utilisez curl -F, requests avec files= ou fetch(FormData) : le client définit multipart/form-data et le boundary automatiquement.

Test your connection

You can test your API connection with this simple request:

bash
curl https://api-endpoints.alphaedge-ai.com/models

This request returns the list of all available models.

En-têtes & comportements transparents

La passerelle ajoute automatiquement plusieurs en-têtes à toutes les réponses. Vous n’avez rien à configurer côté client, mais il est utile de les connaître :

  • X-Request-ID — identifiant unique de la requête (utile pour le support). Si vous envoyez vous-même cet en-tête, sa valeur est conservée et renvoyée telle quelle.
  • X-Process-Time-Ms — temps de traitement côté passerelle, en millisecondes.
  • Retry-After — présent uniquement sur les réponses 429 / 502 / 503 / 504, indique le délai recommandé avant un retry.
  • Content-Encoding: gzip + Vary: Accept-Encoding — compression activée sur les réponses suffisamment volumineuses lorsque le client envoie Accept-Encoding: gzip. Les clients HTTP modernes (curl, requests, fetch) gèrent la décompression automatiquement.
  • En-têtes de sécurité par défaut : X-Content-Type-Options: nosniff, X-Frame-Options: DENY, Referrer-Policy: no-referrer, Cross-Origin-Resource-Policy: same-origin.

Pour les endpoints sensibles (/account/*, /transcript), un Cache-Control: no-store est également présent.