{"version":"1","model":{"id":"fal-ai/workflow-utilities/auto-subtitle","name":"Auto Subtitle","kind":"video","availability":"available","available":true,"restricted":false,"api_key_only":false,"description":"Auto Subtitle burns styled captions directly into a video with karaoke-style highlighting, customizable fonts, colors, and animation.","pricing_note":"$0.03/min of input video.","categories":["tools"],"prompt_required":false,"prompt_supported":true,"supports":{"referenceVideo":true},"requires":{"referenceVideo":true},"aspect_ratios":[],"resolutions":[],"durations":[],"accepted_formats":{"video":["mp4","mov"]},"base_credits":1,"api_gross_margin_percent":20,"added_at":"2026-05-17","popularity_rank":432,"example_prompt":"Upload a video to auto-generate styled subtitles burned directly into the footage","preview":{"video":"https://cdn.artemotion.ai/file/artemotion-ai-bckt/model-previews/auto-subtitle-sm.mp4"},"schema_url":"/api/v1/models?id=fal-ai%2Fworkflow-utilities%2Fauto-subtitle","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fworkflow-utilities%2Fauto-subtitle","title":"Auto Subtitle generation request","description":"Request body accepted by POST /api/v1/generate for fal-ai/workflow-utilities/auto-subtitle.","type":"object","properties":{"model_id":{"type":"string","const":"fal-ai/workflow-utilities/auto-subtitle","description":"ArtEmotion model identifier."},"extra":{"type":"object","additionalProperties":true,"description":"Model-specific settings may also be nested here."},"max_credits":{"type":"number","minimum":1,"description":"Reject before submission if the estimated list price exceeds this cap."},"webhook_url":{"type":"string","format":"uri","maxLength":2048},"webhook_secret":{"type":"string","maxLength":512},"folder_id":{"type":"string"},"prompt":{"type":"string"},"position":{"title":"Position","description":"Vertical position of subtitles","default":"bottom","type":"string","enum":["top","center","bottom"]},"font_name":{"title":"Font Name","description":"Any Google Font name from fonts.google.com (e.g., 'Montserrat', 'Poppins', 'BBH Sans Hegarty')","default":"Montserrat","type":"string"},"background_color":{"title":"Background Color","description":"Background color behind text ('none' or 'transparent' for no background)","default":"none","type":"string","enum":["black","white","red","green","blue","yellow","orange","purple","pink","brown","gray","cyan","magenta","none","transparent"]},"background_opacity":{"title":"Background Opacity","description":"Background opacity (0.0 = fully transparent, 1.0 = fully opaque)","default":0,"type":"number","minimum":0,"maximum":1},"font_color":{"title":"Font Color","description":"Subtitle text color for non-active words","default":"white","type":"string","enum":["white","black","red","green","blue","yellow","orange","purple","pink","brown","gray","cyan","magenta"]},"language":{"title":"Language","description":"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","type":"string"},"y_offset":{"title":"Y Offset","description":"Vertical offset in pixels (positive = move down, negative = move up)","default":75,"type":"number","minimum":-200,"maximum":200,"multipleOf":1},"stroke_color":{"title":"Stroke Color","description":"Text stroke/outline color","default":"black","type":"string","enum":["black","white","red","green","blue","yellow","orange","purple","pink","brown","gray","cyan","magenta"]},"words_per_subtitle":{"title":"Words Per Subtitle","description":"Maximum number of words per subtitle segment. Use 1 for single-word display, 2-3 for short phrases, or 8-12 for full sentences.","default":3,"type":"number","minimum":1,"maximum":12,"multipleOf":1},"enable_animation":{"title":"Enable Animation","description":"Enable animation effects for subtitles (bounce style entrance)","default":true,"type":"boolean"},"stroke_width":{"title":"Stroke Width","description":"Text stroke/outline width in pixels (0 for no stroke)","default":3,"type":"number","minimum":0,"maximum":10,"multipleOf":1},"font_weight":{"title":"Font Weight","description":"Font weight (TikTok style typically uses bold or black)","default":"bold","type":"string","enum":["normal","bold","black"]},"font_size":{"title":"Font Size","description":"Font size for subtitles (TikTok style uses larger text)","default":100,"type":"number","minimum":20,"maximum":150,"multipleOf":1},"highlight_color":{"title":"Highlight Color","description":"Color for the currently speaking word (karaoke-style highlight)","default":"purple","type":"string","enum":["white","black","red","green","blue","yellow","orange","purple","pink","brown","gray","cyan","magenta"]},"video_url":{"type":"string","format":"uri"}},"required":["model_id","video_url"],"additionalProperties":false},"parameters":[{"key":"position","label":"Position","type":"select","default":"bottom","options":["top","center","bottom"],"description":"Vertical position of subtitles"},{"key":"font_name","label":"Font Name","type":"text","default":"Montserrat","description":"Any Google Font name from fonts.google.com (e.g., 'Montserrat', 'Poppins', 'BBH Sans Hegarty')"},{"key":"background_color","label":"Background Color","type":"select","default":"none","options":["black","white","red","green","blue","yellow","orange","purple","pink","brown","gray","cyan","magenta","none","transparent"],"description":"Background color behind text ('none' or 'transparent' for no background)"},{"key":"background_opacity","label":"Background Opacity","type":"number","default":0,"min":0,"max":1,"description":"Background opacity (0.0 = fully transparent, 1.0 = fully opaque)"},{"key":"font_color","label":"Font Color","type":"select","default":"white","options":["white","black","red","green","blue","yellow","orange","purple","pink","brown","gray","cyan","magenta"],"description":"Subtitle text color for non-active words"},{"key":"language","label":"Language","type":"text","default":"en","description":"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')"},{"key":"y_offset","label":"Y Offset","type":"number","default":75,"min":-200,"max":200,"step":1,"description":"Vertical offset in pixels (positive = move down, negative = move up)"},{"key":"stroke_color","label":"Stroke Color","type":"select","default":"black","options":["black","white","red","green","blue","yellow","orange","purple","pink","brown","gray","cyan","magenta"],"description":"Text stroke/outline color"},{"key":"words_per_subtitle","label":"Words Per Subtitle","type":"number","default":3,"min":1,"max":12,"step":1,"description":"Maximum number of words per subtitle segment. Use 1 for single-word display, 2-3 for short phrases, or 8-12 for full sentences."},{"key":"enable_animation","label":"Enable Animation","type":"toggle","default":true,"description":"Enable animation effects for subtitles (bounce style entrance)"},{"key":"stroke_width","label":"Stroke Width","type":"number","default":3,"min":0,"max":10,"step":1,"description":"Text stroke/outline width in pixels (0 for no stroke)"},{"key":"font_weight","label":"Font Weight","type":"select","default":"bold","options":["normal","bold","black"],"description":"Font weight (TikTok style typically uses bold or black)"},{"key":"font_size","label":"Font Size","type":"number","default":100,"min":20,"max":150,"step":1,"description":"Font size for subtitles (TikTok style uses larger text)"},{"key":"highlight_color","label":"Highlight Color","type":"select","default":"purple","options":["white","black","red","green","blue","yellow","orange","purple","pink","brown","gray","cyan","magenta"],"description":"Color for the currently speaking word (karaoke-style highlight)"}]}}