audio_ineligible (3004, HTTP 422) · TranscriptFetch API error

Audio transcription cannot run on this input, so mode: "audio" (or ai_fallback) has nothing to work on.

Number3004

HTTP status422Unprocessable Entity

Familyinput3xxx · this input cannot be served

Example response

JSON

{
  "ok": false,
  "request_id": "req_…",
  "error": {
    "code": "audio_ineligible",
    "number": 3004,
    "message": "Audio transcription cannot run on this input, so mode: \"audio\" (or ai_fallback) has nothing to work on.",
    "docs": "https://transcriptfetch.com/docs/errors/audio_ineligible"
  }
}

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

Audio transcription cannot run on this input, so mode: "audio" (or ai_fallback) has nothing to work on.

Why it happens

mode: "audio" (or ai_fallback: true) on an input AI Fallback Transcription cannot serve: an arbitrary page URL rather than a video or media file.

What to do

Send the media's own URL or id.
Drop mode to let the default path decide; captions are attempted first.

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