GET
/v1/schemas/fal/video/fal-ai/workflow-utilities/auto-subtitle
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above.Source trace0999ae50e50aa8472bacf9d14395a1be41be25de192532ab61ad52a66eefdd5b{
"fetchedAt": 1783329487,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
15 properties · 1 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| video_url* | string | URL of the video file to add automatic subtitles to | |
| font_size | integer | Font size for subtitles (TikTok style uses larger text) | 20 ≤ n ≤ 150 · default: 100 |
| background_color | enum | Background color behind text ('none' or 'transparent' for no background) | black | white | red | green | blue | yellow · +9 more · default: "none" |
| stroke_width | integer | Text stroke/outline width in pixels (0 for no stroke) | 0 ≤ n ≤ 10 · default: 3 |
| stroke_color | enum | Text stroke/outline color | black | white | red | green | blue | yellow · +7 more · default: "black" |
| font_weight | enum | Font weight (TikTok style typically uses bold or black) | normal | bold | black · default: "bold" |
| font_color | enum | Subtitle text color for non-active words | white | black | red | green | blue | yellow · +7 more · default: "white" |
| enable_animation | boolean | Enable animation effects for subtitles (bounce style entrance) | default: true |
| background_opacity | number | Background opacity (0.0 = fully transparent, 1.0 = fully opaque) | 0 ≤ n ≤ 1 · default: 0 |
| font_name | string | Any Google Font name from fonts.google.com (e.g., 'Montserrat', 'Poppins', 'BBH Sans Hegarty') | default: "Montserrat" |
| position | enum | Vertical position of subtitles | top | center | bottom · default: "bottom" |
| y_offset | integer | Vertical offset in pixels (positive = move down, negative = move up) | -200 ≤ n ≤ 200 · default: 75 |
| highlight_color | enum | Color for the currently speaking word (karaoke-style highlight) | white | black | red | green | blue | yellow · +7 more · default: "purple" |
| language | string | 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') | default: "en" |
| words_per_subtitle | integer | Maximum number of words per subtitle segment. Use 1 for single-word display, 2-3 for short phrases, or 8-12 for full sentences. | 1 ≤ n ≤ 12 · default: 3 |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/workflow-utilities/auto-subtitle","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}