Transcribe Video
POST /api/agents/youtube/transcribe
Submit a YouTube URL for transcription — returns immediately with a job id.
The transcription pipeline runs in a background task: captions fetched first,
then Whisper fallback if unavailable. If auto_analyze is true (either
from the request or from config default), LLM analysis runs after
transcription completes.
Args: request: URL plus optional per-request overrides (auto_analyze, preferred_language).
Returns:
The newly-created job record with status="queued" (will progress
through “downloading” → “transcribing” → “analyzing” → “complete”).
Raises:
HTTPException(400): The URL is not a recognizable YouTube video URL,
no project is active (the route needs to tag the job with a
project), or start_transcription rejected the request
(e.g., duration limit exceeded, invalid config).
Request Body required
Section titled “Request Body required ”Responses
Section titled “ Responses ”Successful Response
Transcription job status.
object
Unique job identifier
YouTube video ID
Original YouTube URL
Video title
Channel name
Video duration in seconds
Current job status
Progress percentage
ISO timestamp of job creation
Validation Error