Turn a recording into subtitles.

1. Get your account ready.

Request beta access, then follow the API key guide. Add a prepaid usage balance before uploading files. Set YPAD_KEY in your local environment; keep the key out of source files, shared notebooks, and browser storage.

2. Upload a file and keep its ID.

Follow the upload steps to declare the exact content type and byte count, then PUT the file to its signed upload URL. The batch accepts the returned file ID.

Download the guide’s sample input ↓. The guide credits its public-domain source.

3. Download and edit the dry-run template.

Replace YOUR_UPLOADED_FILE_ID. The template is a dry run; it does not submit a paid job. Its one-minute upper bound suits the 52-second sample. Probe other files and allow headroom within the model limits.

{
  "model": "whisper-large-v3",
  "items": [
    {
      "file": "YOUR_UPLOADED_FILE_ID",
      "params": {
        "language": "en",
        "format": "srt"
      },
      "max_units": 1
    }
  ],
  "dry_run": true
}

Download batch JSON ↓

# Save the template as batch.json and replace YOUR_UPLOADED_FILE_ID.
curl --fail-with-body "https://www.y-pad.com/v1/batches" -H "Authorization: Bearer $YPAD_KEY" -H "Content-Type: application/json" --data @batch.json

4. Review, then submit.

Inspect held_micros and missing-file results. When you are ready to pay for processing, remove dry_run, send the same body with an Idempotency-Key, and follow the polling and download steps. Keep the same key and body when retrying a submission.

Keep the originals and your results.

Review important edges, text, and timing before publishing. Model output can contain mistakes or estimated detail. Save your downloads locally: Deletion starts at 7 days and normally finishes within a further day.

Return to the full guide ↗