$ man speaker-diarize
/speaker-diarize(1)
NAME
speaker-diarize — speaker diarization / who-said-what transcription
SYNOPSIS
POST https://x402.org/v1/speaker-diarize
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Speaker diarization / who-said-what transcription. Whisper v3 + speaker labels. Returns utterances grouped by speaker, plus per-speaker stats (count, seconds, words). 60 min max.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| media_url | string | Public URL to the audio or video file to transcribe and diarize (mp3, mp4, wav, m4a, etc., up to 60 min). | required |
| language | string | Optional ISO-639-1 language hint (e.g. 'en', 'es'); omit to auto-detect from the audio. | optional |
| num_speakers | number | 1-20 hint. Auto-detected if omitted. | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| text | string | Full transcript as a single string with all speaker turns concatenated in chronological order. |
| utterances | array | Array of speaker turns, each with speaker label, start/end timestamps, and the spoken text. |
| speaker_count | number | Number of distinct speakers detected in the audio. |
| speaker_stats | array | Per-speaker rollup with speaker label, utterance count, total seconds spoken, and word count. |
| duration_seconds | number | Total length of the input media in seconds. |
| detected_languages | array | Array of ISO-639-1 language codes Whisper detected across the audio. |
| source_url | string | Echo of the media_url that was transcribed, for request/response correlation. |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.org/v1/speaker-diarize \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# install once claude mcp add x402 --command "npx x402-deployer-mcp" # then ask Claude Code: # "use the speaker-diarize tool to ..."
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- transcriptiondiarizationspeakerswhisperpodcastmeeting
- env
- FAL_KEY_TRANSCRIBE
- methods
- POST
- cluster
- mediakit
- price
- $0.10 USDC per call
ADJACENT — other endpoints in mediakit
| endpoint | description | price |
|---|---|---|
| extract-tables | Extract tables from PDF / table extractor / PDF to CSV / spreadsheet from PDF. | $0.10 |
| mp4-to-mp3 | MP4 → MP3 audio extractor. | $0.10 |
| pdf-extract-tables | PDF table extractor / table from PDF / scanned-table parsing / financial-table OCR / multi-page table consolidator / Datalab Marker tables. | $0.10 |
| pdf-to-jpg | PDF to JPG / PNG / WEBP image converter. | $0.10 |
| transcribe | Video / audio transcription via Whisper v3. | $0.10 |
| upscale-image | AI image upscaler / super-resolution / image enlarger. | $0.10 |
| video-summarize | Video summarizer / podcast summarizer / lecture notes generator. | $0.10 |
| video-to-audio | Video → audio extractor / video to audio converter. | $0.10 |
SEE ALSO