> ## Documentation Index
> Fetch the complete documentation index at: https://docs.heify.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Transcribe
> Submit audio and video files for transcription and AI quality scoring.
The Transcribe page is where you submit audio or video content for processing. Select a **Configuration** (required) that defines how the content will be handled, optionally attach an **Evaluator** to score the transcript against quality criteria, optionally link a **Participant** to attribute the result to a specific person, then provide the media as a local file upload or a public URL.
***
## Transcription parameters
The three parameters are arranged as a tree to communicate their relationship:
```mermaid theme={null}
flowchart TD
A[Configuration\nRequired]
B[Evaluator\nOptional]
C[Participant\nOptional]
A --> B
A --> C
```
### Configuration *(required)*
A searchable dropdown listing all your configurations. Selecting one associates all of its settings — language, summary, extraction fields, and webhooks — with this transcription job.
Don't have a configuration yet? [Create one first →](/sandbox/configurations)
### Evaluator *(optional)*
Opens a selector modal listing your evaluators with name, ID, and criteria count. Selecting one causes the AI to score the transcript against that evaluator's criteria once processing completes.
### Participant *(optional)*
Opens a selector modal listing your participants with name, ID, and department (if set). Selecting one links the transcription result to that person for analytics and performance reporting.
Selecting both an **Evaluator** and a **Participant** gives you quality scores attributed to a specific person — the foundation of individual performance tracking.
***
## Upload method
A toggle below the parameter selectors switches between two modes:
| Mode | Use when |
| ----------------- | ------------------------------------------------------- |
| **Local File(s)** | You have files on your device to upload |
| **Public URL** | The file is already hosted at a publicly accessible URL |
***
## Local File(s) mode
### Drop zone
Drag & drop files onto the zone or click anywhere on it to open a file picker.
**Supported formats:** `aac` · `aiff` · `amr` · `asf` · `flac` · `mp3` · `ogg` · `wav` · `webm` · `m4a` · `mp4`
For file size and duration limits, see [Rate Limits & Quotas](/platform/rate-limits).
Files with unsupported formats are automatically filtered out and a warning shows how many were rejected. You can add up to **25 files** per submission.
### Processing Queue
The queue appears as soon as files are added. Each item shows:
| Element | Description |
| -------------------- | ---------------------------------------------------------------------------- |
| **Status icon** | Queued · Uploading · Success · Error |
| **File name & size** | Truncated filename and size in MB |
| **Name** | Optional free-text label for the transcription (e.g. `Q3 team meeting`) |
| **Status pill** | **Queued** · **Uploading...** · **Started** · **Error** |
| **Transcription ID** | Shown after success — monospace with copy button and link to the detail view |
Files are processed **sequentially** with a short pause between each. This is intentional and prevents API rate issues — parallel uploads are not supported.
Re-submitting a batch only retries files in **Queued** or **Error** state. Files that already completed successfully are not re-processed.
***
## Public URL mode
| Field | Required | Notes |
| ---------------------- | -------- | --------------------------------------------------------------------------------------- |
| **File URL** | Yes | Direct public link to the audio/video file (e.g. `https://my-server.com/recording.mp3`) |
| **Transcription Name** | No | Optional human-readable label |
After successful submission, a result card appears showing the transcription ID with a copy button and a link to the detail view.
The URL must be **publicly accessible** with no authentication required. The file must be reachable at the time the pipeline processes it — the download has a **60-second timeout**. Use a stable, fast URL.
***
## After submission
Once a batch finishes or a URL submission succeeds, the submit button changes to **Process More Files**. Clicking it clears the file queue (or URL fields) so you can start a new batch — your **Configuration, Evaluator, and Participant selections are retained**.
***
## Best practices
Better audio quality produces more accurate transcriptions.
**Recommended:**
* Minimize background noise
* Use quality recording equipment
* Keep audio levels consistent — not too quiet, not too loud
* 16 kHz+ sample rate (higher is better)
* Mono or stereo both work; mono files are smaller
**Avoid:**
* Heavy background music or ambient noise
* Multiple speakers talking over each other
* Very low bitrate compression
* Heavily processed audio with effects
Before submitting a URL, verify that:
* The URL opens directly in an **incognito browser window** (no login required)
* It is a **direct link to the file**, not a media player page
* The file format is one of the supported extensions
* The URL uses **HTTPS** (HTTP also accepted)
* The server can respond within **60 seconds**
You can test the URL quickly with:
```bash theme={null}
curl -I https://your-url.com/audio.mp3
```
Expect a `200 OK` response with `Content-Type: audio/...`.
***
Set up your processing templates
Create quality scoring rubrics
Manage agent profiles