Workflow Utilities Auto Subtitle
fal-ai/workflow-utilities/auto-subtitleEdit and transform video with Workflow Utilities Auto Subtitle from fal through one Spiral API key. It runs in the background and returns video. Pay as you go, with no subscription.
Pricing
$0.039 per minute.
Limits
- Runs
- In the background
- Returns
- video
- Longest queue wait
- 1 hour
- Run deadline
- 30 minutes
- Longest run, end to end
- 930 minutes
- Largest inline input
- 1 MB
- Largest input file
- 2 GB
- Largest output
- 5 GB
Input
| Field | Kind | Default | Description |
|---|---|---|---|
video_url required | URL or file | — | URL of the video file to add automatic subtitles to |
language | text | en | Language code for transcription (e.g., 'en', 'es', 'fr', 'de', 'it', 'pt', 'nl', 'ja', 'zh', 'ko') or 3-letter ISO code (e.g., 'eng', 'spa', 'fra') |
font_name | text | Montserrat | Any Google Font name from fonts.google.com (e.g., 'Montserrat', 'Poppins', 'BBH Sans Hegarty') |
font_size | number (whole) 20 to 150 | 100 | Font size for subtitles (TikTok style uses larger text) |
font_weight | one of normal, bold, black | bold | Font weight (TikTok style typically uses bold or black) |
font_color | one of white, black, red, green, blue, yellow, orange, purple, pink, brown, gray, cyan, magenta | white | Subtitle text color for non-active words |
highlight_color | one of white, black, red, green, blue, yellow, orange, purple, pink, brown, gray, cyan, magenta | purple | Color for the currently speaking word (karaoke-style highlight) |
stroke_width | number (whole) 0 to 10 | 3 | Text stroke/outline width in pixels (0 for no stroke) |
stroke_color | one of black, white, red, green, blue, yellow, orange, purple, pink, brown, gray, cyan, magenta | black | Text stroke/outline color |
background_color | one of black, white, red, green, blue, yellow, orange, purple, pink, brown, gray, cyan, magenta, none, transparent | none | Background color behind text ('none' or 'transparent' for no background) |
background_opacity | number 0 to 1 | 0 | Background opacity (0.0 = fully transparent, 1.0 = fully opaque) |
position | one of top, center, bottom | bottom | Vertical position of subtitles |
y_offset | number (whole) -200 to 200 | 75 | Vertical offset in pixels (positive = move down, negative = move up) |
words_per_subtitle | number (whole) 1 to 12 | 3 | Maximum number of words per subtitle segment. Use 1 for single-word display, 2-3 for short phrases, or 8-12 for full sentences. |
enable_animation | true or false | true | Enable animation effects for subtitles (bounce style entrance) |
Same request in code
curl https://api.spiral.ai/v1/runs \
-H "Authorization: Bearer $SPIRAL_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"provider": "fal",
"model": "fal-ai/workflow-utilities/auto-subtitle",
"input": {
"video_url": "https://v3b.fal.media/files/b/kangaroo/oUCiZjQwEy6bIQdPUSLDF_output.mp4"
}
}'Frequently asked questions
How much does Workflow Utilities Auto Subtitle cost?
$0.039 per minute. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.
How do I use Workflow Utilities Auto Subtitle through an API?
Send `POST /v1/runs` with `"provider": "fal"`, `"model": "fal-ai/workflow-utilities/auto-subtitle"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.
Do I need an account with fal to use Workflow Utilities Auto Subtitle?
No. Spiral runs it on its own fal account and charges your Spiral balance.
Can my AI agent use Workflow Utilities Auto Subtitle?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.