Transcript Document Format

This page describes the JSON body of a speech-to-text result file. It is not an HTTP API. When an STT task succeeds, Query Task Result returns result.resources[] with type set to document. Download resources[].url; the response body matches modellix.transcript.v1 (normalized across providers, not vendor-raw JSON). Used by Fun-ASR, Grok Voice ASR, Whisper, MAI-Transcribe, and other STT models.

How to obtain

Submit an STT model request

Call a speech-to-text model endpoint. The platform returns an async task (task_id).

Poll the task

Call Query Task Result until data.status is success.

Download the document resource

Find result.resources[] where type is document, then GET that url. The body is the schema below.

Root object

Field	Type	Required	Description
`schema`	string	yes	Always `modellix.transcript.v1`
`text`	string	yes	Full transcript text (non-empty)
`language`	string	no	Detected or provider language label (may be a display name such as `English`)
`duration_ms`	integer	no	Audio duration in milliseconds
`channels`	array	no	Per-channel transcripts. See Channel

Channel

Field	Type	Required	Description
`channel_id`	integer	yes	Channel index (0-based)
`text`	string	no	Channel-level full text
`sentences`	array	no	Sentence segments. See Sentence

Sentence

Field	Type	Required	Description
`begin_ms`	integer	yes	Start time in milliseconds
`end_ms`	integer	yes	End time in milliseconds
`text`	string	yes	Sentence text
`speaker_id`	integer	no	Speaker id when diarization is enabled and speakers are consistent for the sentence
`words`	array	no	Word-level timings. See Word

Word

Field	Type	Required	Description
`begin_ms`	integer	yes	Start time in milliseconds
`end_ms`	integer	yes	End time in milliseconds
`text`	string	yes	Word text
`speaker_id`	integer	no	Speaker id when diarization is enabled

Examples

Single-channel with word timings

{
  "schema": "modellix.transcript.v1",
  "text": "The balance is $100.",
  "language": "English",
  "duration_ms": 3450,
  "channels": [
    {
      "channel_id": 0,
      "text": "The balance is $100.",
      "sentences": [
        {
          "begin_ms": 240,
          "end_ms": 3200,
          "text": "The balance is $100.",
          "words": [
            { "begin_ms": 240, "end_ms": 480, "text": "The" },
            { "begin_ms": 480, "end_ms": 960, "text": "balance" },
            { "begin_ms": 960, "end_ms": 1120, "text": "is" },
            { "begin_ms": 1120, "end_ms": 3200, "text": "$100." }
          ]
        }
      ]
    }
  ]
}

With speaker diarization

{
  "schema": "modellix.transcript.v1",
  "text": "Hello there",
  "duration_ms": 1000,
  "channels": [
    {
      "channel_id": 0,
      "text": "Hello there",
      "sentences": [
        {
          "begin_ms": 0,
          "end_ms": 1000,
          "text": "Hello there",
          "words": [
            { "begin_ms": 0, "end_ms": 400, "text": "Hello", "speaker_id": 0 },
            { "begin_ms": 400, "end_ms": 1000, "text": "there", "speaker_id": 1 }
          ]
        }
      ]
    }
  ]
}

​How to obtain

​Root object

​Channel

​Sentence

​Word

​Examples

​Single-channel with word timings

​With speaker diarization