Spiral gives your agent every tool with one account. Browse the tools →

falVideoAvailable now

Workflow Utilities Auto Subtitle

fal-ai/workflow-utilities/auto-subtitle

Edit 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

FieldKindDefaultDescription
video_url requiredURL or file—

URL of the video file to add automatic subtitles to

languagetexten

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_nametextMontserrat

Any Google Font name from fonts.google.com (e.g., 'Montserrat', 'Poppins', 'BBH Sans Hegarty')

font_sizenumber (whole)
20 to 150
100

Font size for subtitles (TikTok style uses larger text)

font_weightone of
normal, bold, black
bold

Font weight (TikTok style typically uses bold or black)

font_colorone of
white, black, red, green, blue, yellow, orange, purple, pink, brown, gray, cyan, magenta
white

Subtitle text color for non-active words

highlight_colorone 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_widthnumber (whole)
0 to 10
3

Text stroke/outline width in pixels (0 for no stroke)

stroke_colorone of
black, white, red, green, blue, yellow, orange, purple, pink, brown, gray, cyan, magenta
black

Text stroke/outline color

background_colorone 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_opacitynumber
0 to 1
0

Background opacity (0.0 = fully transparent, 1.0 = fully opaque)

positionone of
top, center, bottom
bottom

Vertical position of subtitles

y_offsetnumber (whole)
-200 to 200
75

Vertical offset in pixels (positive = move down, negative = move up)

words_per_subtitlenumber (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_animationtrue or falsetrue

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.