# 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.

- Provider: fal
- Category: Video
- Runs: In the background
- Returns: video
- Tool id: `fal` / `fal-ai/workflow-utilities/auto-subtitle`
- Page: https://spiral.ai/tools/fal/fal-ai/workflow-utilities/auto-subtitle

## Pricing

$0.039 per minute.

## Limits

- 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 | Allowed | 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) |

## Example

```bash
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"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=fal&model=fal-ai%2Fworkflow-utilities%2Fauto-subtitle

## Common questions

### Workflow Utilities Auto Subtitle

**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.

