WaveSpeedAI Subtitle OCR API

WaveSpeed AI Subtitle OCR

WaveSpeed AI Subtitle OCR extracts subtitles from a video using OCR and returns an SRT file URL. It is designed for subtitle recovery, caption extraction, accessibility workflows, localization prep, and video processing tasks where on-screen subtitles need to be converted into reusable subtitle files.

Why Choose This?

OCR-based subtitle extraction
Detect and extract burned-in or embedded on-screen subtitles from video frames.
Direct SRT output
Returns a subtitle file URL that can be reused in editing, publishing, or localization workflows.
Simple one-input workflow
Upload a video and generate subtitle output with minimal setup.
Useful for accessibility and repurposing
Supports caption recovery, subtitle reuse, localization prep, and content accessibility workflows.
Production-ready API
Suitable for subtitle extraction pipelines, social media processing, archive recovery, and post-production workflows.

Parameters

Parameter	Required	Description
video	Yes	Input video to analyze for subtitle extraction.

How to Use

Upload your video — provide the source video that contains visible subtitles.
Submit — run the OCR subtitle extraction request.
Download the result — use the returned SRT file URL in your editing, publishing, or localization workflow.

Example Use Case

Extract burned-in subtitles from a fitness or tutorial clip and reuse them as an editable SRT file for republishing or translation.

Output

Returns one SRT file URL in the standard WaveSpeed prediction response.

Pricing

Pricing is billed in started 60-second units.

Video Duration	Cost
1s–60s	$0.16
61s–120s	$0.32
121s–180s	$0.48
181s–240s	$0.64

Billing Rules

Base price is $0.16 per started minute
Videos shorter than 60 seconds are billed as 60 seconds
Billing rounds up in 60-second increments
Pricing depends only on video duration

Best Use Cases

Subtitle recovery — Extract hardcoded subtitles from existing videos.
Accessibility workflows — Recover captions for reuse in accessible publishing.
Localization prep — Turn on-screen subtitles into editable SRT assets for translation.
Archive processing — Recover subtitle text from older video assets.
Social media repurposing — Reuse subtitles from clips for editing or reposting.

Pro Tips

Use the cleanest source video possible for better OCR accuracy.
Videos with high subtitle contrast generally produce better extraction results.
Subtitle extraction works best when text is clearly visible and not heavily stylized.
Review the generated SRT before final use, especially for fast-moving or low-resolution footage.

Notes

video is required.
The model returns an SRT file URL, not a burned-in subtitle video.
Pricing is fixed at $0.16 per started minute, with a minimum billed length of 60 seconds.
Very small, low-contrast, stylized, or heavily animated subtitles may reduce OCR quality.

Related Models

VEED Subtitles — Add styled subtitles to a video with automatic transcription or imported SRT.
Other WaveSpeed subtitle and caption workflows — Useful when you need subtitle burn-in or subtitle styling instead of OCR extraction.

Subtitle Ocr API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/wavespeed-ai/subtitle-ocr with your input as JSON. The endpoint returns a prediction id; poll the prediction endpoint until status flips to completed, then read the output URL from data.outputs[0]. Examples for Subtitle Ocr below.

HTTP example

# Submit the prediction
curl -X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/subtitle-ocr" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "video": "https://example.com/your-input.mp4"
}'

# Response includes a prediction id. Poll for the result:
curl -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY"

# When status is "completed", read the output from data.outputs[0].

Node.js example

// npm install wavespeed
const WaveSpeed = require('wavespeed');

const client = new WaveSpeed(); // reads WAVESPEED_API_KEY from env

const result = await client.run("wavespeed-ai/subtitle-ocr", {
        "video": "https://example.com/your-input.mp4"
});

console.log(result.outputs[0]); // → URL of the generated output

Python example

# pip install wavespeed
import wavespeed

output = wavespeed.run(
    "wavespeed-ai/subtitle-ocr",
    {
    "video": "https://example.com/your-input.mp4"
}
)

print(output["outputs"][0])  # → URL of the generated output

Subtitle Ocr API — Frequently asked questions

What is the Subtitle Ocr API?

Subtitle Ocr is a WaveSpeedAI model for AI inference, exposed as a REST API on WaveSpeedAI. WaveSpeedAI Subtitle OCR is a fast AI subtitle extraction model that extracts subtitles from videos and returns an SRT file URL. Ready-to-use REST inference API for OCR-based subtitle extraction, video caption recovery, subtitle generation, content localization, accessibility workflows, social media videos, and professional video processing with simple integration, no coldstarts, and affordable pricing. You can call it programmatically or try it from the playground above.

How do I call the Subtitle Ocr API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID; poll the prediction endpoint until status flips to "completed", then read the output URL from the result. The playground generates a ready-to-paste code sample in Python, JavaScript, or cURL for whatever inputs you've set. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/wavespeed-ai/subtitle-ocr.

How much does Subtitle Ocr cost per run?

Subtitle Ocr starts at $0.16 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Subtitle Ocr accept?

Key inputs: `video`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/wavespeed-ai/subtitle-ocr.

How do I get started with the Subtitle Ocr API?

Sign up for a free WaveSpeedAI account to claim starter credits, copy your API key from /accesskey, then call the endpoint shown in the API tab of the playground. The playground also auto-generates a code sample in Python, JavaScript, or cURL for the parameters you've set.

Can I use Subtitle Ocr outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (WaveSpeedAI). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.

EsempiVedi tutto

Modelli correlati

README