← Back
Deepgram Flux adds Configure control message for mid-stream speech recognition updates
· featureapisdk · developers.deepgram.com ↗

Dynamic Mid-Stream Configuration Without Reconnection

Deepgram Flux now supports a Configure control message that enables real-time configuration updates over an active WebSocket connection. This eliminates the need to disconnect and reconnect when speech recognition behavior needs to adapt during a conversation, simplifying application logic and preventing audio loss during state transitions.

What You Can Now Update Mid-Stream

The Configure message allows dynamic adjustments to three key parameters:

  • Keyterms – Inject task-critical vocabulary as conversation context changes (customer names, medications, product terminology)
  • Turn detection thresholds (eot_threshold, eager_eot_threshold) – Tighten or relax confidence requirements for detecting end of turn
  • Timeout behavior (eot_timeout_ms) – Adjust silence tolerance for different conversation phases

Real-World Use Cases

Context-aware vocabulary: Add a customer's name to keyterms right before requesting it, or swap to domain-specific terminology when transitioning from general discussion to pharmacy or product-specific troubleshooting.

Adaptive turn detection: Increase eot_timeout_ms and eot_threshold when collecting passwords, OTPs, or account numbers to prevent premature cutoffs. Relax constraints during natural conversation.

Simplified architecture: Manage a single persistent connection instead of handling multiple concurrent streams or reconnection state transitions.

Implementation Details

Send a Configure control message over the Flux WebSocket connection:

{
  "type": "Configure",
  "thresholds": {
    "eot_threshold": 0.8,
    "eot_timeout_ms": 5000
  },
  "keyterms": ["product_name", "feature_name"]
}

You'll receive a ConfigureSuccess response confirming the update, with changes taking effect immediately in audio stream order. Note: Keyterms are replaced (not merged), so include both existing and new terms if you want to add to the list.

Availability & Next Steps

Configure is currently available via direct WebSocket connections only. SDK support and self-hosted deployment options are coming soon. See the Configure Control Message documentation for comprehensive examples and the Flux API Reference for full specifications.