{"models":[{"endpoint_id":"alibaba/wan-3.0/reference-to-video","metadata":{"display_name":"Wan 3.0","category":"video-to-video","description":"Wan 3.0 is the latest generation AI video model, delivering enhanced motion smoothness, superior scene fidelity, and greater visual coherence.","status":"active","tags":["stylized","transform","lipsync"],"updated_at":"2026-10-20T22:08:25.620Z","is_favorited":null,"thumbnail_url":"https://v3b.fal.media/files/b/0aa4e980/FY0Yw0B-_KVknj6qtv5sp.jpg","model_url":"https://fal.run/alibaba/wan-3.0/reference-to-video","license_type":"commercial","date":"2026-08-03T23:56:31.060Z","group":{"key":"Wan30","label":"Reference to Video"},"highlighted":false,"kind":"inference","pinned":false},"retires_at":null,"replacement":null,"openapi":{"openapi":"3.1.0","info":{"title":"Queue OpenAPI for alibaba/wan-3.0/reference-to-video","version":"1.0.0","description":"The OpenAPI schema for the alibaba/wan-3.0/reference-to-video queue.","x-fal-metadata":{"endpointId":"alibaba/wan-3.0/reference-to-video","category":"video-to-video","thumbnailUrl":"https://v3b.fal.media/files/b/0aa4e980/FY0Yw0B-_KVknj6qtv5sp.jpg","playgroundUrl":"https://fal.ai/models/alibaba/wan-3.0/reference-to-video","documentationUrl":"https://fal.ai/models/alibaba/wan-3.0/reference-to-video/api","about":"Generate a video from reference images, videos, audio, a document or a page."}},"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Fal Key"}},"schemas":{"QueueStatus":{"type":"object","properties":{"status":{"type":"string","enum":["IN_QUEUE","IN_PROGRESS","COMPLETED"]},"request_id":{"type":"string","description":"The request id."},"response_url":{"type":"string","description":"The response url."},"status_url":{"type":"string","description":"The status url."},"cancel_url":{"type":"string","description":"The cancel url."},"logs":{"type":"object","description":"The logs.","additionalProperties":true},"metrics":{"type":"object","description":"The metrics.","additionalProperties":true},"queue_position":{"type":"integer","description":"The queue position."}},"required":["status","request_id"]},"Wan30ReferenceToVideoInput":{"x-fal-order-properties":["prompt","resolution","aspect_ratio","duration","audio","enable_prompt_expansion","enable_thinking","seed","enable_safety_checker","reference_image_urls","reference_video_urls","reference_audio_urls","file_url","web_url"],"title":"Wan30ReferenceToVideoInput","type":"object","properties":{"reference_video_urls":{"items":{"type":"string"},"description":"Up to 5 reference video URLs totaling at most 15 seconds. Each clip must be at least 16 fps. Input video duration is billed in addition to output duration.","title":"Reference Video Urls","maxItems":5,"type":"array"},"prompt":{"description":"Text prompt directing how the reference media is used. Reference media can be addressed positionally, e.g. 'the subject in Image 1 walks past Video 1'.","anyOf":[{"maxLength":20000,"type":"string"},{"type":"null"}],"title":"Prompt"},"reference_image_urls":{"items":{"type":"string"},"description":"Up to 10 reference image URLs.","title":"Reference Image Urls","maxItems":10,"type":"array"},"file_url":{"description":"Document URL to base the video on. Requires enable_thinking=true.","anyOf":[{"type":"string"},{"type":"null"}],"title":"File Url"},"enable_thinking":{"description":"Enable enhanced reasoning before generation.","title":"Enable Thinking","type":"boolean","default":false},"aspect_ratio":{"description":"Output aspect ratio, or adaptive selection.","title":"Aspect Ratio","type":"string","default":"adaptive","enum":["adaptive","16:9","4:3","1:1","3:4","9:16"]},"reference_audio_urls":{"items":{"type":"string"},"description":"Up to 5 reference audio URLs totaling at most 15 seconds.","title":"Reference Audio Urls","maxItems":5,"type":"array"},"enable_safety_checker":{"description":"Enable content moderation for input and output. Disabling it requires account authorization; unauthorized requests are always checked.","title":"Enable Safety Checker","type":"boolean","default":true},"web_url":{"description":"Public webpage URL to base the video on. Requires enable_thinking=true. Only pages that do not require login can be read.","anyOf":[{"type":"string"},{"type":"null"}],"title":"Web Url"},"seed":{"anyOf":[{"maximum":2147483647,"minimum":0,"type":"integer"},{"type":"null"}],"title":"Seed"},"audio":{"description":"Include generated audio.","title":"Audio","type":"boolean","default":true},"resolution":{"description":"Output video resolution tier.","title":"Resolution","type":"string","default":"1080p","enum":["480p","720p","1080p"]},"duration":{"description":"Output duration in seconds. Set to null for smart duration, which lets the model pick a length from the prompt and reference media.","anyOf":[{"maximum":30,"minimum":2,"type":"integer"},{"type":"null"}],"title":"Duration","default":5},"enable_prompt_expansion":{"description":"Enable intelligent prompt rewriting. Disabling it can save roughly 20-60 seconds of latency but is likely to degrade generation quality.","title":"Enable Prompt Expansion","type":"boolean","default":true}}},"Wan30ReferenceToVideoOutput":{"x-fal-order-properties":["video","seed","duration","actual_prompt"],"title":"Wan30Output","type":"object","properties":{"video":{"description":"The generated video file.","$ref":"#/components/schemas/VideoFile"},"seed":{"description":"The seed used for generation.","title":"Seed","type":"integer"},"duration":{"description":"Generated video duration in seconds.","title":"Duration","type":"number"},"actual_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Actual Prompt"}},"required":["video","seed","duration"]},"VideoFile":{"x-fal-order-properties":["url","content_type","file_name","file_size","width","height","fps","duration","num_frames"],"title":"VideoFile","type":"object","properties":{"fps":{"description":"The FPS of the video","anyOf":[{"type":"number"},{"type":"null"}],"title":"Fps"},"file_name":{"description":"The name of the file. It will be auto-generated if not provided.","examples":["z9RV14K95DvU.png"],"title":"File Name","anyOf":[{"type":"string"},{"type":"null"}]},"num_frames":{"description":"The number of frames in the video","anyOf":[{"type":"integer"},{"type":"null"}],"title":"Num Frames"},"url":{"description":"The URL where the file can be downloaded from.","title":"Url","type":"string"},"duration":{"description":"The duration of the video","anyOf":[{"type":"number"},{"type":"null"}],"title":"Duration"},"width":{"description":"The width of the video","anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width"},"file_size":{"description":"The size of the file in bytes.","examples":[4404019],"title":"File Size","anyOf":[{"type":"integer"},{"type":"null"}]},"height":{"description":"The height of the video","anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height"},"content_type":{"description":"The mime type of the file.","examples":["image/png"],"title":"Content Type","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["url"]}}},"paths":{"/alibaba/wan-3.0/reference-to-video/requests/{request_id}/status":{"get":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}},{"name":"logs","in":"query","required":false,"schema":{"type":"number","description":"Whether to include logs (`1`) in the response or not (`0`)."}}],"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/alibaba/wan-3.0/reference-to-video/requests/{request_id}/cancel":{"put":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}}],"responses":{"200":{"description":"The request was cancelled.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the request was cancelled successfully."}}}}}}}}},"/alibaba/wan-3.0/reference-to-video":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Wan30ReferenceToVideoInput"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/alibaba/wan-3.0/reference-to-video/requests/{request_id}":{"get":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}}],"responses":{"200":{"description":"Result of the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Wan30ReferenceToVideoOutput"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}},{"endpoint_id":"kling/v4/reference-to-video","metadata":{"display_name":"Kling 4.0 Reference to Video","category":"video-to-video","description":"Kling 4.0 generates videos from text prompts and image or video references at 720p or 1080p, with durations from 3 to 30 seconds and per-shot prompts.  ","status":"active","tags":["reference-to-video","multi-shot","image-reference","video-reference","kling"],"updated_at":"2026-10-23T16:50:56.400Z","is_favorited":null,"thumbnail_url":"https://v3b.fal.media/files/b/0aaea014/-781kCHOSCW9vaMcaPfMS.jpg","model_url":"https://fal.run/kling/v4/reference-to-video","license_type":"commercial","date":"2026-10-16T15:21:08.011Z","group":{"key":"kling-v4","label":"Reference to Video"},"highlighted":false,"kind":"inference","pinned":false},"retires_at":null,"replacement":null,"openapi":{"openapi":"3.1.0","info":{"title":"Queue OpenAPI for kling/v4/reference-to-video","version":"1.0.0","description":"The OpenAPI schema for the kling/v4/reference-to-video queue.","x-fal-metadata":{"endpointId":"kling/v4/reference-to-video","category":"video-to-video","thumbnailUrl":"https://v3b.fal.media/files/b/0aaea014/-781kCHOSCW9vaMcaPfMS.jpg","playgroundUrl":"https://fal.ai/models/kling/v4/reference-to-video","documentationUrl":"https://fal.ai/models/kling/v4/reference-to-video/api","about":"Generate videos with Kling 4.0 Reference to Video"}},"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Fal Key"}},"schemas":{"QueueStatus":{"type":"object","properties":{"status":{"type":"string","enum":["IN_QUEUE","IN_PROGRESS","COMPLETED"]},"request_id":{"type":"string","description":"The request id."},"response_url":{"type":"string","description":"The response url."},"status_url":{"type":"string","description":"The status url."},"cancel_url":{"type":"string","description":"The cancel url."},"logs":{"type":"object","description":"The logs.","additionalProperties":true},"metrics":{"type":"object","description":"The metrics.","additionalProperties":true},"queue_position":{"type":"integer","description":"The queue position."}},"required":["status","request_id"]},"V4ReferenceToVideoInput":{"properties":{"image_urls":{"description":"Reference images, referenced as @Image1, @Image2, ... (max 10).","title":"Image Urls","examples":[null],"anyOf":[{"maxItems":10,"type":"array","items":{"_fal_ui_field":"image","type":"string","limit_description":"Max file size: 30.0MB, Min width: 300px, Min height: 300px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Timeout: 20.0s","x-fal":{"max_file_size":31457280,"min_aspect_ratio":0.4,"min_height":300,"timeout":20,"min_width":300,"max_aspect_ratio":2.5},"ui":{"field":"image"}}},{"type":"null"}]},"resolution":{"enum":["720p","1080p"],"description":"Output resolution.","title":"Resolution","type":"string","default":"1080p"},"middle_image_urls":{"description":"Optional ordered keyframes between the first and last frames (max 8). Count toward the image reference limit.","title":"Middle Image Urls","examples":[null],"anyOf":[{"maxItems":8,"type":"array","items":{"_fal_ui_field":"image","type":"string","limit_description":"Max file size: 30.0MB, Min width: 300px, Min height: 300px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Timeout: 20.0s","x-fal":{"max_file_size":31457280,"min_aspect_ratio":0.4,"min_height":300,"timeout":20,"min_width":300,"max_aspect_ratio":2.5},"ui":{"field":"image"}}},{"type":"null"}]},"duration":{"maximum":30,"description":"Video duration in seconds (3-30).","title":"Duration","type":"integer","default":5,"minimum":3},"elements":{"description":"Characters/objects, referenced as @Element1, @Element2, ... (max 7). Up to 3 elements may carry a voice_id and up to 3 may be video elements.","title":"Elements","examples":[null],"anyOf":[{"maxItems":7,"type":"array","items":{"$ref":"#/components/schemas/KlingV4Element"}},{"type":"null"}]},"voice_ids":{"description":"Voices referenced in the prompt as @Voice1, @Voice2, ... (max 3, including voices bound to elements). Create one with https://fal.ai/models/fal-ai/kling-video/create-voice","title":"Voice Ids","examples":[null],"anyOf":[{"maxItems":3,"type":"array","items":{"type":"string"}},{"type":"null"}]},"aspect_ratio":{"enum":["auto","16:9","9:16","1:1","21:9"],"description":"Aspect ratio of the generated video. 'auto' adapts it to the references.","title":"Aspect Ratio","type":"string","default":"16:9"},"prompt":{"description":"Text prompt. Reference inputs as @Image1, @Video1, @Element1, etc. Either prompt or multi_prompt must be provided.","title":"Prompt","examples":["@Element1 and @Element2 are having dinner at the table in @Image1"],"anyOf":[{"maxLength":26000,"type":"string"},{"type":"null"}]},"video_urls":{"description":"Reference videos (3-30s each, 30s combined with element videos), referenced as @Video1, @Video2, ... (max 5).","title":"Video Urls","examples":[null],"anyOf":[{"maxItems":5,"type":"array","items":{"_fal_ui_field":"video","type":"string","limit_description":"Max file size: 300.0MB, Min width: 700px, Min height: 700px, Max width: 4553px, Max height: 4553px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Min duration: 3.0s, Max duration: 30.05s, Min FPS: 23.9, Max FPS: 60.05, Timeout: 30.0s","x-fal":{"max_height":4553,"min_width":700,"min_aspect_ratio":0.4,"min_fps":23.9,"timeout":30,"max_fps":60.05,"max_aspect_ratio":2.5,"max_width":4553,"max_file_size":314572800,"max_duration":30.05,"min_height":700,"min_duration":3},"ui":{"field":"video"}}},{"type":"null"}]},"start_image_url":{"description":"Optional image to use as the first frame. Counts toward the image reference limit.","title":"Start Image Url","anyOf":[{"x-fal":{"max_file_size":31457280,"min_aspect_ratio":0.4,"min_height":300,"timeout":20,"min_width":300,"max_aspect_ratio":2.5},"limit_description":"Max file size: 30.0MB, Min width: 300px, Min height: 300px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Timeout: 20.0s","type":"string","ui":{"field":"image"}},{"type":"null"}]},"end_image_url":{"description":"Optional image to use as the last frame. Counts toward the image reference limit.","title":"End Image Url","anyOf":[{"x-fal":{"max_file_size":31457280,"min_aspect_ratio":0.4,"min_height":300,"timeout":20,"min_width":300,"max_aspect_ratio":2.5},"limit_description":"Max file size: 30.0MB, Min width: 300px, Min height: 300px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Timeout: 20.0s","type":"string","ui":{"field":"image"}},{"type":"null"}]},"multi_prompt":{"description":"Per-shot prompts for multi-shot generation. The video duration is the sum of the shot durations.","title":"Multi Prompt","examples":[null],"anyOf":[{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/KlingV4Shot"}},{"type":"null"}]}},"title":"ReferenceToVideoInput","type":"object","x-fal-order-properties":["prompt","multi_prompt","duration","start_image_url","middle_image_urls","end_image_url","image_urls","video_urls","elements","voice_ids","resolution","aspect_ratio"]},"V4ReferenceToVideoOutput":{"properties":{"video":{"description":"The generated video.","examples":[{"file_size":3020124,"file_name":"output.mp4","content_type":"video/mp4","url":"https://v3b.fal.media/files/b/0aac4497/-fHk6MiMZhLy2FncCbyM7_clip_reference.mp4"}],"$ref":"#/components/schemas/File"}},"required":["video"],"title":"ReferenceToVideoOutput","x-fal-order-properties":["video"],"type":"object"},"KlingV4Element":{"properties":{"video_url":{"description":"A video of the element, used instead of images (3-8s).","title":"Video Url","anyOf":[{"x-fal":{"max_height":4553,"min_width":700,"min_aspect_ratio":0.4,"min_fps":23.9,"timeout":30,"max_fps":60.05,"max_aspect_ratio":2.5,"max_width":4553,"max_file_size":314572800,"max_duration":8.05,"min_height":700,"min_duration":3},"limit_description":"Max file size: 300.0MB, Min width: 700px, Min height: 700px, Max width: 4553px, Max height: 4553px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Min duration: 3.0s, Max duration: 8.05s, Min FPS: 23.9, Max FPS: 60.05, Timeout: 30.0s","type":"string","ui":{"field":"video"}},{"type":"null"}]},"frontal_image_url":{"description":"The frontal image of the element (main view).","title":"Frontal Image Url","anyOf":[{"x-fal":{"max_file_size":31457280,"min_aspect_ratio":0.4,"min_height":300,"timeout":20,"min_width":300,"max_aspect_ratio":2.5},"limit_description":"Max file size: 30.0MB, Min width: 300px, Min height: 300px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Timeout: 20.0s","type":"string","ui":{"field":"image"}},{"type":"null"}]},"voice_id":{"description":"Voice bound to this element. Create one with https://fal.ai/models/fal-ai/kling-video/create-voice","title":"Voice Id","anyOf":[{"type":"string"},{"type":"null"}]},"reference_image_urls":{"description":"Additional views of the element from different angles (1-3).","title":"Reference Image Urls","anyOf":[{"maxItems":3,"type":"array","items":{"_fal_ui_field":"image","type":"string","limit_description":"Max file size: 30.0MB, Min width: 300px, Min height: 300px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Timeout: 20.0s","x-fal":{"max_file_size":31457280,"min_aspect_ratio":0.4,"min_height":300,"timeout":20,"min_width":300,"max_aspect_ratio":2.5},"ui":{"field":"image"}}},{"type":"null"}]}},"title":"KlingV4Element","type":"object","x-fal-order-properties":["frontal_image_url","reference_image_urls","video_url","voice_id"]},"KlingV4Shot":{"properties":{"prompt":{"maxLength":512,"description":"The prompt for this shot.","title":"Prompt","minLength":1,"type":"string"},"duration":{"description":"Shot duration in seconds.","title":"Duration","type":"integer","default":5,"minimum":1,"maximum":30}},"required":["prompt"],"title":"KlingV4Shot","x-fal-order-properties":["prompt","duration"],"type":"object"},"File":{"properties":{"file_size":{"description":"The size of the file in bytes.","title":"File Size","examples":[4404019],"anyOf":[{"type":"integer"},{"type":"null"}]},"file_name":{"description":"The name of the file. It will be auto-generated if not provided.","title":"File Name","examples":["z9RV14K95DvU.png"],"anyOf":[{"type":"string"},{"type":"null"}]},"content_type":{"description":"The mime type of the file.","title":"Content Type","examples":["image/png"],"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"description":"The URL where the file can be downloaded from.","title":"Url","type":"string"}},"required":["url"],"title":"File","x-fal-order-properties":["url","content_type","file_name","file_size"],"type":"object"}}},"paths":{"/kling/v4/reference-to-video/requests/{request_id}/status":{"get":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}},{"name":"logs","in":"query","required":false,"schema":{"type":"number","description":"Whether to include logs (`1`) in the response or not (`0`)."}}],"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/kling/v4/reference-to-video/requests/{request_id}/cancel":{"put":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}}],"responses":{"200":{"description":"The request was cancelled.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the request was cancelled successfully."}}}}}}}}},"/kling/v4/reference-to-video":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/V4ReferenceToVideoInput"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/kling/v4/reference-to-video/requests/{request_id}":{"get":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}}],"responses":{"200":{"description":"Result of the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V4ReferenceToVideoOutput"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}},{"endpoint_id":"fal-ai/sync-lipsync/v3","metadata":{"display_name":"sync-3 Lipsync","category":"video-to-video","description":"sync-3 most powerful lipsync model yet, featuring native visual intelligence for professional-quality video.","status":"active","tags":["stylized","transform","lipsync"],"updated_at":"2026-06-22T17:36:40.628Z","is_favorited":null,"thumbnail_url":"https://v3b.fal.media/files/b/0a9460ff/hUjOvIu-6_JSEZr9SeFN5_8f82f538ee3246f3942ba081b0e28d3c.jpg","model_url":"https://fal.run/fal-ai/sync-lipsync/v3","license_type":"commercial","date":"2026-04-06T11:59:40.659Z","group":{"key":"sync-3","label":"Video to Video"},"highlighted":false,"kind":"inference","pinned":false},"retires_at":null,"replacement":null,"openapi":{"openapi":"3.1.0","info":{"title":"Queue OpenAPI for fal-ai/sync-lipsync/v3","version":"1.0.0","description":"The OpenAPI schema for the fal-ai/sync-lipsync/v3 queue.","x-fal-metadata":{"endpointId":"fal-ai/sync-lipsync/v3","category":"video-to-video","thumbnailUrl":"https://v3b.fal.media/files/b/0a9460ff/hUjOvIu-6_JSEZr9SeFN5_8f82f538ee3246f3942ba081b0e28d3c.jpg","playgroundUrl":"https://fal.ai/models/fal-ai/sync-lipsync/v3","documentationUrl":"https://fal.ai/models/fal-ai/sync-lipsync/v3/api","about":"Lipsync Request V3"}},"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Fal Key"}},"schemas":{"QueueStatus":{"type":"object","properties":{"status":{"type":"string","enum":["IN_QUEUE","IN_PROGRESS","COMPLETED"]},"request_id":{"type":"string","description":"The request id."},"response_url":{"type":"string","description":"The response url."},"status_url":{"type":"string","description":"The status url."},"cancel_url":{"type":"string","description":"The cancel url."},"logs":{"type":"object","description":"The logs.","additionalProperties":true},"metrics":{"type":"object","description":"The metrics.","additionalProperties":true},"queue_position":{"type":"integer","description":"The queue position."}},"required":["status","request_id"]},"SyncLipsyncV3Input":{"properties":{"audio_url":{"examples":["https://fal.media/files/lion/vyFWygmZsIZlUO4s0nr2n.wav"],"title":"Audio Url","description":"URL of the input audio","type":"string"},"enable_safety_checker":{"default":true,"title":"Enable Safety Checker","type":"boolean"},"options":{"anyOf":[{"$ref":"#/components/schemas/Sync3GenerationOptions"},{"type":"null"}],"description":"Additional Sync.so generation options. If options.sync_mode is set, it overrides the top-level sync_mode field."},"sync_mode":{"default":"cut_off","title":"Sync Mode","enum":["cut_off","loop","bounce","silence","remap"],"description":"Lipsync mode when audio and video durations are out of sync.","type":"string"},"video_url":{"examples":["https://v3.fal.media/files/tiger/IugLCDJRIoGqvqTa-EJTr_3wg74vCqyNuQ-IiBd77MM_output.mp4"],"title":"Video Url","description":"URL of the input video","type":"string"}},"title":"Sync3Input","x-fal-order-properties":["enable_safety_checker","video_url","audio_url","sync_mode","options"],"type":"object","required":["video_url","audio_url"]},"SyncLipsyncV3Output":{"properties":{"video":{"examples":[{"url":"https://v3b.fal.media/files/b/0a93c312/TqKMiLtCcTKWSeAWXJRD0_output.mp4"}],"description":"The generated video","$ref":"#/components/schemas/File"}},"title":"Sync3Output","x-fal-order-properties":["video"],"type":"object","required":["video"]},"Sync3GenerationOptions":{"properties":{"temperature":{"anyOf":[{"minimum":0,"type":"number","maximum":1},{"type":"null"}],"title":"Temperature","description":"Controls how expressive lipsync can be; 0 is least expressive, 1 is most expressive. Sync.so handles this natively for sync-3, so this option is ignored by sync-3."},"prompt":{"anyOf":[{"enum":["happy","sad","angry","disgusted","surprised","neutral"],"type":"string"},{"type":"null"}],"title":"Prompt","description":"Emotion prompt for generation. This is a Sync.so option primarily used by react-1."},"model_mode":{"anyOf":[{"enum":["lips","face","head","lipsync","emotion","talking_head"],"type":"string"},{"type":"null"}],"title":"Model Mode","description":"Edit region for the model. This is a Sync.so option primarily used by react-1."},"active_speaker_detection":{"anyOf":[{"$ref":"#/components/schemas/Sync3ActiveSpeakerDetection"},{"type":"null"}],"description":"Active speaker detection configuration for videos with multiple people."},"sync_mode":{"anyOf":[{"enum":["cut_off","loop","bounce","silence","remap"],"type":"string"},{"type":"null"}],"title":"Sync Mode","description":"Defines how to handle duration mismatches between video and audio inputs. Overrides the top-level sync_mode when provided."},"occlusion_detection_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Occlusion Detection Enabled","description":"Whether to detect occlusion during generation. Sync.so handles this automatically for sync-3, so this option is ignored by sync-3."}},"title":"Sync3GenerationOptions","x-fal-order-properties":["sync_mode","model_mode","prompt","temperature","active_speaker_detection","occlusion_detection_enabled"],"type":"object"},"File":{"properties":{"file_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"examples":[4404019],"title":"File Size","description":"The size of the file in bytes."},"url":{"title":"Url","description":"The URL where the file can be downloaded from.","type":"string"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"examples":["image/png"],"title":"Content Type","description":"The mime type of the file."},"file_name":{"anyOf":[{"type":"string"},{"type":"null"}],"examples":["z9RV14K95DvU.png"],"title":"File Name","description":"The name of the file. It will be auto-generated if not provided."}},"title":"File","x-fal-order-properties":["url","content_type","file_name","file_size"],"type":"object","required":["url"]},"Sync3ActiveSpeakerDetection":{"properties":{"bounding_boxes_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bounding Boxes Url","description":"URL to a JSON file containing per-frame bounding boxes."},"coordinates":{"anyOf":[{"maxItems":2,"minItems":2,"items":{"type":"integer"},"type":"array"},{"type":"null"}],"title":"Coordinates","description":"Reference point [x, y] on the speaker's face in frame_number."},"auto_detect":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Auto Detect","description":"Whether to automatically detect and apply generation to the active speaker."},"face_image":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Face Image","description":"Base64 encoded face image for manual speaker selection."},"bounding_boxes":{"anyOf":[{"items":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}]},"type":"array"},{"type":"null"}],"title":"Bounding Boxes","description":"Per-frame bounding boxes [x1, y1, x2, y2] for the detected face."},"v3":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"V3","description":"Whether to use Sync.so's active speaker detection v3."},"use_v2":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Use V2","description":"Deprecated Sync.so option for active speaker detection v2."},"frame_number":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"title":"Frame Number","description":"Frame index for manual speaker selection coordinates."}},"title":"Sync3ActiveSpeakerDetection","x-fal-order-properties":["auto_detect","v3","use_v2","frame_number","coordinates","bounding_boxes","bounding_boxes_url","face_image"],"type":"object"}}},"paths":{"/fal-ai/sync-lipsync/v3/requests/{request_id}/status":{"get":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}},{"name":"logs","in":"query","required":false,"schema":{"type":"number","description":"Whether to include logs (`1`) in the response or not (`0`)."}}],"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/fal-ai/sync-lipsync/v3/requests/{request_id}/cancel":{"put":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}}],"responses":{"200":{"description":"The request was cancelled.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the request was cancelled successfully."}}}}}}}}},"/fal-ai/sync-lipsync/v3":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyncLipsyncV3Input"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/fal-ai/sync-lipsync/v3/requests/{request_id}":{"get":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}}],"responses":{"200":{"description":"Result of the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyncLipsyncV3Output"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}},{"endpoint_id":"fal-ai/kling-video/o3/pro/video-to-video/edit","metadata":{"display_name":"Kling O3 Edit Video [Pro]","category":"video-to-video","description":"Edit videos using Kling O3 from Kling Team!","status":"active","tags":["video-to-video"],"updated_at":"2026-10-20T22:31:55.808Z","is_favorited":null,"thumbnail_url":"https://v3b.fal.media/files/b/0a8cfcd0/jgn9feXep4nJXWf0tg1cf_6867c6921b6a4015a1906c8e02a7ef9d.jpg","model_url":"https://fal.run/fal-ai/kling-video/o3/pro/video-to-video/edit","license_type":"commercial","date":"2026-02-04T15:48:44.935Z","group":{"key":"kling-o3","label":"Edit Video (pro)"},"highlighted":false,"kind":"inference","pinned":false},"retires_at":null,"replacement":null,"openapi":{"openapi":"3.1.0","info":{"title":"Queue OpenAPI for fal-ai/kling-video/o3/pro/video-to-video/edit","version":"1.0.0","description":"The OpenAPI schema for the fal-ai/kling-video/o3/pro/video-to-video/edit queue.","x-fal-metadata":{"endpointId":"fal-ai/kling-video/o3/pro/video-to-video/edit","category":"video-to-video","thumbnailUrl":"https://v3b.fal.media/files/b/0a8cfcd0/jgn9feXep4nJXWf0tg1cf_6867c6921b6a4015a1906c8e02a7ef9d.jpg","playgroundUrl":"https://fal.ai/models/fal-ai/kling-video/o3/pro/video-to-video/edit","documentationUrl":"https://fal.ai/models/fal-ai/kling-video/o3/pro/video-to-video/edit/api","about":"O3 Pro Video To Video Edit"}},"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Fal Key"}},"schemas":{"QueueStatus":{"type":"object","properties":{"status":{"type":"string","enum":["IN_QUEUE","IN_PROGRESS","COMPLETED"]},"request_id":{"type":"string","description":"The request id."},"response_url":{"type":"string","description":"The response url."},"status_url":{"type":"string","description":"The status url."},"cancel_url":{"type":"string","description":"The cancel url."},"logs":{"type":"object","description":"The logs.","additionalProperties":true},"metrics":{"type":"object","description":"The metrics.","additionalProperties":true},"queue_position":{"type":"integer","description":"The queue position."}},"required":["status","request_id"]},"KlingVideoO3ProVideoToVideoEditInput":{"properties":{"image_urls":{"description":"Reference images for style/appearance. Reference in prompt as @Image1, @Image2, etc. Maximum 4 total (elements + reference images) when using video.","title":"Image Urls","examples":[["https://storage.googleapis.com/falserverless/example_inputs/kling-o3/pro-v2v-edit/image_url1.jpg"]],"anyOf":[{"type":"array","items":{"_fal_ui_field":"image","type":"string","limit_description":"Max file size: 50.0MB, Min width: 300px, Min height: 300px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Timeout: 20.0s","x-fal":{"max_file_size":52428800,"min_aspect_ratio":0.4,"min_height":300,"timeout":20,"min_width":300,"max_aspect_ratio":2.5},"ui":{"field":"image"}}},{"type":"null"}]},"prompt":{"maxLength":2500,"description":"Text prompt for video generation. Reference video as @Video1.","title":"Prompt","examples":["Change environment to be fully snow as @Image1. Replace animal with @Element1"],"type":"string"},"video_url":{"description":"Reference video URL. Only .mp4/.mov formats, 3-15s duration, 720-3840px resolution, max 200MB.","title":"Video Url","limit_description":"Max file size: 200.0MB, Min width: 720px, Min height: 720px, Max width: 3840px, Max height: 3840px, Min duration: 3.0s, Max duration: 15.05s, Min FPS: 23.0, Max FPS: 60.0, Timeout: 30.0s","examples":["https://storage.googleapis.com/falserverless/example_inputs/kling-o3/pro-v2v-edit/video_reference.mp4"],"type":"string","_fal_ui_field":"video","x-fal":{"max_height":3840,"min_width":720,"min_fps":23,"timeout":30,"max_fps":60,"max_width":3840,"max_file_size":209715200,"max_duration":15.05,"min_height":720,"min_duration":3}},"shot_type":{"description":"The type of multi-shot video generation.","const":"customize","title":"Shot Type","default":"customize","type":"string"},"keep_audio":{"description":"Whether to keep the original audio from the reference video. ","title":"Keep Audio","type":"boolean","default":true},"elements":{"description":"Elements (characters/objects) to include. Reference in prompt as @Element1, @Element2.","title":"Elements","examples":[[{"frontal_image_url":"https://storage.googleapis.com/falserverless/example_inputs/kling-o3/pro-v2v-edit/element1_front.png","reference_image_urls":["https://storage.googleapis.com/falserverless/example_inputs/kling-o3/pro-v2v-edit/element1_reference1.png"]}]],"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/KlingV3ImageElementInput"}},{"type":"null"}]},"enable_safety_checker":{"description":"Disabling safety checks requires account authorization; unauthorized requests are always checked.","title":"Enable Safety Checker","type":"boolean","default":true}},"required":["prompt","video_url"],"title":"O3ProEditVideoV2VInput","x-fal-order-properties":["enable_safety_checker","prompt","video_url","image_urls","keep_audio","elements","shot_type"],"type":"object"},"KlingVideoO3ProVideoToVideoEditOutput":{"properties":{"video":{"description":"The generated video.","examples":[{"file_size":4322769,"file_name":"output.mp4","content_type":"video/mp4","url":"https://storage.googleapis.com/falserverless/example_outputs/kling-o3/pro-v2v-edit/output.mp4"}],"$ref":"#/components/schemas/File"}},"required":["video"],"title":"O3ProEditV2VOutput","x-fal-order-properties":["video"],"type":"object"},"KlingV3ImageElementInput":{"properties":{"frontal_image_url":{"description":"The frontal image of the element (main view).","title":"Frontal Image Url","anyOf":[{"x-fal":{"max_file_size":52428800,"min_aspect_ratio":0.4,"min_height":300,"timeout":20,"min_width":300,"max_aspect_ratio":2.5},"limit_description":"Max file size: 50.0MB, Min width: 300px, Min height: 300px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Timeout: 20.0s","type":"string","ui":{"field":"image"}},{"type":"null"}]},"reference_image_urls":{"description":"Additional reference images from different angles. 1-3 images supported. At least one image is required.","title":"Reference Image Urls","anyOf":[{"type":"array","items":{"_fal_ui_field":"image","type":"string","limit_description":"Max file size: 50.0MB, Min width: 300px, Min height: 300px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Timeout: 20.0s","x-fal":{"max_file_size":52428800,"min_aspect_ratio":0.4,"min_height":300,"timeout":20,"min_width":300,"max_aspect_ratio":2.5},"ui":{"field":"image"}}},{"type":"null"}]}},"title":"KlingV3ImageElementInput","type":"object","x-fal-order-properties":["frontal_image_url","reference_image_urls"]},"File":{"properties":{"file_size":{"description":"The size of the file in bytes.","title":"File Size","examples":[4404019],"anyOf":[{"type":"integer"},{"type":"null"}]},"file_name":{"description":"The name of the file. It will be auto-generated if not provided.","title":"File Name","examples":["z9RV14K95DvU.png"],"anyOf":[{"type":"string"},{"type":"null"}]},"content_type":{"description":"The mime type of the file.","title":"Content Type","examples":["image/png"],"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"description":"The URL where the file can be downloaded from.","title":"Url","type":"string"}},"required":["url"],"title":"File","x-fal-order-properties":["url","content_type","file_name","file_size"],"type":"object"}}},"paths":{"/fal-ai/kling-video/o3/pro/video-to-video/edit/requests/{request_id}/status":{"get":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}},{"name":"logs","in":"query","required":false,"schema":{"type":"number","description":"Whether to include logs (`1`) in the response or not (`0`)."}}],"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/fal-ai/kling-video/o3/pro/video-to-video/edit/requests/{request_id}/cancel":{"put":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}}],"responses":{"200":{"description":"The request was cancelled.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the request was cancelled successfully."}}}}}}}}},"/fal-ai/kling-video/o3/pro/video-to-video/edit":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KlingVideoO3ProVideoToVideoEditInput"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/fal-ai/kling-video/o3/pro/video-to-video/edit/requests/{request_id}":{"get":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}}],"responses":{"200":{"description":"Result of the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KlingVideoO3ProVideoToVideoEditOutput"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}},{"endpoint_id":"fal-ai/sync-lipsync/v2","metadata":{"display_name":"Sync Lipsync 2.0","category":"video-to-video","description":"Generate realistic lipsync animations from audio using advanced algorithms for high-quality synchronization with Sync Lipsync 2.0 model","status":"active","tags":["animation","lip sync"],"updated_at":"2026-10-07T21:54:13.785Z","is_favorited":null,"thumbnail_url":"https://v3b.fal.media/files/b/0a9f9a45/-kfzjmJkk91iujX9QQTT3_nAfB0uuc.png","model_url":"https://fal.run/fal-ai/sync-lipsync/v2","license_type":"commercial","date":"2025-04-01T18:57:06.699Z","group":{"key":"sync-lipsync","label":"Lipsync 2.0"},"highlighted":false,"kind":"inference","pinned":false},"retires_at":null,"replacement":null,"openapi":{"openapi":"3.1.0","info":{"title":"Queue OpenAPI for fal-ai/sync-lipsync/v2","version":"1.0.0","description":"The OpenAPI schema for the fal-ai/sync-lipsync/v2 queue.","x-fal-metadata":{"endpointId":"fal-ai/sync-lipsync/v2","category":"video-to-video","thumbnailUrl":"https://v3b.fal.media/files/b/0a9f9a45/-kfzjmJkk91iujX9QQTT3_nAfB0uuc.png","playgroundUrl":"https://fal.ai/models/fal-ai/sync-lipsync/v2","documentationUrl":"https://fal.ai/models/fal-ai/sync-lipsync/v2/api","about":"Lipsync Request V2"}},"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Fal Key"}},"schemas":{"QueueStatus":{"type":"object","properties":{"status":{"type":"string","enum":["IN_QUEUE","IN_PROGRESS","COMPLETED"]},"request_id":{"type":"string","description":"The request id."},"response_url":{"type":"string","description":"The response url."},"status_url":{"type":"string","description":"The status url."},"cancel_url":{"type":"string","description":"The cancel url."},"logs":{"type":"object","description":"The logs.","additionalProperties":true},"metrics":{"type":"object","description":"The metrics.","additionalProperties":true},"queue_position":{"type":"integer","description":"The queue position."}},"required":["status","request_id"]},"SyncLipsyncV2Input":{"properties":{"audio_url":{"examples":["https://fal.media/files/lion/vyFWygmZsIZlUO4s0nr2n.wav"],"title":"Audio Url","description":"URL of the input audio","type":"string"},"enable_safety_checker":{"default":true,"title":"Enable Safety Checker","type":"boolean"},"model":{"default":"lipsync-2","title":"Model","enum":["lipsync-2","lipsync-2-pro"],"description":"The model to use for lipsyncing. `lipsync-2-pro` will cost roughly 1.67 times as much as `lipsync-2` for the same duration.","type":"string"},"sync_mode":{"default":"cut_off","title":"Sync Mode","enum":["cut_off","loop","bounce","silence","remap"],"description":"Lipsync mode when audio and video durations are out of sync.","type":"string"},"video_url":{"examples":["https://v3.fal.media/files/tiger/IugLCDJRIoGqvqTa-EJTr_3wg74vCqyNuQ-IiBd77MM_output.mp4"],"title":"Video Url","description":"URL of the input video","type":"string"}},"title":"LipSyncV2Input","x-fal-order-properties":["enable_safety_checker","model","video_url","audio_url","sync_mode"],"type":"object","required":["video_url","audio_url"]},"SyncLipsyncV2Output":{"properties":{"video":{"examples":[{"url":"https://v3.fal.media/files/kangaroo/WIhlgDEJbccwGwAsvL3vz_output.mp4"}],"description":"The generated video","$ref":"#/components/schemas/File"}},"title":"LipSyncV2Output","x-fal-order-properties":["video"],"type":"object","required":["video"]},"File":{"properties":{"file_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"examples":[4404019],"title":"File Size","description":"The size of the file in bytes."},"url":{"title":"Url","description":"The URL where the file can be downloaded from.","type":"string"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"examples":["image/png"],"title":"Content Type","description":"The mime type of the file."},"file_name":{"anyOf":[{"type":"string"},{"type":"null"}],"examples":["z9RV14K95DvU.png"],"title":"File Name","description":"The name of the file. It will be auto-generated if not provided."}},"title":"File","x-fal-order-properties":["url","content_type","file_name","file_size"],"type":"object","required":["url"]}}},"paths":{"/fal-ai/sync-lipsync/v2/requests/{request_id}/status":{"get":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}},{"name":"logs","in":"query","required":false,"schema":{"type":"number","description":"Whether to include logs (`1`) in the response or not (`0`)."}}],"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/fal-ai/sync-lipsync/v2/requests/{request_id}/cancel":{"put":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}}],"responses":{"200":{"description":"The request was cancelled.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the request was cancelled successfully."}}}}}}}}},"/fal-ai/sync-lipsync/v2":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyncLipsyncV2Input"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/fal-ai/sync-lipsync/v2/requests/{request_id}":{"get":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}}],"responses":{"200":{"description":"Result of the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyncLipsyncV2Output"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}},{"endpoint_id":"fal-ai/bytedance-upscaler/upscale/video","metadata":{"display_name":"Bytedance Upscaler Upscale Video","category":"video-to-video","description":"Upscale videos with Bytedance's video upscaler.","status":"active","tags":["upscaler","video","bytedance"],"updated_at":"2026-11-05T16:59:52.838Z","is_favorited":null,"thumbnail_url":"https://v3b.fal.media/files/b/kangaroo/LorVpq4fAORdnn1YHRM-A_d801feeaa1764cefb7de0c3381ecaf84.jpg","model_url":"https://fal.run/fal-ai/bytedance-upscaler/upscale/video","license_type":"commercial","date":"2025-10-31T16:15:01.762Z","highlighted":false,"kind":"inference","pinned":false},"retires_at":null,"replacement":null,"openapi":{"openapi":"3.1.0","info":{"title":"Queue OpenAPI for fal-ai/bytedance-upscaler/upscale/video","version":"1.0.0","description":"The OpenAPI schema for the fal-ai/bytedance-upscaler/upscale/video queue.","x-fal-metadata":{"endpointId":"fal-ai/bytedance-upscaler/upscale/video","category":"video-to-video","thumbnailUrl":"https://v3b.fal.media/files/b/kangaroo/LorVpq4fAORdnn1YHRM-A_d801feeaa1764cefb7de0c3381ecaf84.jpg","playgroundUrl":"https://fal.ai/models/fal-ai/bytedance-upscaler/upscale/video","documentationUrl":"https://fal.ai/models/fal-ai/bytedance-upscaler/upscale/video/api","about":"Enhance and upscale a video using BytePlus VOD."}},"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Fal Key"}},"schemas":{"QueueStatus":{"type":"object","properties":{"status":{"type":"string","enum":["IN_QUEUE","IN_PROGRESS","COMPLETED"]},"request_id":{"type":"string","description":"The request id."},"response_url":{"type":"string","description":"The response url."},"status_url":{"type":"string","description":"The status url."},"cancel_url":{"type":"string","description":"The cancel url."},"logs":{"type":"object","description":"The logs.","additionalProperties":true},"metrics":{"type":"object","description":"The metrics.","additionalProperties":true},"queue_position":{"type":"integer","description":"The queue position."}},"required":["status","request_id"]},"BytedanceUpscalerUpscaleVideoInput":{"required":["video_url"],"x-fal-order-properties":["video_url","target_resolution","target_fps","enhancement_preset","enhancement_tier","scale_ratio","fidelity","bit_depth"],"title":"UpscaleInput","type":"object","properties":{"target_resolution":{"title":"Target Resolution","enum":["1080p","2k","4k","6k","8k"],"type":"string","description":"The target resolution of the video to upscale.","default":"1080p"},"fidelity":{"title":"Fidelity","enum":["high","medium"],"type":"string","description":"The enhancement intensity. 'high' applies mild enhancement while keeping visual texture close to the source video. 'medium' provides a balanced image quality enhancement.","default":"high"},"target_fps":{"title":"Target Fps","type":"number","minimum":24,"maximum":120,"description":"The target frame rate of the enhanced video in frames per second.","default":30},"scale_ratio":{"title":"Scale Ratio","description":"The scaling ratio for the output video resolution. When set, overrides target_resolution and scales the input resolution by this factor (e.g., 2.0 doubles the resolution). Range: 1.1 to 10.0. Please note that this is valid only up to 4k resolution, and trying to scale beyond 4k will result in an error. (4k is defined as having atotal pixel count of 3840x2160).","anyOf":[{"type":"number","minimum":1.1,"maximum":10},{"type":"null"}]},"video_url":{"title":"Video Url","type":"string","examples":["https://storage.googleapis.com/falserverless/example_inputs/bytedance_video_upscaler_input.mp4"],"description":"The URL of the video to upscale."},"enhancement_tier":{"title":"Enhancement Tier","enum":["fast","standard","pro"],"type":"string","description":"The enhancement quality tier. 'fast' provides essential upscaling with good speed, 'standard' uses adaptive algorithms for better visual texture, 'pro' uses large-model restoration for cinematic quality (longer processing time), and 10 times the cost of `standard` and `fast`.","default":"standard"},"enhancement_preset":{"title":"Enhancement Preset","enum":["general","ugc","short_series","aigc","old_film"],"type":"string","description":"The enhancement preset optimized for specific video scenarios. 'general' is a general-purpose template, 'ugc' targets user-generated short videos, 'short_series' is for short dramas, 'aigc' is for AI-generated content, and 'old_film' is for classic film restoration.","default":"general"},"bit_depth":{"title":"Bit Depth","enum":[8,10,12],"type":"integer","description":"The color bit depth of the output video. 10-bit and 12-bit output require the Pro enhancement tier.","default":8}}},"BytedanceUpscalerUpscaleVideoOutput":{"required":["video","duration"],"x-fal-order-properties":["video","duration"],"title":"UpscaleOutput","type":"object","properties":{"duration":{"title":"Duration","type":"number","description":"Duration of audio input/video output as used for billing."},"video":{"$ref":"#/components/schemas/File","examples":[{"url":"https://storage.googleapis.com/falserverless/example_outputs/bytedance_video_upscaler_output.mp4"}],"description":"Generated video file"}}},"File":{"required":["url"],"x-fal-order-properties":["url","content_type","file_name","file_size"],"title":"File","type":"object","properties":{"url":{"title":"Url","type":"string","description":"The URL where the file can be downloaded from."},"content_type":{"title":"Content Type","examples":["image/png"],"description":"The mime type of the file.","anyOf":[{"type":"string"},{"type":"null"}]},"file_name":{"title":"File Name","examples":["z9RV14K95DvU.png"],"description":"The name of the file. It will be auto-generated if not provided.","anyOf":[{"type":"string"},{"type":"null"}]},"file_size":{"title":"File Size","examples":[4404019],"description":"The size of the file in bytes.","anyOf":[{"type":"integer"},{"type":"null"}]}}}}},"paths":{"/fal-ai/bytedance-upscaler/upscale/video/requests/{request_id}/status":{"get":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}},{"name":"logs","in":"query","required":false,"schema":{"type":"number","description":"Whether to include logs (`1`) in the response or not (`0`)."}}],"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/fal-ai/bytedance-upscaler/upscale/video/requests/{request_id}/cancel":{"put":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}}],"responses":{"200":{"description":"The request was cancelled.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the request was cancelled successfully."}}}}}}}}},"/fal-ai/bytedance-upscaler/upscale/video":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BytedanceUpscalerUpscaleVideoInput"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/fal-ai/bytedance-upscaler/upscale/video/requests/{request_id}":{"get":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}}],"responses":{"200":{"description":"Result of the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BytedanceUpscalerUpscaleVideoOutput"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}},{"endpoint_id":"kling/v4/video-to-video/edit","metadata":{"display_name":"Kling 4.0 Video Editing","category":"video-to-video","description":"Kling 4.0 edits an input video using text instructions and optional image references, producing 3 to 30-second videos at 720p or 1080p.  ","status":"active","tags":["video-to-video","video-editing","image-reference","kling"],"updated_at":"2026-10-23T16:50:29.059Z","is_favorited":null,"thumbnail_url":"https://v3b.fal.media/files/b/0aaea01a/b-K4ZK92VhCWa6fE4LMS9.jpg","model_url":"https://fal.run/kling/v4/video-to-video/edit","license_type":"commercial","date":"2026-10-16T15:21:55.287Z","group":{"key":"kling-v4","label":"Video Editing"},"highlighted":false,"kind":"inference","pinned":false},"retires_at":null,"replacement":null,"openapi":{"openapi":"3.1.0","info":{"title":"Queue OpenAPI for kling/v4/video-to-video/edit","version":"1.0.0","description":"The OpenAPI schema for the kling/v4/video-to-video/edit queue.","x-fal-metadata":{"endpointId":"kling/v4/video-to-video/edit","category":"video-to-video","thumbnailUrl":"https://v3b.fal.media/files/b/0aaea01a/b-K4ZK92VhCWa6fE4LMS9.jpg","playgroundUrl":"https://fal.ai/models/kling/v4/video-to-video/edit","documentationUrl":"https://fal.ai/models/kling/v4/video-to-video/edit/api","about":"Edit a video with Kling 4.0 Omni Video (the input is the base video)"}},"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Fal Key"}},"schemas":{"QueueStatus":{"type":"object","properties":{"status":{"type":"string","enum":["IN_QUEUE","IN_PROGRESS","COMPLETED"]},"request_id":{"type":"string","description":"The request id."},"response_url":{"type":"string","description":"The response url."},"status_url":{"type":"string","description":"The status url."},"cancel_url":{"type":"string","description":"The cancel url."},"logs":{"type":"object","description":"The logs.","additionalProperties":true},"metrics":{"type":"object","description":"The metrics.","additionalProperties":true},"queue_position":{"type":"integer","description":"The queue position."}},"required":["status","request_id"]},"V4VideoToVideoEditInput":{"properties":{"image_urls":{"description":"Reference images, referenced as @Image1, @Image2, ...","title":"Image Urls","examples":[null],"anyOf":[{"maxItems":10,"type":"array","items":{"_fal_ui_field":"image","type":"string","limit_description":"Max file size: 30.0MB, Min width: 300px, Min height: 300px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Timeout: 20.0s","x-fal":{"max_file_size":31457280,"min_aspect_ratio":0.4,"min_height":300,"timeout":20,"min_width":300,"max_aspect_ratio":2.5},"ui":{"field":"image"}}},{"type":"null"}]},"resolution":{"enum":["720p","1080p"],"description":"Output resolution.","title":"Resolution","type":"string","default":"1080p"},"middle_image_urls":{"description":"Optional ordered keyframes between the first and last frames (max 8). Count toward the image reference limit.","title":"Middle Image Urls","examples":[null],"anyOf":[{"maxItems":8,"type":"array","items":{"_fal_ui_field":"image","type":"string","limit_description":"Max file size: 30.0MB, Min width: 300px, Min height: 300px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Timeout: 20.0s","x-fal":{"max_file_size":31457280,"min_aspect_ratio":0.4,"min_height":300,"timeout":20,"min_width":300,"max_aspect_ratio":2.5},"ui":{"field":"image"}}},{"type":"null"}]},"aspect_ratio":{"description":"Aspect ratio of the edited video. 'auto' adapts it to the inputs. Omit to follow the source video.","title":"Aspect Ratio","examples":[null],"anyOf":[{"enum":["auto","16:9","9:16","1:1","21:9"],"type":"string"},{"type":"null"}]},"elements":{"description":"Characters/objects, referenced as @Element1, @Element2, ... (max 7). Up to 3 elements may carry a voice_id and up to 3 may be video elements.","title":"Elements","examples":[null],"anyOf":[{"maxItems":7,"type":"array","items":{"$ref":"#/components/schemas/KlingV4Element"}},{"type":"null"}]},"voice_ids":{"description":"Voices referenced in the prompt as @Voice1, @Voice2, ... (max 3, including voices bound to elements). Create one with https://fal.ai/models/fal-ai/kling-video/create-voice","title":"Voice Ids","examples":[null],"anyOf":[{"maxItems":3,"type":"array","items":{"type":"string"}},{"type":"null"}]},"duration":{"description":"Output duration in seconds (3-30). Defaults to the source video's length.","title":"Duration","examples":[null],"anyOf":[{"type":"integer","minimum":3,"maximum":30},{"type":"null"}]},"prompt":{"maxLength":26000,"description":"Edit instruction. Reference the source video as @Video1.","title":"Prompt","examples":["Change the background to a tropical island at sunset."],"type":"string"},"video_url":{"description":"The video to edit (3-30s), referenced as @Video1.\n\nMax file size: 300.0MB, Min width: 700px, Min height: 700px, Max width: 4553px, Max height: 4553px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Min duration: 3.0s, Max duration: 30.05s, Min FPS: 23.9, Max FPS: 60.05, Timeout: 30.0s","x-fal":{"max_height":4553,"min_width":700,"min_aspect_ratio":0.4,"min_fps":23.9,"timeout":30,"max_fps":60.05,"max_aspect_ratio":2.5,"max_width":4553,"max_file_size":314572800,"max_duration":30.05,"min_height":700,"min_duration":3},"title":"Video Url","type":"string"},"video_urls":{"description":"Reference videos, referenced as @Video2, @Video3, ... (max 4). The source, reference and element videos must total at most 30s.","title":"Video Urls","examples":[null],"anyOf":[{"maxItems":4,"type":"array","items":{"_fal_ui_field":"video","type":"string","limit_description":"Max file size: 300.0MB, Min width: 700px, Min height: 700px, Max width: 4553px, Max height: 4553px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Min duration: 3.0s, Max duration: 30.05s, Min FPS: 23.9, Max FPS: 60.05, Timeout: 30.0s","x-fal":{"max_height":4553,"min_width":700,"min_aspect_ratio":0.4,"min_fps":23.9,"timeout":30,"max_fps":60.05,"max_aspect_ratio":2.5,"max_width":4553,"max_file_size":314572800,"max_duration":30.05,"min_height":700,"min_duration":3},"ui":{"field":"video"}}},{"type":"null"}]},"start_image_url":{"description":"Optional image to use as the first frame. Counts toward the image reference limit.","title":"Start Image Url","anyOf":[{"x-fal":{"max_file_size":31457280,"min_aspect_ratio":0.4,"min_height":300,"timeout":20,"min_width":300,"max_aspect_ratio":2.5},"limit_description":"Max file size: 30.0MB, Min width: 300px, Min height: 300px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Timeout: 20.0s","type":"string","ui":{"field":"image"}},{"type":"null"}]},"end_image_url":{"description":"Optional image to use as the last frame. Counts toward the image reference limit.","title":"End Image Url","anyOf":[{"x-fal":{"max_file_size":31457280,"min_aspect_ratio":0.4,"min_height":300,"timeout":20,"min_width":300,"max_aspect_ratio":2.5},"limit_description":"Max file size: 30.0MB, Min width: 300px, Min height: 300px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Timeout: 20.0s","type":"string","ui":{"field":"image"}},{"type":"null"}]}},"required":["prompt","video_url"],"title":"EditVideoInput","x-fal-order-properties":["prompt","video_url","image_urls","video_urls","elements","voice_ids","start_image_url","middle_image_urls","end_image_url","duration","resolution","aspect_ratio"],"type":"object"},"V4VideoToVideoEditOutput":{"properties":{"video":{"description":"The generated video.","examples":[{"file_size":3478246,"file_name":"output.mp4","content_type":"video/mp4","url":"https://v3b.fal.media/files/b/0aac4496/QzdMSy4uSKyFfMjtU65MA_clip_text.mp4"}],"$ref":"#/components/schemas/File"}},"required":["video"],"title":"VideoOutput","x-fal-order-properties":["video"],"type":"object"},"KlingV4Element":{"properties":{"video_url":{"description":"A video of the element, used instead of images (3-8s).","title":"Video Url","anyOf":[{"x-fal":{"max_height":4553,"min_width":700,"min_aspect_ratio":0.4,"min_fps":23.9,"timeout":30,"max_fps":60.05,"max_aspect_ratio":2.5,"max_width":4553,"max_file_size":314572800,"max_duration":8.05,"min_height":700,"min_duration":3},"limit_description":"Max file size: 300.0MB, Min width: 700px, Min height: 700px, Max width: 4553px, Max height: 4553px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Min duration: 3.0s, Max duration: 8.05s, Min FPS: 23.9, Max FPS: 60.05, Timeout: 30.0s","type":"string","ui":{"field":"video"}},{"type":"null"}]},"frontal_image_url":{"description":"The frontal image of the element (main view).","title":"Frontal Image Url","anyOf":[{"x-fal":{"max_file_size":31457280,"min_aspect_ratio":0.4,"min_height":300,"timeout":20,"min_width":300,"max_aspect_ratio":2.5},"limit_description":"Max file size: 30.0MB, Min width: 300px, Min height: 300px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Timeout: 20.0s","type":"string","ui":{"field":"image"}},{"type":"null"}]},"voice_id":{"description":"Voice bound to this element. Create one with https://fal.ai/models/fal-ai/kling-video/create-voice","title":"Voice Id","anyOf":[{"type":"string"},{"type":"null"}]},"reference_image_urls":{"description":"Additional views of the element from different angles (1-3).","title":"Reference Image Urls","anyOf":[{"maxItems":3,"type":"array","items":{"_fal_ui_field":"image","type":"string","limit_description":"Max file size: 30.0MB, Min width: 300px, Min height: 300px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Timeout: 20.0s","x-fal":{"max_file_size":31457280,"min_aspect_ratio":0.4,"min_height":300,"timeout":20,"min_width":300,"max_aspect_ratio":2.5},"ui":{"field":"image"}}},{"type":"null"}]}},"title":"KlingV4Element","type":"object","x-fal-order-properties":["frontal_image_url","reference_image_urls","video_url","voice_id"]},"File":{"properties":{"file_size":{"description":"The size of the file in bytes.","title":"File Size","examples":[4404019],"anyOf":[{"type":"integer"},{"type":"null"}]},"file_name":{"description":"The name of the file. It will be auto-generated if not provided.","title":"File Name","examples":["z9RV14K95DvU.png"],"anyOf":[{"type":"string"},{"type":"null"}]},"content_type":{"description":"The mime type of the file.","title":"Content Type","examples":["image/png"],"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"description":"The URL where the file can be downloaded from.","title":"Url","type":"string"}},"required":["url"],"title":"File","x-fal-order-properties":["url","content_type","file_name","file_size"],"type":"object"}}},"paths":{"/kling/v4/video-to-video/edit/requests/{request_id}/status":{"get":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}},{"name":"logs","in":"query","required":false,"schema":{"type":"number","description":"Whether to include logs (`1`) in the response or not (`0`)."}}],"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/kling/v4/video-to-video/edit/requests/{request_id}/cancel":{"put":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}}],"responses":{"200":{"description":"The request was cancelled.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the request was cancelled successfully."}}}}}}}}},"/kling/v4/video-to-video/edit":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/V4VideoToVideoEditInput"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/kling/v4/video-to-video/edit/requests/{request_id}":{"get":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}}],"responses":{"200":{"description":"Result of the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V4VideoToVideoEditOutput"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}},{"endpoint_id":"alibaba/wan-3.0-prime/reference-to-video","metadata":{"display_name":"Wan 3.0 Prime","category":"video-to-video","description":"Wan 3.0 Prime Reference-to-Video combines reference images, videos, and audio into a unified video with fast generation and strong multimodal coherence. It follows character identity, visual style, movement, and sound cues across references to create controlled, consistent, and production-ready results.","status":"active","tags":["reference","video"],"updated_at":"2026-10-20T22:54:59.893Z","is_favorited":null,"thumbnail_url":"https://v3b.fal.media/files/b/0aa79464/AfVcXUCY_wyxlQVsAGpx2.jpg","model_url":"https://fal.run/alibaba/wan-3.0-prime/reference-to-video","license_type":"commercial","date":"2026-08-24T04:43:49.156Z","group":{"key":"Wan30prime","label":"Reference to Video"},"highlighted":false,"kind":"inference","pinned":false},"retires_at":null,"replacement":null,"openapi":{"openapi":"3.1.0","info":{"title":"Queue OpenAPI for alibaba/wan-3.0-prime/reference-to-video","version":"1.0.0","description":"The OpenAPI schema for the alibaba/wan-3.0-prime/reference-to-video queue.","x-fal-metadata":{"endpointId":"alibaba/wan-3.0-prime/reference-to-video","category":"video-to-video","thumbnailUrl":"https://v3b.fal.media/files/b/0aa79464/AfVcXUCY_wyxlQVsAGpx2.jpg","playgroundUrl":"https://fal.ai/models/alibaba/wan-3.0-prime/reference-to-video","documentationUrl":"https://fal.ai/models/alibaba/wan-3.0-prime/reference-to-video/api","about":"Generate a video from reference media with Wan 3.0 Prime."}},"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Fal Key"}},"schemas":{"QueueStatus":{"type":"object","properties":{"status":{"type":"string","enum":["IN_QUEUE","IN_PROGRESS","COMPLETED"]},"request_id":{"type":"string","description":"The request id."},"response_url":{"type":"string","description":"The response url."},"status_url":{"type":"string","description":"The status url."},"cancel_url":{"type":"string","description":"The cancel url."},"logs":{"type":"object","description":"The logs.","additionalProperties":true},"metrics":{"type":"object","description":"The metrics.","additionalProperties":true},"queue_position":{"type":"integer","description":"The queue position."}},"required":["status","request_id"]},"Wan30PrimeReferenceToVideoInput":{"properties":{"enable_prompt_expansion":{"title":"Enable Prompt Expansion","type":"boolean","description":"Enable intelligent prompt rewriting. Disabling it can save roughly 20-60 seconds of latency but is likely to degrade generation quality.","default":true},"seed":{"title":"Seed","anyOf":[{"type":"integer","minimum":0,"maximum":2147483647},{"type":"null"}]},"duration":{"default":5,"title":"Duration","description":"Output duration in seconds. Set to null for smart duration, which lets the model pick a length from the prompt and reference media.","anyOf":[{"type":"integer","minimum":2,"maximum":30},{"type":"null"}]},"prompt":{"title":"Prompt","description":"Text prompt directing how the reference media is used. Reference media can be addressed positionally, e.g. 'the subject in Image 1 walks past Video 1'.","anyOf":[{"maxLength":20000,"type":"string"},{"type":"null"}]},"reference_audio_urls":{"maxItems":5,"type":"array","description":"Up to 5 reference audio URLs totaling at most 15 seconds.","title":"Reference Audio Urls","items":{"type":"string"}},"web_url":{"title":"Web Url","description":"Public webpage URL to base the video on. Requires enable_thinking=true. Only pages that do not require login can be read.","anyOf":[{"type":"string"},{"type":"null"}]},"enable_safety_checker":{"title":"Enable Safety Checker","type":"boolean","description":"Enable content moderation for input and output. Disabling it requires account authorization; unauthorized requests are always checked.","default":true},"aspect_ratio":{"title":"Aspect Ratio","enum":["adaptive","16:9","4:3","1:1","3:4","9:16"],"type":"string","description":"Output aspect ratio, or adaptive selection.","default":"adaptive"},"audio":{"title":"Audio","type":"boolean","description":"Include generated audio.","default":true},"enable_thinking":{"title":"Enable Thinking","type":"boolean","description":"Enable enhanced reasoning before generation.","default":false},"resolution":{"title":"Resolution","enum":["480p","720p","1080p"],"type":"string","description":"Output video resolution tier.","default":"1080p"},"reference_video_urls":{"maxItems":5,"type":"array","description":"Up to 5 reference video URLs totaling at most 15 seconds. Each clip must be at least 16 fps. Input video duration is billed in addition to output duration.","title":"Reference Video Urls","items":{"type":"string"}},"reference_image_urls":{"maxItems":10,"type":"array","description":"Up to 10 reference image URLs.","title":"Reference Image Urls","items":{"type":"string"}},"file_url":{"title":"File Url","description":"Document URL to base the video on. Requires enable_thinking=true.","anyOf":[{"type":"string"},{"type":"null"}]}},"x-fal-order-properties":["prompt","resolution","aspect_ratio","duration","audio","enable_prompt_expansion","enable_thinking","seed","enable_safety_checker","reference_image_urls","reference_video_urls","reference_audio_urls","file_url","web_url"],"type":"object","title":"Wan30ReferenceToVideoInput"},"Wan30PrimeReferenceToVideoOutput":{"required":["video","seed","duration"],"properties":{"seed":{"title":"Seed","type":"integer","description":"The seed used for generation."},"duration":{"title":"Duration","type":"number","description":"Generated video duration in seconds."},"actual_prompt":{"title":"Actual Prompt","anyOf":[{"type":"string"},{"type":"null"}]},"video":{"$ref":"#/components/schemas/VideoFile","description":"The generated video file."}},"x-fal-order-properties":["video","seed","duration","actual_prompt"],"type":"object","title":"Wan30Output"},"VideoFile":{"required":["url"],"properties":{"fps":{"title":"Fps","description":"The FPS of the video","anyOf":[{"type":"number"},{"type":"null"}]},"duration":{"title":"Duration","description":"The duration of the video","anyOf":[{"type":"number"},{"type":"null"}]},"width":{"title":"Width","description":"The width of the video","anyOf":[{"type":"integer"},{"type":"null"}]},"file_size":{"title":"File Size","description":"The size of the file in bytes.","examples":[4404019],"anyOf":[{"type":"integer"},{"type":"null"}]},"url":{"title":"Url","type":"string","description":"The URL where the file can be downloaded from."},"content_type":{"title":"Content Type","description":"The mime type of the file.","examples":["image/png"],"anyOf":[{"type":"string"},{"type":"null"}]},"file_name":{"title":"File Name","description":"The name of the file. It will be auto-generated if not provided.","examples":["z9RV14K95DvU.png"],"anyOf":[{"type":"string"},{"type":"null"}]},"num_frames":{"title":"Num Frames","description":"The number of frames in the video","anyOf":[{"type":"integer"},{"type":"null"}]},"height":{"title":"Height","description":"The height of the video","anyOf":[{"type":"integer"},{"type":"null"}]}},"x-fal-order-properties":["url","content_type","file_name","file_size","width","height","fps","duration","num_frames"],"type":"object","title":"VideoFile"}}},"paths":{"/alibaba/wan-3.0-prime/reference-to-video/requests/{request_id}/status":{"get":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}},{"name":"logs","in":"query","required":false,"schema":{"type":"number","description":"Whether to include logs (`1`) in the response or not (`0`)."}}],"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/alibaba/wan-3.0-prime/reference-to-video/requests/{request_id}/cancel":{"put":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}}],"responses":{"200":{"description":"The request was cancelled.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the request was cancelled successfully."}}}}}}}}},"/alibaba/wan-3.0-prime/reference-to-video":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Wan30PrimeReferenceToVideoInput"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/alibaba/wan-3.0-prime/reference-to-video/requests/{request_id}":{"get":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}}],"responses":{"200":{"description":"Result of the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Wan30PrimeReferenceToVideoOutput"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}},{"endpoint_id":"topaz/upscale/video/precision","metadata":{"display_name":"Topaz Upscale Video Precision","category":"video-to-video","description":"Professional video upscaling powered by Topaz Labs. Precision models (Proteus, Artemis, Iris, Dione, Theia, Gaia, Rhea) enhance footage up to 4x while staying faithful to the source. Best for clean, natural upscales of real-world footage.","status":"active","tags":["upscale","video"],"updated_at":"2026-10-20T21:56:47.299Z","is_favorited":null,"thumbnail_url":"https://v3b.fal.media/files/b/0aa5f1ec/6RruEcb1mzuNDFal3KsPz.jpg","model_url":"https://fal.run/topaz/upscale/video/precision","license_type":"commercial","date":"2026-08-11T19:10:25.098Z","group":{"key":"topaz-upscale","label":"Upscale Video Precision"},"highlighted":false,"kind":"inference","pinned":false},"retires_at":null,"replacement":null,"openapi":{"openapi":"3.1.0","info":{"title":"Queue OpenAPI for topaz/upscale/video/precision","version":"1.0.0","description":"The OpenAPI schema for the topaz/upscale/video/precision queue.","x-fal-metadata":{"endpointId":"topaz/upscale/video/precision","category":"video-to-video","thumbnailUrl":"https://v3b.fal.media/files/b/0aa5f1ec/6RruEcb1mzuNDFal3KsPz.jpg","playgroundUrl":"https://fal.ai/models/topaz/upscale/video/precision","documentationUrl":"https://fal.ai/models/topaz/upscale/video/precision/api","about":"# Topaz Precision Video Upscale\n\nClassic (non-generative) upscaling and enhancement that stays\nfaithful to the source.\n\n## Models\n- **Proteus** — the default choice for most real-world footage.\n- **Artemis HQ / MQ / LQ** — denoise and sharpen, for progressively\nmore degraded sources.\n- **Gaia HQ / CG** — refinement for high-quality footage and CG\nrenders.\n- **Gaia 2** — frame-by-frame 2x upscaling for animation and motion\ngraphics (billed at half price).\n- **Rhea** — maximum fine detail via an internal 4x pass.\n\nVideos are limited to 5 minutes. `target_fps` enables Apollo frame\ninterpolation only when it differs from the source FPS."}},"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Fal Key"}},"schemas":{"QueueStatus":{"type":"object","properties":{"status":{"type":"string","enum":["IN_QUEUE","IN_PROGRESS","COMPLETED"]},"request_id":{"type":"string","description":"The request id."},"response_url":{"type":"string","description":"The response url."},"status_url":{"type":"string","description":"The status url."},"cancel_url":{"type":"string","description":"The cancel url."},"logs":{"type":"object","description":"The logs.","additionalProperties":true},"metrics":{"type":"object","description":"The metrics.","additionalProperties":true},"queue_position":{"type":"integer","description":"The queue position."}},"required":["status","request_id"]},"UpscaleVideoPrecisionInput":{"x-fal-order-properties":["enable_safety_checker","video_url","model","upscale_factor","target_fps","compression","noise","halo","grain","recover_detail","H264_output"],"title":"VideoPrecisionUpscaleRequest","properties":{"model":{"description":"Precision (non-generative) enhancement model. Proteus fits most real-world footage; Proteus Natural is a softer variant; Iris recovers faces; Dione deinterlaces legacy/interlaced sources; Artemis denoises and sharpens degraded footage; Gaia refines high-quality footage and CG (Gaia 2 upscales animation at 2x); Rhea maximizes fine detail via an internal 4x pass; Theia gives manual detail/fidelity control.","title":"Model","enum":["Proteus","Proteus Natural","Iris","Iris Low Quality","Dione DV","Dione TV","Dione Robust","Dione Dehalo","Dione Robust Dehalo","Artemis High Quality","Artemis Medium Quality","Artemis Low Quality","Artemis Strong Halo","Artemis Medium Halo","Artemis Aliasing & Moire","Gaia HQ","Gaia CG","Gaia 2","Rhea","Theia Fine Tune Detail","Theia Fine Tune Fidelity"],"default":"Proteus","type":"string"},"halo":{"title":"Halo","description":"Halo reduction level (0.0-1.0). Default varies by model.","anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}]},"target_fps":{"title":"Target Fps","description":"Target FPS for the output. Frame interpolation is enabled only when this differs from the source FPS.","anyOf":[{"maximum":60,"minimum":16,"type":"integer"},{"type":"null"}]},"H264_output":{"title":"H264 Output","description":"Whether to use H264 codec for output video. Default is H265.","default":false,"type":"boolean"},"compression":{"title":"Compression","description":"Compression artifact removal level (0.0-1.0). Default varies by model.","anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}]},"video_url":{"title":"Video Url","examples":["https://v3.fal.media/files/kangaroo/y5-1YTGpun17eSeggZMzX_video-1733468228.mp4"],"description":"URL of the video to upscale","type":"string"},"upscale_factor":{"title":"Upscale Factor","maximum":4,"minimum":1,"description":"Factor to upscale the video by (e.g. 2.0 doubles width and height)","default":2,"type":"number"},"grain":{"title":"Grain","description":"Film grain amount (0.0-0.1). Default varies by model.","anyOf":[{"multipleOf":0.01,"maximum":0.1,"minimum":0,"type":"number"},{"type":"null"}]},"enable_safety_checker":{"title":"Enable Safety Checker","default":true,"type":"boolean"},"noise":{"title":"Noise","description":"Noise reduction level (0.0-1.0). Default varies by model.","anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}]},"recover_detail":{"title":"Recover Detail","description":"Recover original detail level (0.0-1.0). Higher values preserve more original detail.","anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}]}},"required":["video_url"],"type":"object"},"UpscaleVideoPrecisionOutput":{"x-fal-order-properties":["video"],"title":"VideoUpscaleOutput","properties":{"video":{"$ref":"#/components/schemas/File","examples":[{"url":"https://v3.fal.media/files/penguin/ztj_LB4gQlW6HIfVs8zX4_upscaled.mp4"}],"description":"The upscaled video file"}},"required":["video"],"type":"object"},"File":{"x-fal-order-properties":["url","content_type","file_name","file_size"],"title":"File","properties":{"file_size":{"title":"File Size","examples":[4404019],"description":"The size of the file in bytes.","anyOf":[{"type":"integer"},{"type":"null"}]},"url":{"title":"Url","description":"The URL where the file can be downloaded from.","type":"string"},"content_type":{"title":"Content Type","examples":["image/png"],"description":"The mime type of the file.","anyOf":[{"type":"string"},{"type":"null"}]},"file_name":{"title":"File Name","examples":["z9RV14K95DvU.png"],"description":"The name of the file. It will be auto-generated if not provided.","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["url"],"type":"object"}}},"paths":{"/topaz/upscale/video/precision/requests/{request_id}/status":{"get":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}},{"name":"logs","in":"query","required":false,"schema":{"type":"number","description":"Whether to include logs (`1`) in the response or not (`0`)."}}],"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/topaz/upscale/video/precision/requests/{request_id}/cancel":{"put":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}}],"responses":{"200":{"description":"The request was cancelled.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the request was cancelled successfully."}}}}}}}}},"/topaz/upscale/video/precision":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpscaleVideoPrecisionInput"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/topaz/upscale/video/precision/requests/{request_id}":{"get":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}}],"responses":{"200":{"description":"Result of the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpscaleVideoPrecisionOutput"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}},{"endpoint_id":"fal-ai/sync-lipsync/v2/pro","metadata":{"display_name":"Sync Lipsync","category":"video-to-video","description":"Generate high-quality realistic lipsync animations from audio while preserving unique details like natural teeth and unique facial features using the state-of-the-art Sync Lipsync 2 Pro model.","status":"active","tags":["animation","lip sync","high-quality",""],"updated_at":"2026-10-07T21:54:13.785Z","is_favorited":null,"thumbnail_url":"https://v3b.fal.media/files/b/0a9f91b0/lmANsOOA7MBmiALyLgc9r_0t3I7Ypw.png","model_url":"https://fal.run/fal-ai/sync-lipsync/v2/pro","license_type":"commercial","date":"2025-09-02T16:39:37.207Z","highlighted":false,"kind":"inference","pinned":false},"retires_at":null,"replacement":null,"openapi":{"openapi":"3.1.0","info":{"title":"Queue OpenAPI for fal-ai/sync-lipsync/v2/pro","version":"1.0.0","description":"The OpenAPI schema for the fal-ai/sync-lipsync/v2/pro queue.","x-fal-metadata":{"endpointId":"fal-ai/sync-lipsync/v2/pro","category":"video-to-video","thumbnailUrl":"https://v3b.fal.media/files/b/0a9f91b0/lmANsOOA7MBmiALyLgc9r_0t3I7Ypw.png","playgroundUrl":"https://fal.ai/models/fal-ai/sync-lipsync/v2/pro","documentationUrl":"https://fal.ai/models/fal-ai/sync-lipsync/v2/pro/api","about":"Lipsync Request V2 Pro"}},"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Fal Key"}},"schemas":{"QueueStatus":{"type":"object","properties":{"status":{"type":"string","enum":["IN_QUEUE","IN_PROGRESS","COMPLETED"]},"request_id":{"type":"string","description":"The request id."},"response_url":{"type":"string","description":"The response url."},"status_url":{"type":"string","description":"The status url."},"cancel_url":{"type":"string","description":"The cancel url."},"logs":{"type":"object","description":"The logs.","additionalProperties":true},"metrics":{"type":"object","description":"The metrics.","additionalProperties":true},"queue_position":{"type":"integer","description":"The queue position."}},"required":["status","request_id"]},"SyncLipsyncV2ProInput":{"properties":{"audio_url":{"examples":["https://storage.googleapis.com/falserverless/example_inputs/sync_v2_pro_audio_input.mp3"],"title":"Audio Url","description":"URL of the input audio","type":"string"},"enable_safety_checker":{"default":true,"title":"Enable Safety Checker","type":"boolean"},"sync_mode":{"default":"cut_off","title":"Sync Mode","enum":["cut_off","loop","bounce","silence","remap"],"description":"Lipsync mode when audio and video durations are out of sync.","type":"string"},"video_url":{"examples":["https://storage.googleapis.com/falserverless/example_inputs/sync_v2_pro_video_input.mp4"],"title":"Video Url","description":"URL of the input video","type":"string"}},"title":"LipSyncV2ProInput","x-fal-order-properties":["enable_safety_checker","video_url","audio_url","sync_mode"],"type":"object","required":["video_url","audio_url"]},"SyncLipsyncV2ProOutput":{"properties":{"video":{"examples":[{"url":"https://storage.googleapis.com/falserverless/example_outputs/sync_v2_pro_output.mp4"}],"description":"The generated video","$ref":"#/components/schemas/File"}},"title":"LipSyncV2ProOutput","x-fal-order-properties":["video"],"type":"object","required":["video"]},"File":{"properties":{"file_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"examples":[4404019],"title":"File Size","description":"The size of the file in bytes."},"url":{"title":"Url","description":"The URL where the file can be downloaded from.","type":"string"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"examples":["image/png"],"title":"Content Type","description":"The mime type of the file."},"file_name":{"anyOf":[{"type":"string"},{"type":"null"}],"examples":["z9RV14K95DvU.png"],"title":"File Name","description":"The name of the file. It will be auto-generated if not provided."}},"title":"File","x-fal-order-properties":["url","content_type","file_name","file_size"],"type":"object","required":["url"]}}},"paths":{"/fal-ai/sync-lipsync/v2/pro/requests/{request_id}/status":{"get":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}},{"name":"logs","in":"query","required":false,"schema":{"type":"number","description":"Whether to include logs (`1`) in the response or not (`0`)."}}],"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/fal-ai/sync-lipsync/v2/pro/requests/{request_id}/cancel":{"put":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}}],"responses":{"200":{"description":"The request was cancelled.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the request was cancelled successfully."}}}}}}}}},"/fal-ai/sync-lipsync/v2/pro":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyncLipsyncV2ProInput"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/fal-ai/sync-lipsync/v2/pro/requests/{request_id}":{"get":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}}],"responses":{"200":{"description":"Result of the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyncLipsyncV2ProOutput"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}}],"next_cursor":"Mg","has_more":true}