transcriptlab_begin_audio_upload
ChatGPTCreate a signed direct-upload session for an opened audio file. App-facing only: the uploader view calls it, not the model.
transcriptlab_discover_captions
ChatGPTList the caption languages and track types (manual vs generated) available for a YouTube video. Use when the user asks which languages or subtitles a video has, or before transcriptlab_get_transcript when they want a specific language. Free in transcript credits, but subject to the account monthly discovery limit.
transcriptlab_export_link
ChatGPTCreate a 10-minute signed download link (TXT, SRT, VTT, Markdown, or JSON) for a library transcript or an uploaded file. App-facing only: the launcher Download action calls it, not the model.
transcriptlab_get_job_status
ChatGPTCheck whether a transcript job from transcriptlab_get_transcript has finished. Use it when that tool returned a job_id instead of a transcript. Returns status only, delivers no transcript, and spends no credits; once it reports done, read the text with transcriptlab_retrieve_transcript.
transcriptlab_get_speech_transcript
ChatGPTRead the speech-to-text transcript started by transcriptlab_transcribe_file (pass upload_id) or transcriptlab_transcribe_media_url (pass media_id). Pass exactly one id. While transcription runs it returns a pending result: wait a few seconds, back off, and stop after about ten tries; if it is still pending, tell the user the job is queued instead of looping. Reading does not start new work or add charges.
transcriptlab_get_transcript
ChatGPTGet a YouTube transcript from existing captions. Use when the user gives a YouTube link or video ID and wants the transcript. Returns the transcript, or a job id when the request outlives the synchronous window: if a job comes back, poll transcriptlab_get_job_status, then read the text with transcriptlab_retrieve_transcript. The first delivery of each transcript variant can spend credits; later deliveries of that variant are free. Captions only: when the user asks which caption tracks exist use transcriptlab_discover_captions; when the video has no captions, or the source is an attached file or a direct media link, use transcriptlab_transcribe_file or transcriptlab_transcribe_media_url.
transcriptlab_get_usage
ChatGPTRead the account plan, remaining credits, and current-period usage. Use when the user asks about cost, balance, or limits, or before a credit-spending request.
transcriptlab_list_job_items
ChatGPTReturn per-video results for a batch or channel job. App-facing only: the launcher Batch tab calls it. Page with the returned cursor.
transcriptlab_list_transcripts
ChatGPTList YouTube videos whose transcripts were already delivered to this account, most recent first. Use it to find or reopen an earlier transcript. It fetches nothing and delivers no transcript. When more results exist, page with the returned cursor.
transcriptlab_mentions
ChatGPTComposer at-mention search over the account’s transcript library, used to build the @TranscriptLab picker. App-facing only: the host calls it, it returns resource links rather than transcript text, and the model should not call it.
transcriptlab_open
ChatGPTOpen the TranscriptLab launcher view, where the user can work with transcripts visually and send one into the chat with "Discuss in chat". Use tab "upload" when a file needs the uploader: the user wants to pick a local audio or video file, the attached file is too large or could not be read by transcriptlab_transcribe_file, or that upload failed. Use "batch" for a list of YouTube URLs, "library" to reopen earlier transcripts, and "link" (the default) to paste a YouTube link. Also offer it when the user wants a transcript but has given no link or file.
transcriptlab_open_audio
ChatGPTEntry point the host invokes when the user opens an audio or video file with this plugin: opens the uploader view and starts speech-to-text. You do not call this directly; for a file attached to the conversation use transcriptlab_transcribe_file.
transcriptlab_read_audio_transcript
ChatGPTRead the transcript of a file uploaded through the uploader view. A pending transcription reports 202; retry shortly. App-facing only.
transcriptlab_retrieve_transcript
ChatGPTRead a YouTube transcript that is already published for this account, without starting a new fetch. Use it after transcriptlab_get_job_status reports a job done, or to re-open a variant that was delivered before. For a first request use transcriptlab_get_transcript instead. Reading an already delivered variant is free; a never-before-delivered variant can spend credits like the original request.
transcriptlab_search_transcript
ChatGPTSearch, quote, or slice a transcript already delivered to this account. Use for "find the part where...", keyword or regex lookup, or paginating a long transcript into chunks. It never starts a fetch and never charges transcript credits, so it only works on a video already cached here: deliver it first with transcriptlab_get_transcript if it is not. mode chooses the behavior: keyword matches terms, regex matches a pattern, chunk returns sequential sections.
transcriptlab_start_audio_transcription
ChatGPTFinalize a signed upload and start speech-to-text on it. App-facing only: the uploader view calls it once the file is uploaded. Spends credits per audio minute.
transcriptlab_submit_batch
ChatGPTQueue a list of YouTube URLs as one batch job and return its job id. App-facing only: the launcher Batch tab calls it. The plan caps how many URLs one job accepts.
transcriptlab_transcribe_file
ChatGPTTranscribe an audio or video file the user attached to this conversation, using speech-to-text (mp3, m4a, wav, mp4, webm and similar). Use it for an attached media file; YouTube links use transcriptlab_get_transcript instead. Spends credits per audio minute. Attachments up to 300 MB work here; larger files (up to 2 GB) use the launcher upload view. Stores the file, starts transcription, and returns an upload_id: poll transcriptlab_get_speech_transcript with it, waiting a few seconds between tries and stopping after about ten. Do not call this again for the same file. If it fails or the file is too large, call transcriptlab_open with tab "upload".
transcriptlab_transcribe_media_url
ChatGPTTranscribe a public https link to an audio or video file with speech-to-text. Use it for a direct media URL (ending in .mp3, .m4a, .wav, .mp4, .webm and similar); not for YouTube or other web pages, which use transcriptlab_get_transcript. Spends credits per audio minute. Returns a media_id: poll transcriptlab_get_speech_transcript with it, waiting a few seconds between tries and stopping after about ten.