Presets
Le SDK envoie des identifiants de preset (slugs) en paramètres de requête sur l’URL WebSocket. Il n’envoie pas de prompt brut ni de configuration VAD détaillée depuis ces props : la résolution métier est côté serveur, en lien avec votre clé API.
Props du TranscriptionButton
| Prop | Paramètre URL | Rôle |
|---|---|---|
promptPresetId | prompt_preset_id | Preset de transcription (prompt ASR). Si omis, défaut serveur (default). |
vadPresetId | vad_preset_id | Preset VAD / découpage. Si omis, défaut serveur (default). |
reformatPresetId | reformat_preset_id | Preset de relecture finale (LLM). Si omis, passthrough / pas de relecture. |
model | model | 'default' ou 'vox' (modèle final médical Ephia Vox). |
Les paramètres ne sont ajoutés à l’URL que lorsque la prop correspondante est renseignée (chaîne non vide après trim, comportement du code du bouton).
useStreamingV2
Si vous construisez streamingUrl vous-même, vous pouvez ajouter les mêmes noms de paramètres dans la query.
Le hook accepte vadSettings : chaque paire clé/valeur définie est ajoutée à la query à l’ouverture du WebSocket. Ce n’est pas le même mécanisme que vad_preset_id passé par le bouton.
Les presets inexistants ou inactifs déclenchent un warning serveur (streamingWarning) et un fallback automatique. Voir Connexion et flux.
Paramétrage par usage
Voici les combinaisons courantes selon votre cas d’usage médical :
| Usage | promptPresetId | vadPresetId | reformatPresetId | model | interimStreaming |
|---|---|---|---|---|---|
| Consultation rapide | default ou spécialité | default | — | default | false |
| Dictée radiologie | radiology | default | medical_fr | vox | true |
| Compte-rendu final | radiology | default | medical_fr | vox | false |
| Latence minimale | default | low_latency | — | default | false |
Les slugs de presets (radiology, medical_fr, etc.) sont des exemples. Les presets réellement disponibles dépendent de votre clé API et de votre configuration côté plateforme.
Voir Référence SDK.