agentutility(7)$ man speaker-diarize
/speaker-diarize
NAME
speaker-diarize — transcribe audio or video and label who said what
SYNOPSIS
POST https://x402.agentutility.ai/speaker-diarize
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Transcribe audio or video and label who said what. Send a media_url (optionally language and num_speakers) and it runs Whisper v3 speech-to-text with speaker diarization, returning an utterances array grouped by speaker with start/end timestamps and text, plus per-speaker stats (utterance count, seconds spoken, word count) and total duration_seconds. Files up to 60 minutes are supported. Use it as a speaker diarization API, who-said-what transcription tool, multi-speaker transcript generator, or meeting/interview transcription service for calls, podcasts, and recorded interviews.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| media_url | string | Audio or video URL to transcribe and diarize. Max 60 minutes duration. | required |
| language | string | ISO language code hint for transcription. Optional; auto-detected if omitted. | optional |
| num_speakers | number | Expected number of speakers. Optional; 1-20, 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.agentutility.ai/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 the MCP package for this endpoint's cluster npx -y @agentutility/mcp-<cluster> # Required: EVM private key with USDC on Base export X402_PRIVATE_KEY=0x... # Then call the speaker-diarize tool from your MCP-aware agent.
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 |
|---|---|---|
| doc-to-json | Converts any document (PDF, DOCX, PPT, XLSX, or image) into structured JSON matching a caller-supplied schema. | $0.10 |
| extract-tables | Detects and extracts every table from a PDF document, returning structured JSON or CSV per table. | $0.10 |
| pdf-extract-tables | Extracts every table from a PDF, digital or scanned, and returns row-by-column text matrices page-by-page. | $0.10 |
| pdf-table-extract | Extracts tables from digital or scanned PDFs, returning row/column matrices, CSV output, page numbers, and optional cell boxes. | $0.10 |
| pdf-table-extractor | Finds tables in digital or scanned PDFs and returns row-by-column matrices, page numbers, and optional cell bounding boxes. | $0.10 |
| pdf-to-jpg | Convert a PDF into page images for previews, thumbnails, or archiving. | $0.10 |
| transcribe | Convert spoken audio or video into text. | $0.10 |
| video-summarize | Summarizes videos, podcasts, and lectures in one call: Whisper v3 transcribes, then Mistral summarizes. | $0.10 |
SEE ALSO