Name: subtitles
Price: 0.08 USDC
Availability: InStock

$ man subtitles

agentutility / mediakit / subtitles

PRICE / CALL

$0.08

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

mediakit

CATEGORY

media

STATUS

● live

NAME

subtitles — generate ready-to-use subtitle files from a video or audio url

SYNOPSIS

POST https://x402.agentutility.ai/subtitles
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Generate ready-to-use subtitle files from a video or audio URL. Send media_url with an optional language, output format of srt or vtt, task of transcribe or translate, and a max_chars_per_line setting, and get back a properly timestamped, word-wrapped subtitles string you can drop straight into VLC, Premiere, or FFmpeg. Runs on Whisper v3 for the underlying transcription and checks media duration first, rejecting anything over 60 minutes. Use it as a subtitle generator, closed-caption creator, or SRT/VTT converter for video editing, accessibility captions, or localization workflows.

INPUT — request schema

property	type	description	req?
media_url	string	URL of the video/audio file to transcribe into subtitles.	required
format	string	Subtitle format: srt or vtt. Optional, default srt.	optional
language	string	Source language hint passed to Whisper (ISO code). Optional, auto-detected if omitted.	optional
task	string	transcribe (original language) or translate (to English). Optional, default transcribe.	optional
max_chars_per_line	number	Max characters per subtitle line before wrapping. Optional, 16-120, default 42.	optional

OUTPUT — response shape

field	type	description
subtitles	string	Full subtitle file content as a string.
format	string	Echo of the format used.
mime_type	string	MIME type for the subtitle format ('application/x-subrip' or 'text/vtt').
cue_count	number	Number of subtitle cues generated.
duration_seconds	number	Source media duration.
detected_languages	array	Languages auto-detected in the audio.
task	string	Echo of the task performed.
source_url	string	Echo of the input URL.

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.agentutility.ai/subtitles \
  -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 subtitles tool from your MCP-aware agent.

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: subtitlessrtvttcaptionswhispertranscription
env: FAL_KEY_TRANSCRIBE
methods: POST
cluster: mediakit
price: $0.08 USDC per call

ADJACENT — other endpoints in mediakit

endpoint	description	price
html-to-pdf	Render a live webpage as a PDF document.	$0.08
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
speaker-diarize	Transcribe audio or video and label who said what.	$0.10