---
title: "Transcribe a recorded request with a hosted speech service; nothing runs"
method: POST
path: "/v1/dictation/transcribe"
---

# Transcribe a recorded request with a hosted speech service; nothing runs

`POST /v1/dictation/transcribe`

## Request

- Base URL: `https://api.specstream.ai`
- URL: `https://api.specstream.ai/v1/dictation/transcribe`
- Auth: API key in header `Authorization`

## Query parameters

- `document_id` string, required
- `revision` integer, required
- `recording_id` string, required
- `sequence` integer
- `base_text_hash` string, required
- `language` string, nullable
- `expected_audio_sha256` string, nullable

## Response `200`

Editable transcript and recording identity

- object
  - `data` DictationResult, required
    - `spec_version` 'dictation.v1'
    - `input` DictationInput, required
      - `document_id` string, required
      - `revision` integer, required
      - `recording_id` string, required
      - `sequence` integer
      - `base_text_hash` string, required
      - `language` string, nullable
      - `expected_audio_sha256` string, nullable
    - `audio_sha256` string, required
    - `request_hash` string, required
    - `duration_seconds` number, required
    - `status` 'transcribed' | 'uncertain' | 'no_speech', required
    - `text` string, required
    - `transcript_sha256` string, required
    - `detected_language` string, nullable
    - `provider` 'cloudflare' | 'groq', nullable, required
    - `model` string, nullable, required
    - `segments` TranscriptSegment[]
      - `start` number, required
      - `end` number, required
      - `text` string, required
      - `avg_logprob` number, nullable
      - `no_speech_probability` number, nullable
      - `compression_ratio` number, nullable
    - `warnings` string[]
    - `transcription_only` true
    - `translation_requested` false
    - `audio_retention` 'request_memory_only'
    - `machine_generated` true

## Other responses

- `default`: Error envelope

---

[API](https://skmtc.dev/specstream/apis/specstream-api.md) · [All operations](https://skmtc.dev/specstream/apis/specstream-api/llms.txt) · [OpenAPI document](https://skmtc.dev/specstream/apis/specstream-api/revisions/5a9f51143a13?raw)