Changelog

Flux Word-Level Timestamps

🆕 Word-Level Timestamps Now Available in Flux

Flux now includes word-level timestamps in its responses. Each word in the words array carries start and end times (type double) alongside the existing word and confidence values.

Example response:

1
{
2
  "event": "EndOfTurn",
3
  "turn_index": 0,
4
  "transcript": "Hello, how can I help you?",
5
  "words": [
6
    {
7
      "word": "Hello,",
8
      "confidence": 0.96,
9
      "start": 0.0,
10
      "end": 0.18
11
    },
12
    {
13
      "word": "how",
14
      "confidence": 0.98,
15
      "start": 0.24,
16
      "end": 0.36
17
    },
18
    {
19
      "word": "can",
20
      "confidence": 0.99,
21
      "start": 0.36,
22
      "end": 0.48
23
    },
24
    {
25
      "word": "I",
26
      "confidence": 0.97,
27
      "start": 0.48,
28
      "end": 0.54
29
    },
30
    {
31
      "word": "help",
32
      "confidence": 0.99,
33
      "start": 0.54,
34
      "end": 0.72
35
    },
36
    {
37
      "word": "you?",
38
      "confidence": 0.98,
39
      "start": 0.72,
40
      "end": 0.96
41
    }
42
  ]
43
}

This is an additive change. No existing fields are removed or altered.

SDK Compatibility

Most integrations will continue to work without changes. The exception is clients configured to reject unrecognized fields, which may return errors when the new fields appear. Here is what we recommend:

• Python: Versions 6.0.1 and later are unaffected. If you are on the 5.x line, update to 5.3.4. Earlier 5.x versions do not handle the new fields reliably and should be updated.
• JavaScript / TypeScript: Not expected to be affected, as the SDK does not reject unrecognized fields. We recommend staying current on the v5.x line.
• Java: The latest release accepts the additional fields and requires no action. We recommend confirming you are on the current version.
• Custom integrations: If you parse Flux responses directly, ensure your code ignores fields it does not recognize. This protects you for this change and for future additive updates.

If you are already on a supported version, no action is needed.

Learn More

See the Flux API Reference for the full response schema, and the Flux Quickstart for getting started.