captions_disabled (4104, HTTP 422) · TranscriptFetch API error

Captions are disabled by the uploader. Send mode "auto" to transcribe the audio instead.

Number4104

HTTP status422Unprocessable Entity

Familycontent4xxx · the media has no transcript to give

Example response

JSON

{
  "ok": false,
  "request_id": "req_…",
  "error": {
    "code": "captions_disabled",
    "number": 4104,
    "message": "Captions are disabled by the uploader. Send mode \"auto\" to transcribe the audio instead.",
    "docs": "https://transcriptfetch.com/docs/errors/captions_disabled",
    "retry_with": {
      "mode": "auto"
    }
  }
}

Every failure carries error.code, error.number, error.message and error.docs, plus at most one of retry_with (the request change that would succeed), details (structured specifics) or issues (validation problems).

What it means

Captions disabled. Captions are disabled by the uploader. Send mode "auto" to transcribe the audio instead.

Shown to end users as: “The uploader turned off captions for this video. Switch to auto mode to transcribe the audio instead.”

Why it happens

Captions disabled. Captions are disabled by the uploader. Send mode "auto" to transcribe the audio instead.

What to do

Permanent for this input: the same request will fail the same way, so do not retry unchanged. Failed requests are never charged.
The content likely contains speech even though no caption track can be served, so AI Fallback Transcription may still produce a transcript. When it can, the response carries error.retry_with: { "mode": "auto" }; send that and it bills from 1 credit (1 credit per started 5 minutes of audio) on delivery, never on failure.

Retryable? No, this is permanent for this input. Every error response carries a request_id; include it when contacting support.