> ## Documentation Index
> Fetch the complete documentation index at: https://docs.framelane.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Transcribe

> Transcribe audio or video to text with word-level timestamps and optional speaker diarisation.

<Note>
  This skill is available as a machine-readable YAML playbook — append `.md` to any docs page for raw markdown, or install the [Framelane skill](https://framelane.io/skill.md). Drive the calls through the authenticated action MCP at `https://mcp.framelane.io/mcp`.
  Load it into any MCP-capable agent to get the complete workflow without writing integration code.
</Note>

## What this skill does

Submits a `POST /v1/tasks/transcribe` job via AssemblyAI, polls until complete, fetches the transcript JSON, and returns it. Word-level timestamps are always included so the output is ready to feed into `word_animation` in a render request.

## Load via MCP

```
@framelane-skill:transcribe
```

## Inputs

| Name              | Required     | Description                                                 |
| ----------------- | ------------ | ----------------------------------------------------------- |
| `source_url`      | **required** | URL of the audio or video file                              |
| `source_language` | optional     | BCP-47 language code (e.g. `en`). Auto-detected if omitted. |
| `speaker_labels`  | optional     | Enable speaker diarisation. Default: `false`.               |

## Output

Returns `transcript` — the full AssemblyAI JSON including `text`, `words[]` (with `text`, `start`, `end` per word), and optionally `utterances[]` when speaker labels are enabled.