start_batch
Start sequential batch transcription of untranscribed files in a folder. Skips completed files, processes shortest first, and flags invalid outputs.
Instructions
Start an automated sequential batch transcription of all untranscribed files in a folder. Scans for files without a matching .txt, sorts by duration (shortest first), and processes them one at a time as background jobs. Each file is validated after completion — empty or suspiciously short outputs are flagged. Batch self-advances without polling when each file finishes. Returns a batch ID to use with check_batch_progress. ⚠️ Privacy: when privacy_mode is active, one confirmation is required before the batch starts. All files then process unattended. No transcript text is returned to the API.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| threads | No | CPU threads. Defaults to 4 of 8. | |
| language | No | Language code. Defaults to en. | en |
| folder_path | Yes | Absolute Windows path to the folder. | |
| privacy_mode | No | Override privacy mode for this batch. When active, requires one confirmation before batch start. All files process unattended with no transcript text returned. | |
| output_format | No | timestamps = with time codes (default), text = plain. Applies to all files in the batch. | timestamps |