Vue d’Ensemble & Authentification de l’API

OneASR propose une suite d’API REST et WebSocket standardisée et haute performance pour la reconnaissance vocale, l’analyse multimédia et la gestion de fichiers.

---

URL de Base

• Déploiement Local: http://localhost:8000
• Point de Terminaison Compatible OpenAI: http://localhost:8000/v1
• Point de Terminaison WebSocket Temps Réel: ws://localhost:8000/v1/realtime (ou /v1/realtimeext)

---

Authentification

Toutes les requêtes vers les points de terminaison OneASR nécessitent une clé API valide configurée dans config.yaml (api_key: sk-oneasr-...).

Vous pouvez transmettre la clé API en utilisant l’une des trois méthodes suivantes :

1. Jeton Bearer HTTP (Format standard OpenAI)

Authorization: Bearer sk-oneasr-v1-p_L3kXm9QZ8sT2vA4wE7rY1u

2. En-tête Personnalisé (X-API-Key)

X-API-Key: sk-oneasr-v1-p_L3kXm9QZ8sT2vA4wE7rY1u

3. Paramètre d’URL (Recommandé pour les WebSockets)

ws://localhost:8000/v1/realtime?api_key=sk-oneasr-v1-p_L3kXm9QZ8sT2vA4wE7rY1u

---

Groupes Fonctionnels d’API

Groupe	Points de Terminaison	Protocole	Description
Audio OpenAI	/v1/audio/transcriptions, /v1/models	HTTP REST	Remplacement direct d’OpenAI pour la transcription vocale et la découverte de modèles
Streaming Temps Réel	/v1/realtime, /v1/realtimeext	WebSocket	Streaming audio en direct duplex à faible latence avec prise en charge VAD
Transcription de Fichiers	/v1/file-transcription/transcriptions	HTTP & SSE	Traitement asynchrone en arrière-plan pour fichiers volumineux (jusqu’à 2 Go)
Stockage de Fichiers	/v1/files/*, /v1/files/fetch-url	HTTP REST	Téléversement de fichiers, gestion du stockage et téléchargement depuis URL distante
Médias & Moteurs	/v1/media/parse, /v1/providers	HTTP REST	Extraction de pistes audio et état des fournisseurs de moteurs ASR