{"models":[{"endpoint_id":"minimax/h3-max/image-to-video","metadata":{"display_name":"H3 Max Image to Video","category":"image-to-video","description":"fal's H3 Max is a post-trained variant of MiniMax H3, tuned for stronger prompt adherence and better aesthetics while co-optimized with our custom inference stack for higher throughput with no compromises on output quality","status":"active","tags":["stylized","transform","lipsync"],"updated_at":"2026-09-17T07:30:38.382Z","is_favorited":null,"thumbnail_url":"https://v3b.fal.media/files/b/0aa7658f/fSQlWMcduHn4_abgJ7qhQ.jpg","model_url":"https://fal.run/minimax/h3-max/image-to-video","license_type":"commercial","date":"2026-08-23T18:01:01.388Z","group":{"key":"hailuo-03-new-turbo","label":"Image to Video Max"},"highlighted":false,"kind":"inference","pinned":false},"openapi":{"openapi":"3.0.4","info":{"title":"Queue OpenAPI for minimax/h3-max/image-to-video","version":"1.0.0","description":"The OpenAPI schema for the minimax/h3-max/image-to-video queue.","x-fal-metadata":{"endpointId":"minimax/h3-max/image-to-video","category":"image-to-video","thumbnailUrl":"https://v3b.fal.media/files/b/0aa7658f/fSQlWMcduHn4_abgJ7qhQ.jpg","playgroundUrl":"https://fal.ai/models/minimax/h3-max/image-to-video","documentationUrl":"https://fal.ai/models/minimax/h3-max/image-to-video/api","about":"Image-text-to-video: ``image_url`` optional; text-only routes to t2v."}},"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"]},"H3MaxImageToVideoInput":{"title":"TurboImageToVideoHailuo03Input","properties":{"prompt_expansion_mode":{"title":"Prompt Expansion Mode","examples":["disabled","balanced","quality"],"description":"How much effort to spend rewriting the prompt before generation. 'disabled' skips prompt expansion. 'balanced' returns in about a second. 'quality' spends up to ~30s on a richer prompt.","type":"string","default":"balanced"},"duration":{"title":"Duration","description":"The duration of the video in seconds.","default":5,"type":"integer","maximum":15,"minimum":5},"prompt":{"maxLength":50000,"title":"Prompt","examples":["The camera slowly pulls back from the scene, revealing the full landscape as clouds drift overhead and light shifts across the terrain."],"description":"Text prompt for video generation","type":"string","minLength":1},"target_audio_url":{"title":"Target Audio Url","description":"Optional URL of an audio clip at least 2 seconds long (maximum 15 MB) to pin to the generated soundtrack. Longer clips are trimmed to the requested video duration, keeping the beginning. The original audio replaces the output soundtrack, padded with silence if shorter than the video, without changing playback speed. Exceptionally high sample rates may be resampled to 96 kHz. Accepts an HTTP(S) URL or a base64 data URI.","anyOf":[{"pattern":"\\S","minLength":1,"type":"string"},{"type":"null"}]},"image_url":{"title":"Image URL","examples":["https://storage.googleapis.com/falserverless/example_inputs/hailuo23/pro_i2v_in.jpg"],"description":"Optional URL of the image to use as the first frame. When provided, the output canvas follows this image. If only end_image_url is provided, the canvas follows that last frame instead. If both images are omitted, the request is handled as text-to-video (16:9 by default).","anyOf":[{"type":"string"},{"type":"null"}]},"resolution":{"enum":["480P","768P","1080P"],"title":"Resolution","description":"The native generation resolution, or 1080P latent refinement from a native 768P source.","default":"768P","type":"string"},"end_image_url":{"title":"End Image URL","description":"Optional URL of the image to use as the last frame. It may be provided alone for end-only keyframe generation; in that case the output canvas follows this image.","anyOf":[{"type":"string"},{"type":"null"}]},"seed":{"title":"Seed","description":"Random seed. A random seed is selected when omitted.","anyOf":[{"type":"integer"},{"type":"null"}]},"enable_safety_checker":{"title":"Enable Safety Checker","description":"If set to true, the safety checker will be enabled.","default":true,"type":"boolean"},"sync_mode":{"title":"Sync Mode","description":"Return the generated video as base64 instead of a CDN URL.","default":false,"type":"boolean"}},"required":["prompt","prompt_expansion_mode"],"type":"object","x-fal-order-properties":["prompt","duration","resolution","seed","enable_safety_checker","sync_mode","prompt_expansion_mode","target_audio_url","image_url","end_image_url"]},"H3MaxImageToVideoOutput":{"title":"TurboImageToVideoHailuo03Output","properties":{"timings":{"title":"Timings","description":"Timing breakdown in seconds. 'inference' is the DiT denoising time on the GPU backend. Null on routes that do not report backend timings.","anyOf":[{"type":"object","additionalProperties":{"type":"number"}},{"type":"null"}]},"video":{"$ref":"#/components/schemas/File","description":"The generated video"},"expanded_prompt":{"title":"Expanded Prompt","description":"The prompt after expansion, as sent to the model. Null when prompt expansion was disabled, left the prompt unchanged, or was performed internally by MiniMax's hosted API.","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["video"],"type":"object","x-fal-order-properties":["video","expanded_prompt","timings"]},"File":{"title":"File","properties":{"url":{"title":"Url","description":"The URL where the file can be downloaded from.","type":"string"},"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"}]},"content_type":{"title":"Content Type","examples":["image/png"],"description":"The mime type of the file.","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["url"],"type":"object","x-fal-order-properties":["url","content_type","file_name","file_size"]}}},"paths":{"/minimax/h3-max/image-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"}}}}}}},"/minimax/h3-max/image-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."}}}}}}}}},"/minimax/h3-max/image-to-video":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/H3MaxImageToVideoInput"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/minimax/h3-max/image-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/H3MaxImageToVideoOutput"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}},{"endpoint_id":"fal-ai/kling-video/v3/pro/image-to-video","metadata":{"display_name":"Kling Video v3 Image to Video [Pro]","category":"image-to-video","description":"Kling 3.0 Pro: Top-tier image-to-video with cinematic visuals, fluid motion, and native audio generation, with custom element support.","status":"active","tags":["image-to-video"],"updated_at":"2026-05-29T18:50:02.672Z","is_favorited":null,"thumbnail_url":"https://v3b.fal.media/files/b/0a9c2fb3/yPzcdzINnY5RdSoEqHc8G_382d4ec9337344ccaacf5599057f6cd0.jpg","model_url":"https://fal.run/fal-ai/kling-video/v3/pro/image-to-video","license_type":"commercial","date":"2026-02-04T15:48:44.935Z","group":{"key":"kling-v3","label":"Image to Video (pro)"},"highlighted":false,"kind":"inference","pinned":false},"openapi":{"openapi":"3.0.4","info":{"title":"Queue OpenAPI for fal-ai/kling-video/v3/pro/image-to-video","version":"1.0.0","description":"The OpenAPI schema for the fal-ai/kling-video/v3/pro/image-to-video queue.","x-fal-metadata":{"endpointId":"fal-ai/kling-video/v3/pro/image-to-video","category":"image-to-video","thumbnailUrl":"https://v3b.fal.media/files/b/0a9c2fb3/yPzcdzINnY5RdSoEqHc8G_382d4ec9337344ccaacf5599057f6cd0.jpg","playgroundUrl":"https://fal.ai/models/fal-ai/kling-video/v3/pro/image-to-video","documentationUrl":"https://fal.ai/models/fal-ai/kling-video/v3/pro/image-to-video/api","about":"Kling V3 (pro) Image to Video API.\n\nThe Kling V3 model is the latest generation of image-to-video with\nimproved visual quality and motion consistency. This version also\nsupports native audio generation when the `generate_audio` parameter is enabled."}},"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"]},"KlingVideoV3ProImageToVideoInput":{"required":["start_image_url"],"properties":{"start_image_url":{"type":"string","examples":["https://storage.googleapis.com/falserverless/example_inputs/kling-v3/pro-i2v/start_image.png"],"title":"Start Image Url","limit_description":"Max file size: 10.0MB, Min width: 300px, Min height: 300px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Timeout: 20.0s","x-fal":{"max_aspect_ratio":2.5,"min_width":300,"min_aspect_ratio":0.4,"timeout":20,"min_height":300,"max_file_size":10485760},"description":"URL of the image to be used for the video"},"elements":{"examples":[[{"frontal_image_url":"https://v3b.fal.media/files/b/0a8cfd5f/-kZL-ha3Iuelku5IHXC-A_glasses.png","reference_image_urls":["https://v3b.fal.media/files/b/0a8cfd62/psPCmzrD1y9vDgdyNfKAL_glasses_back.png"]},{"video_url":"https://v3b.fal.media/files/b/0a8cfd66/b03SOiQvKLlFx_jqdNZ9z_child_video.mp4"}]],"title":"Elements","anyOf":[{"items":{"$ref":"#/components/schemas/KlingV3ComboElementInput"},"type":"array"},{"type":"null"}],"description":"Elements (characters/objects) to include in the video. Each example can either be an image set (frontal + reference images) or a video. Reference in prompt as @Element1, @Element2, etc."},"prompt":{"examples":["The craftsman slowly examines the bowl, turning it gently in his weathered hands. His eyes reflect years of wisdom. Subtle smile forms on his face. Dust particles drift in warm light. Breathing motion, blinking eyes."],"title":"Prompt","anyOf":[{"maxLength":2500,"type":"string"},{"type":"null"}],"description":"Text prompt for video generation. Either prompt or multi_prompt must be provided, but not both."},"negative_prompt":{"default":"blur, distort, and low quality","maxLength":2500,"title":"Negative Prompt","type":"string"},"duration":{"default":"5","type":"string","title":"Duration","examples":["12"],"enum":["3","4","5","6","7","8","9","10","11","12","13","14","15"],"description":"The duration of the generated video in seconds"},"end_image_url":{"title":"End Image Url","anyOf":[{"ui":{"field":"image"},"x-fal":{"max_aspect_ratio":2.5,"min_width":300,"min_aspect_ratio":0.4,"timeout":20,"min_height":300,"max_file_size":10485760},"type":"string","limit_description":"Max file size: 10.0MB, Min width: 300px, Min height: 300px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Timeout: 20.0s"},{"type":"null"}],"description":"URL of the image to be used for the end of the video"},"multi_prompt":{"examples":[null],"title":"Multi Prompt","anyOf":[{"items":{"$ref":"#/components/schemas/KlingV3MultiPromptElement"},"type":"array"},{"type":"null"}],"description":"List of prompts for multi-shot video generation. If provided, divides the video into multiple shots."},"shot_type":{"default":"customize","title":"Shot Type","enum":["customize","intelligent"],"description":"The type of multi-shot video generation. 'intelligent' lets the model automatically determine shot structure.","type":"string"},"cfg_scale":{"minimum":0,"type":"number","title":"Cfg Scale","default":0.5,"description":"\n            The CFG (Classifier Free Guidance) scale is a measure of how close you want\n            the model to stick to your prompt.\n        ","maximum":1},"generate_audio":{"default":true,"type":"boolean","title":"Generate Audio","description":"Whether to generate native audio for the video. Supports Chinese and English voice output. Other languages are automatically translated to English. For English speech, use lowercase letters; for acronyms or proper nouns, use uppercase."}},"title":"ImageToVideoV3ProRequest","type":"object","x-fal-order-properties":["prompt","multi_prompt","start_image_url","duration","generate_audio","end_image_url","elements","shot_type","negative_prompt","cfg_scale"]},"KlingVideoV3ProImageToVideoOutput":{"required":["video"],"properties":{"video":{"$ref":"#/components/schemas/File","description":"The generated video","examples":[{"content_type":"video/mp4","file_size":8431922,"url":"https://storage.googleapis.com/falserverless/example_outputs/kling-v3/pro-i2v/out.mp4","file_name":"out.mp4"}]}},"title":"ImageToVideoV3ProOutput","type":"object","x-fal-order-properties":["video"]},"KlingV3ComboElementInput":{"title":"KlingV3ComboElementInput","properties":{"voice_id":{"title":"Voice Id","anyOf":[{"type":"string"},{"type":"null"}],"description":"The voice ID for this element. The voice will be binded to the element and references to this element will use the binded voice. Get voice IDs from the following endpoint: https://fal.ai/models/fal-ai/kling-video/create-voice"},"frontal_image_url":{"title":"Frontal Image Url","anyOf":[{"ui":{"field":"image"},"x-fal":{"max_aspect_ratio":2.5,"min_width":300,"min_aspect_ratio":0.4,"timeout":20,"min_height":300,"max_file_size":10485760},"type":"string","limit_description":"Max file size: 10.0MB, Min width: 300px, Min height: 300px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Timeout: 20.0s"},{"type":"null"}],"description":"The frontal image of the element (main view)."},"reference_image_urls":{"title":"Reference Image Urls","anyOf":[{"items":{"ui":{"field":"image"},"x-fal":{"max_aspect_ratio":2.5,"min_width":300,"min_aspect_ratio":0.4,"timeout":20,"min_height":300,"max_file_size":10485760},"_fal_ui_field":"image","type":"string","limit_description":"Max file size: 10.0MB, Min width: 300px, Min height: 300px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Timeout: 20.0s"},"type":"array"},{"type":"null"}],"description":"Additional reference images from different angles. 1-3 images supported. At least one image is required."},"video_url":{"title":"Video Url","anyOf":[{"ui":{"field":"video"},"x-fal":{"min_fps":24,"max_duration":10.05,"max_file_size":209715200,"min_duration":3,"min_width":720,"max_height":2160,"max_fps":60,"min_height":720,"max_width":2160,"timeout":30},"type":"string","limit_description":"Max file size: 200.0MB, Min width: 720px, Min height: 720px, Max width: 2160px, Max height: 2160px, Min duration: 3.0s, Max duration: 10.05s, Min FPS: 24.0, Max FPS: 60.0, Timeout: 30.0s"},{"type":"null"}],"description":"The video URL of the element. A request can only have one element with a video."}},"type":"object","x-fal-order-properties":["frontal_image_url","reference_image_urls","video_url","voice_id"]},"KlingV3MultiPromptElement":{"required":["prompt"],"properties":{"prompt":{"title":"Prompt","description":"The prompt for this shot.","type":"string"},"duration":{"default":"5","title":"Duration","enum":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15"],"description":"The duration of this shot in seconds","type":"string"}},"title":"KlingV3MultiPromptElement","type":"object","x-fal-order-properties":["prompt","duration"]},"File":{"required":["url"],"properties":{"content_type":{"title":"Content Type","anyOf":[{"type":"string"},{"type":"null"}],"description":"The mime type of the file.","examples":["image/png"]},"file_size":{"title":"File Size","anyOf":[{"type":"integer"},{"type":"null"}],"description":"The size of the file in bytes.","examples":[4404019]},"url":{"title":"Url","description":"The URL where the file can be downloaded from.","type":"string"},"file_name":{"title":"File Name","anyOf":[{"type":"string"},{"type":"null"}],"description":"The name of the file. It will be auto-generated if not provided.","examples":["z9RV14K95DvU.png"]}},"title":"File","type":"object","x-fal-order-properties":["url","content_type","file_name","file_size"]}}},"paths":{"/fal-ai/kling-video/v3/pro/image-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"}}}}}}},"/fal-ai/kling-video/v3/pro/image-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."}}}}}}}}},"/fal-ai/kling-video/v3/pro/image-to-video":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KlingVideoV3ProImageToVideoInput"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/fal-ai/kling-video/v3/pro/image-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/KlingVideoV3ProImageToVideoOutput"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}},{"endpoint_id":"minimax/h3-max-turbo/image-to-video","metadata":{"display_name":"H3 Max Turbo Image to Video","category":"image-to-video","description":"fal's H3 Max Turbo is a post-trained variant of MiniMax H3, tuned for stronger prompt adherence and better aesthetics while co-optimized with our custom inference stack for higher throughput with no compromises on output quality","status":"active","tags":["stylized","transform","lipsync"],"updated_at":"2026-09-17T07:30:54.389Z","is_favorited":null,"thumbnail_url":"https://v3b.fal.media/files/b/0aa8d532/tsMg9lPG9DaXI7bqzqz6Y.jpg","model_url":"https://fal.run/minimax/h3-max-turbo/image-to-video","license_type":"commercial","date":"2026-09-02T16:51:51.105Z","group":{"key":"hailuo-03-new-max-turbo","label":"Image to Video Max Turbo"},"highlighted":false,"kind":"inference","pinned":false},"openapi":{"openapi":"3.0.4","info":{"title":"Queue OpenAPI for minimax/h3-max-turbo/image-to-video","version":"1.0.0","description":"The OpenAPI schema for the minimax/h3-max-turbo/image-to-video queue.","x-fal-metadata":{"endpointId":"minimax/h3-max-turbo/image-to-video","category":"image-to-video","thumbnailUrl":"https://v3b.fal.media/files/b/0aa8d532/tsMg9lPG9DaXI7bqzqz6Y.jpg","playgroundUrl":"https://fal.ai/models/minimax/h3-max-turbo/image-to-video","documentationUrl":"https://fal.ai/models/minimax/h3-max-turbo/image-to-video/api","about":"Image To Video Max Turbo"}},"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"]},"H3MaxTurboImageToVideoInput":{"title":"TurboImageToVideoHailuo03Input","properties":{"prompt_expansion_mode":{"title":"Prompt Expansion Mode","examples":["disabled","balanced","quality"],"description":"How much effort to spend rewriting the prompt before generation. 'disabled' skips prompt expansion. 'balanced' returns in about a second. 'quality' spends up to ~30s on a richer prompt.","type":"string","default":"balanced"},"duration":{"title":"Duration","description":"The duration of the video in seconds.","default":5,"type":"integer","maximum":15,"minimum":5},"prompt":{"maxLength":50000,"title":"Prompt","examples":["The camera slowly pulls back from the scene, revealing the full landscape as clouds drift overhead and light shifts across the terrain."],"description":"Text prompt for video generation","type":"string","minLength":1},"target_audio_url":{"title":"Target Audio Url","description":"Optional URL of an audio clip at least 2 seconds long (maximum 15 MB) to pin to the generated soundtrack. Longer clips are trimmed to the requested video duration, keeping the beginning. The original audio replaces the output soundtrack, padded with silence if shorter than the video, without changing playback speed. Exceptionally high sample rates may be resampled to 96 kHz. Accepts an HTTP(S) URL or a base64 data URI.","anyOf":[{"pattern":"\\S","minLength":1,"type":"string"},{"type":"null"}]},"image_url":{"title":"Image URL","examples":["https://storage.googleapis.com/falserverless/example_inputs/hailuo23/pro_i2v_in.jpg"],"description":"Optional URL of the image to use as the first frame. When provided, the output canvas follows this image. If only end_image_url is provided, the canvas follows that last frame instead. If both images are omitted, the request is handled as text-to-video (16:9 by default).","anyOf":[{"type":"string"},{"type":"null"}]},"resolution":{"enum":["480P","768P","1080P"],"title":"Resolution","description":"The native generation resolution, or 1080P latent refinement from a native 768P source.","default":"768P","type":"string"},"end_image_url":{"title":"End Image URL","description":"Optional URL of the image to use as the last frame. It may be provided alone for end-only keyframe generation; in that case the output canvas follows this image.","anyOf":[{"type":"string"},{"type":"null"}]},"seed":{"title":"Seed","description":"Random seed. A random seed is selected when omitted.","anyOf":[{"type":"integer"},{"type":"null"}]},"enable_safety_checker":{"title":"Enable Safety Checker","description":"If set to true, the safety checker will be enabled.","default":true,"type":"boolean"},"sync_mode":{"title":"Sync Mode","description":"Return the generated video as base64 instead of a CDN URL.","default":false,"type":"boolean"}},"required":["prompt","prompt_expansion_mode"],"type":"object","x-fal-order-properties":["prompt","duration","resolution","seed","enable_safety_checker","sync_mode","prompt_expansion_mode","target_audio_url","image_url","end_image_url"]},"H3MaxTurboImageToVideoOutput":{"title":"TurboImageToVideoHailuo03Output","properties":{"timings":{"title":"Timings","description":"Timing breakdown in seconds. 'inference' is the DiT denoising time on the GPU backend. Null on routes that do not report backend timings.","anyOf":[{"type":"object","additionalProperties":{"type":"number"}},{"type":"null"}]},"video":{"$ref":"#/components/schemas/File","description":"The generated video"},"expanded_prompt":{"title":"Expanded Prompt","description":"The prompt after expansion, as sent to the model. Null when prompt expansion was disabled, left the prompt unchanged, or was performed internally by MiniMax's hosted API.","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["video"],"type":"object","x-fal-order-properties":["video","expanded_prompt","timings"]},"File":{"title":"File","properties":{"url":{"title":"Url","description":"The URL where the file can be downloaded from.","type":"string"},"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"}]},"content_type":{"title":"Content Type","examples":["image/png"],"description":"The mime type of the file.","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["url"],"type":"object","x-fal-order-properties":["url","content_type","file_name","file_size"]}}},"paths":{"/minimax/h3-max-turbo/image-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"}}}}}}},"/minimax/h3-max-turbo/image-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."}}}}}}}}},"/minimax/h3-max-turbo/image-to-video":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/H3MaxTurboImageToVideoInput"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/minimax/h3-max-turbo/image-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/H3MaxTurboImageToVideoOutput"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}},{"endpoint_id":"minimax/h3-max/reference-to-video","metadata":{"display_name":"H3 Max Reference to Video","category":"image-to-video","description":"fal's H3 Max is a post-trained variant of MiniMax H3, tuned for stronger prompt adherence and better aesthetics while co-optimized with our custom inference stack for higher throughput with no compromises on output quality","status":"active","tags":["stylized","transform","typography"],"updated_at":"2026-09-18T15:32:36.685Z","is_favorited":null,"thumbnail_url":"https://v3b.fal.media/files/b/0aa84d7e/Weqd1RIL2EmDlzxnkQzCq.jpg","model_url":"https://fal.run/minimax/h3-max/reference-to-video","license_type":"commercial","date":"2026-08-29T16:21:32.325Z","group":{"key":"hailuo-03-new-turbo","label":"Reference to Video Max"},"highlighted":false,"kind":"inference","pinned":false},"openapi":{"openapi":"3.0.4","info":{"title":"Queue OpenAPI for minimax/h3-max/reference-to-video","version":"1.0.0","description":"The OpenAPI schema for the minimax/h3-max/reference-to-video queue.","x-fal-metadata":{"endpointId":"minimax/h3-max/reference-to-video","category":"image-to-video","thumbnailUrl":"https://v3b.fal.media/files/b/0aa84d7e/Weqd1RIL2EmDlzxnkQzCq.jpg","playgroundUrl":"https://fal.ai/models/minimax/h3-max/reference-to-video","documentationUrl":"https://fal.ai/models/minimax/h3-max/reference-to-video/api","about":"Reference To Video Turbo"}},"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"]},"H3MaxReferenceToVideoInput":{"title":"TurboReferenceToVideoHailuo03Input","properties":{"sync_mode":{"title":"Sync Mode","description":"Return the generated video as base64 instead of a CDN URL.","default":false,"type":"boolean"},"prompt_expansion_mode":{"title":"Prompt Expansion Mode","examples":["disabled","balanced","quality"],"description":"How much effort to spend rewriting the prompt before generation. 'disabled' skips prompt expansion. 'balanced' returns in about a second. 'quality' spends up to ~30s on a richer prompt.","type":"string","default":"balanced"},"duration":{"title":"Duration","description":"The duration of the video in seconds.","default":5,"type":"integer","maximum":15,"minimum":5},"reference_video_urls":{"items":{"type":"string"},"title":"Reference Video URLs","description":"URLs of motion/reference video clips (2-15 seconds each, combined duration at most 15 seconds), referenced in the prompt as Video 1, Video 2, and so on. Reference images, videos, and audio clips must add up to at most 12 files.","maxItems":3,"type":"array"},"reference_audio_urls":{"items":{"type":"string"},"title":"Reference Audio URLs","description":"URLs of reference audio clips (2-15 seconds each, combined duration at most 15 seconds), referenced in the prompt as Audio 1, Audio 2, and so on. Images, videos, and audio can be provided individually or together. Reference images, videos, and audio clips must add up to at most 12 files.","maxItems":3,"type":"array"},"prompt":{"maxLength":50000,"title":"Prompt","examples":["Image 1 is the female protagonist. Image 2 is her small dog. Keep the woman and dog consistent with their respective reference images while they walk together through a sunlit garden."],"description":"Text prompt for video generation. Refer to reference assets by their modality and order in the reference lists: Image 1, Image 2, Video 1, Audio 1, and so on.","type":"string","minLength":1},"reference_image_urls":{"items":{"type":"string"},"title":"Reference Image URLs","examples":[["https://storage.googleapis.com/falserverless/example_inputs/hailuo23/pro_i2v_in.jpg"]],"description":"URLs of subject/style reference images, referenced in the prompt as Image 1, Image 2, and so on. Reference images, videos, and audio clips must add up to at most 12 files.","maxItems":9,"type":"array"},"resolution":{"enum":["480P","768P","1080P"],"title":"Resolution","description":"The native generation resolution, or 1080P latent refinement from a native 768P source.","default":"768P","type":"string"},"seed":{"title":"Seed","description":"Random seed. A random seed is selected when omitted.","anyOf":[{"type":"integer"},{"type":"null"}]},"aspect_ratio":{"enum":["adaptive","21:9","16:9","4:3","1:1","3:4","9:16"],"title":"Aspect Ratio","description":"The aspect ratio of the generated video.","default":"adaptive","type":"string"},"enable_safety_checker":{"title":"Enable Safety Checker","description":"If set to true, the safety checker will be enabled.","default":true,"type":"boolean"}},"required":["prompt","prompt_expansion_mode"],"type":"object","x-fal-order-properties":["prompt","duration","resolution","seed","enable_safety_checker","sync_mode","prompt_expansion_mode","aspect_ratio","reference_image_urls","reference_video_urls","reference_audio_urls"]},"H3MaxReferenceToVideoOutput":{"title":"TurboReferenceToVideoHailuo03Output","properties":{"timings":{"title":"Timings","description":"Timing breakdown in seconds. 'inference' is the DiT denoising time on the GPU backend. Null on routes that do not report backend timings.","anyOf":[{"type":"object","additionalProperties":{"type":"number"}},{"type":"null"}]},"seed":{"title":"Seed","description":"Base seed for reproducing the generation.","type":"integer"},"video":{"$ref":"#/components/schemas/File","description":"The generated video"},"expanded_prompt":{"title":"Expanded Prompt","description":"The prompt after expansion, as sent to the model. Null when prompt expansion was disabled, left the prompt unchanged, or was performed internally by MiniMax's hosted API.","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["video","seed"],"type":"object","x-fal-order-properties":["video","expanded_prompt","seed","timings"]},"File":{"title":"File","properties":{"url":{"title":"Url","description":"The URL where the file can be downloaded from.","type":"string"},"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"}]},"content_type":{"title":"Content Type","examples":["image/png"],"description":"The mime type of the file.","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["url"],"type":"object","x-fal-order-properties":["url","content_type","file_name","file_size"]}}},"paths":{"/minimax/h3-max/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"}}}}}}},"/minimax/h3-max/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."}}}}}}}}},"/minimax/h3-max/reference-to-video":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/H3MaxReferenceToVideoInput"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/minimax/h3-max/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/H3MaxReferenceToVideoOutput"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}},{"endpoint_id":"bytedance/seedance-2.5/reference-to-video","metadata":{"display_name":"Seedance 2.5 Reference to Video","category":"image-to-video","description":"Dreamina Seedance 2.5 generates video from up to 50 multimodal references images, video, audio, and style inputs, locking a character, set, and palette across a full 30-second take for production-grade consistency.","status":"active","tags":["stylized","transform","lipsync"],"updated_at":"2026-09-09T17:43:56.710Z","is_favorited":null,"thumbnail_url":"https://v3b.fal.media/files/b/0aa30ee1/AvoWQSXcqJuX5CggoM3uh.jpg","model_url":"https://fal.run/bytedance/seedance-2.5/reference-to-video","license_type":"commercial","date":"2026-07-20T21:04:34.821Z","group":{"key":"Seedance-25","label":"Reference to Video"},"highlighted":false,"kind":"inference","pinned":false},"openapi":{"openapi":"3.0.4","info":{"title":"Queue OpenAPI for bytedance/seedance-2.5/reference-to-video","version":"1.0.0","description":"The OpenAPI schema for the bytedance/seedance-2.5/reference-to-video queue.","x-fal-metadata":{"endpointId":"bytedance/seedance-2.5/reference-to-video","category":"image-to-video","thumbnailUrl":"https://v3b.fal.media/files/b/0aa30ee1/AvoWQSXcqJuX5CggoM3uh.jpg","playgroundUrl":"https://fal.ai/models/bytedance/seedance-2.5/reference-to-video","documentationUrl":"https://fal.ai/models/bytedance/seedance-2.5/reference-to-video/api","about":"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"]},"Seedance25ReferenceToVideoInput":{"required":["prompt"],"title":"Seedance2R2VInput","properties":{"video_urls":{"title":"Video Urls","items":{"type":"string","_fal_ui_field":"video"},"description":"Reference videos to guide video generation. Refer to them in the prompt as @Video1, @Video2, etc. Supported formats: MP4, MOV. Up to 10 videos. Each video must be 1.8 to 30.2 seconds and no larger than 200 MB; combined duration must not exceed 30.2 seconds. Dimensions must be 300 to 6,000 pixels per side, aspect ratio 0.4 to 2.5, and frame rate 24 to 60 FPS.","type":"array"},"audio_urls":{"title":"Audio Urls","items":{"type":"string","_fal_ui_field":"audio"},"description":"Reference audio to guide video generation. Refer to them in the prompt as @Audio1, @Audio2, etc. Supported formats: MP3, WAV. Up to 10 files. Each file must be 1.8 to 30.2 seconds and no larger than 15 MB; combined duration must not exceed 30.2 seconds. At least one reference image or video is required.","type":"array"},"seed":{"title":"Seed","anyOf":[{"type":"integer"},{"type":"null"}],"description":"Random seed for reproducibility. Note that results may still vary slightly even with the same seed."},"duration":{"title":"Duration","default":"auto","enum":["auto","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30"],"description":"Duration of the video in seconds. Supports 4 to 30 seconds, or auto to let the model decide based on the prompt.","type":"string"},"prompt":{"title":"Prompt","description":"The text prompt used to generate the video.","type":"string","examples":["An octopus finds a football in the ocean and excitedly calls its octopus friends to come and play. Cut scene to an octopus football game under the sea."]},"resolution":{"title":"Resolution","default":"720p","enum":["480p","720p","1080p"],"description":"Video resolution - 480p for faster generation, 720p for balance, 1080p for high quality.","type":"string"},"generate_audio":{"title":"Generate Audio","default":true,"description":"Whether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech. The cost of video generation is the same regardless of whether audio is generated or not.","type":"boolean"},"task":{"title":"Task","default":"reference","enum":["reference","editing","extension"],"description":"The type of video generation task. Reference uses the supplied media as guidance. Editing modifies a reference video and automatically coerces aspect_ratio and duration to auto. Extension continues a reference video and automatically coerces aspect_ratio to auto.","type":"string"},"end_user_id":{"title":"End User Id","anyOf":[{"type":"string"},{"type":"null"}],"description":"The unique user ID of the end user."},"image_urls":{"title":"Image Urls","items":{"type":"string"},"description":"Reference images to guide video generation. Refer to them in the prompt as @Image1, @Image2, etc. Supported formats: JPG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF. Max 30 MB per image. Up to 30 images. Total files across all modalities must not exceed 50.","type":"array","examples":[["https://v3b.fal.media/files/b/0a8eba37/Cqg-4Uwzyz4DELfceT1CF_a17e588773ec45b1a9e6f100a787b80b.jpg"]]},"bitrate_mode":{"title":"Bitrate Mode","default":"standard","enum":["standard","high"],"description":"Output bitrate mode. 'high' requests a higher-quality, larger-file encode from the model; 'standard' uses the default bitrate.","type":"string","examples":["standard"]},"aspect_ratio":{"title":"Aspect Ratio","default":"auto","enum":["auto","21:9","16:9","4:3","1:1","3:4","9:16"],"description":"The aspect ratio of the generated video. Use 16:9 for landscape, 9:16 for portrait/vertical, 1:1 for square, 21:9 for ultrawide cinematic, or auto to let the model decide.","type":"string"}},"x-fal-order-properties":["prompt","task","image_urls","video_urls","audio_urls","resolution","duration","aspect_ratio","generate_audio","bitrate_mode","seed","end_user_id"],"type":"object"},"Seedance25ReferenceToVideoOutput":{"required":["video","seed"],"title":"Seedance2VideoOutput","properties":{"video":{"description":"The generated video file.","examples":[{"url":"https://storage.googleapis.com/falserverless/example_outputs/bytedance/seedance_2/output.mp4"}],"$ref":"#/components/schemas/File"},"seed":{"title":"Seed","description":"The seed used for generation.","type":"integer","examples":[42]}},"x-fal-order-properties":["video","seed"],"type":"object"},"File":{"required":["url"],"title":"File","properties":{"url":{"title":"Url","description":"The URL where the file can be downloaded from.","type":"string"},"file_name":{"title":"File Name","anyOf":[{"type":"string"},{"type":"null"}],"description":"The name of the file. It will be auto-generated if not provided.","examples":["z9RV14K95DvU.png"]},"file_size":{"title":"File Size","anyOf":[{"type":"integer"},{"type":"null"}],"description":"The size of the file in bytes.","examples":[4404019]},"content_type":{"title":"Content Type","anyOf":[{"type":"string"},{"type":"null"}],"description":"The mime type of the file.","examples":["image/png"]}},"x-fal-order-properties":["url","content_type","file_name","file_size"],"type":"object"}}},"paths":{"/bytedance/seedance-2.5/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"}}}}}}},"/bytedance/seedance-2.5/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."}}}}}}}}},"/bytedance/seedance-2.5/reference-to-video":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Seedance25ReferenceToVideoInput"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/bytedance/seedance-2.5/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/Seedance25ReferenceToVideoOutput"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}},{"endpoint_id":"bytedance/seedance-2.5/image-to-video","metadata":{"display_name":"Seedance 2.5 Image to Video","category":"image-to-video","description":"Dreamina Seedance 2.5 animates a single still into a native 30-second clip at up to 720p, extending one frame into continuous, coherent motion without the drift or stitching of shorter multi-clip workflows.","status":"active","tags":["stylized","transform","lipsync"],"updated_at":"2026-08-28T18:46:17.166Z","is_favorited":null,"thumbnail_url":"https://v3b.fal.media/files/b/0aa30ef9/4Ux9T9X2458w7LH1AI_oz.jpg","model_url":"https://fal.run/bytedance/seedance-2.5/image-to-video","license_type":"commercial","date":"2026-07-20T21:02:38.001Z","group":{"key":"Seedance-25","label":"Image to Video"},"highlighted":false,"kind":"inference","pinned":false},"openapi":{"openapi":"3.0.4","info":{"title":"Queue OpenAPI for bytedance/seedance-2.5/image-to-video","version":"1.0.0","description":"The OpenAPI schema for the bytedance/seedance-2.5/image-to-video queue.","x-fal-metadata":{"endpointId":"bytedance/seedance-2.5/image-to-video","category":"image-to-video","thumbnailUrl":"https://v3b.fal.media/files/b/0aa30ef9/4Ux9T9X2458w7LH1AI_oz.jpg","playgroundUrl":"https://fal.ai/models/bytedance/seedance-2.5/image-to-video","documentationUrl":"https://fal.ai/models/bytedance/seedance-2.5/image-to-video/api","about":"Image 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"]},"Seedance25ImageToVideoInput":{"required":["prompt","image_url"],"title":"Seedance2I2VInput","properties":{"duration":{"title":"Duration","default":"auto","enum":["auto","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30"],"description":"Duration of the video in seconds. Supports 4 to 30 seconds, or auto to let the model decide based on the prompt.","type":"string"},"image_url":{"title":"Image Url","description":"The URL of the starting frame image to animate. Supported formats: JPEG, PNG, WebP. Max 30 MB.","type":"string","examples":["https://v3b.fal.media/files/b/0a8eba37/Cqg-4Uwzyz4DELfceT1CF_a17e588773ec45b1a9e6f100a787b80b.jpg"]},"resolution":{"title":"Resolution","default":"720p","enum":["480p","720p","1080p"],"description":"Video resolution - 480p for faster generation, 720p for balance, 1080p for high quality.","type":"string"},"generate_audio":{"title":"Generate Audio","default":true,"description":"Whether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech. The cost of video generation is the same regardless of whether audio is generated or not.","type":"boolean"},"end_image_url":{"title":"End Image Url","anyOf":[{"type":"string"},{"type":"null"}],"description":"The URL of the image to use as the last frame of the video. When provided, the generated video will transition from the starting image to this ending image. Supported formats: JPEG, PNG, WebP. Max 30 MB."},"end_user_id":{"title":"End User Id","anyOf":[{"type":"string"},{"type":"null"}],"description":"The unique user ID of the end user."},"prompt":{"title":"Prompt","description":"The text prompt describing the desired motion and action for the video.","type":"string","examples":["An octopus finds a football in the ocean and excitedly calls its octopus friends to come and play. Cut scene to an octopus football game under the sea."]},"bitrate_mode":{"title":"Bitrate Mode","default":"standard","enum":["standard","high"],"description":"Output bitrate mode. 'high' requests a higher-quality, larger-file encode from the model; 'standard' uses the default bitrate.","type":"string","examples":["standard"]},"aspect_ratio":{"title":"Aspect Ratio","default":"auto","description":"The aspect ratio of the generated video. Always \"auto\" for image-to-video","type":"string","const":"auto"}},"x-fal-order-properties":["prompt","image_url","end_image_url","resolution","duration","aspect_ratio","generate_audio","bitrate_mode","end_user_id"],"type":"object"},"Seedance25ImageToVideoOutput":{"required":["video","seed"],"title":"Seedance2VideoOutput","properties":{"video":{"description":"The generated video file.","examples":[{"url":"https://storage.googleapis.com/falserverless/example_outputs/bytedance/seedance_2/output.mp4"}],"$ref":"#/components/schemas/File"},"seed":{"title":"Seed","description":"The seed used for generation.","type":"integer","examples":[42]}},"x-fal-order-properties":["video","seed"],"type":"object"},"File":{"required":["url"],"title":"File","properties":{"url":{"title":"Url","description":"The URL where the file can be downloaded from.","type":"string"},"file_name":{"title":"File Name","anyOf":[{"type":"string"},{"type":"null"}],"description":"The name of the file. It will be auto-generated if not provided.","examples":["z9RV14K95DvU.png"]},"file_size":{"title":"File Size","anyOf":[{"type":"integer"},{"type":"null"}],"description":"The size of the file in bytes.","examples":[4404019]},"content_type":{"title":"Content Type","anyOf":[{"type":"string"},{"type":"null"}],"description":"The mime type of the file.","examples":["image/png"]}},"x-fal-order-properties":["url","content_type","file_name","file_size"],"type":"object"}}},"paths":{"/bytedance/seedance-2.5/image-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"}}}}}}},"/bytedance/seedance-2.5/image-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."}}}}}}}}},"/bytedance/seedance-2.5/image-to-video":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Seedance25ImageToVideoInput"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/bytedance/seedance-2.5/image-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/Seedance25ImageToVideoOutput"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}},{"endpoint_id":"fal-ai/kling-video/v2.5-turbo/pro/image-to-video","metadata":{"display_name":"Kling Video","category":"image-to-video","description":"Kling 2.5 Turbo Pro: Top-tier image-to-video generation with unparalleled motion fluidity, cinematic visuals, and exceptional prompt precision.","status":"active","tags":["stylized","transform"],"updated_at":"2026-04-26T22:25:17.147Z","is_favorited":null,"thumbnail_url":"https://v3.fal.media/files/rabbit/2KNBk1qkmEBXK0FLgfHCl_ee4bb1ada254433bbab296893a8636e3.jpg","model_url":"https://fal.run/fal-ai/kling-video/v2.5-turbo/pro/image-to-video","license_type":"commercial","date":"2025-09-22T22:51:16.379Z","group":{"key":"kling-video-v25","label":"2.5 Turbo (Image to Video) Pro"},"highlighted":false,"kind":"inference","pinned":false},"openapi":{"openapi":"3.0.4","info":{"title":"Queue OpenAPI for fal-ai/kling-video/v2.5-turbo/pro/image-to-video","version":"1.0.0","description":"The OpenAPI schema for the fal-ai/kling-video/v2.5-turbo/pro/image-to-video queue.","x-fal-metadata":{"endpointId":"fal-ai/kling-video/v2.5-turbo/pro/image-to-video","category":"image-to-video","thumbnailUrl":"https://v3.fal.media/files/rabbit/2KNBk1qkmEBXK0FLgfHCl_ee4bb1ada254433bbab296893a8636e3.jpg","playgroundUrl":"https://fal.ai/models/fal-ai/kling-video/v2.5-turbo/pro/image-to-video","documentationUrl":"https://fal.ai/models/fal-ai/kling-video/v2.5-turbo/pro/image-to-video/api","about":"Kling 2.5 (pro) Image to Video API."}},"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"]},"KlingVideoV25TurboProImageToVideoInput":{"required":["prompt","image_url"],"properties":{"cfg_scale":{"minimum":0,"type":"number","title":"Cfg Scale","default":0.5,"description":"\n            The CFG (Classifier Free Guidance) scale is a measure of how close you want\n            the model to stick to your prompt.\n        ","maximum":1},"image_url":{"type":"string","examples":["https://v3.fal.media/files/panda/HnY2yf-BbzlrVQxR-qP6m_9912d0932988453aadf3912fc1901f52.jpg"],"title":"Image Url","description":"URL of the image to be used for the video"},"prompt":{"maxLength":2500,"title":"Prompt","examples":["A stark starting line divides two powerful cars, engines revving for the challenge ahead. They surge forward in the heat of competition, a blur of speed and chrome. The finish line looms as they vie for victory."],"type":"string"},"negative_prompt":{"default":"blur, distort, and low quality","maxLength":2500,"title":"Negative Prompt","type":"string"},"duration":{"default":"5","title":"Duration","enum":["5","10"],"description":"The duration of the generated video in seconds","type":"string"},"tail_image_url":{"title":"Tail Image Url","anyOf":[{"type":"string","ui":{"field":"image"}},{"type":"null"}],"description":"URL of the image to be used for the end of the video"}},"title":"ImageToVideoV25ProRequest","type":"object","x-fal-order-properties":["prompt","image_url","duration","negative_prompt","cfg_scale","tail_image_url"]},"KlingVideoV25TurboProImageToVideoOutput":{"required":["video"],"properties":{"video":{"$ref":"#/components/schemas/File","description":"The generated video","examples":[{"url":"https://storage.googleapis.com/falserverless/model_tests/kling/kling-v2.5-turbo-pro-image-to-video-output.mp4"}]}},"title":"ImageToVideoV25ProOutput","type":"object","x-fal-order-properties":["video"]},"File":{"required":["url"],"properties":{"content_type":{"title":"Content Type","anyOf":[{"type":"string"},{"type":"null"}],"description":"The mime type of the file.","examples":["image/png"]},"file_size":{"title":"File Size","anyOf":[{"type":"integer"},{"type":"null"}],"description":"The size of the file in bytes.","examples":[4404019]},"url":{"title":"Url","description":"The URL where the file can be downloaded from.","type":"string"},"file_name":{"title":"File Name","anyOf":[{"type":"string"},{"type":"null"}],"description":"The name of the file. It will be auto-generated if not provided.","examples":["z9RV14K95DvU.png"]}},"title":"File","type":"object","x-fal-order-properties":["url","content_type","file_name","file_size"]}}},"paths":{"/fal-ai/kling-video/v2.5-turbo/pro/image-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"}}}}}}},"/fal-ai/kling-video/v2.5-turbo/pro/image-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."}}}}}}}}},"/fal-ai/kling-video/v2.5-turbo/pro/image-to-video":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KlingVideoV25TurboProImageToVideoInput"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/fal-ai/kling-video/v2.5-turbo/pro/image-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/KlingVideoV25TurboProImageToVideoOutput"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}},{"endpoint_id":"fal-ai/kling-video/v3/standard/image-to-video","metadata":{"display_name":"Kling Video v3 Image to Video [Standard]","category":"image-to-video","description":"Kling 3.0 Standard: Top-tier image-to-video with cinematic visuals, fluid motion, and native audio generation, with custom element support.","status":"active","tags":["image-to-video"],"updated_at":"2026-04-26T22:25:17.147Z","is_favorited":null,"thumbnail_url":"https://v3b.fal.media/files/b/0a8cfcdb/TywpxxNj5_vDG8AUw3Yum_e2172b5c00e64a91a434ab5a38e496f0.jpg","model_url":"https://fal.run/fal-ai/kling-video/v3/standard/image-to-video","license_type":"commercial","date":"2026-02-04T15:48:44.935Z","group":{"key":"kling-v3","label":"Image To Video (standard)"},"highlighted":false,"kind":"inference","pinned":false},"openapi":{"openapi":"3.0.4","info":{"title":"Queue OpenAPI for fal-ai/kling-video/v3/standard/image-to-video","version":"1.0.0","description":"The OpenAPI schema for the fal-ai/kling-video/v3/standard/image-to-video queue.","x-fal-metadata":{"endpointId":"fal-ai/kling-video/v3/standard/image-to-video","category":"image-to-video","thumbnailUrl":"https://v3b.fal.media/files/b/0a8cfcdb/TywpxxNj5_vDG8AUw3Yum_e2172b5c00e64a91a434ab5a38e496f0.jpg","playgroundUrl":"https://fal.ai/models/fal-ai/kling-video/v3/standard/image-to-video","documentationUrl":"https://fal.ai/models/fal-ai/kling-video/v3/standard/image-to-video/api","about":"Kling V3 (standard) Image to Video API.\n\nThe Kling V3 model is the latest generation of image-to-video with\nimproved visual quality and motion consistency. This version also\nsupports native audio generation when the `generate_audio` parameter is enabled."}},"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"]},"KlingVideoV3StandardImageToVideoInput":{"required":["start_image_url"],"properties":{"start_image_url":{"type":"string","examples":["https://storage.googleapis.com/falserverless/example_inputs/kling-v3/standard-i2v/start_image.png"],"title":"Start Image Url","limit_description":"Max file size: 10.0MB, Min width: 300px, Min height: 300px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Timeout: 20.0s","x-fal":{"max_aspect_ratio":2.5,"min_width":300,"min_aspect_ratio":0.4,"timeout":20,"min_height":300,"max_file_size":10485760},"description":"URL of the image to be used for the video"},"elements":{"examples":[[{"frontal_image_url":"https://v3b.fal.media/files/b/0a8cfd5f/-kZL-ha3Iuelku5IHXC-A_glasses.png","reference_image_urls":["https://v3b.fal.media/files/b/0a8cfd62/psPCmzrD1y9vDgdyNfKAL_glasses_back.png"]},{"video_url":"https://v3b.fal.media/files/b/0a8cfd66/b03SOiQvKLlFx_jqdNZ9z_child_video.mp4"}]],"title":"Elements","anyOf":[{"items":{"$ref":"#/components/schemas/KlingV3ComboElementInput"},"type":"array"},{"type":"null"}],"description":"Elements (characters/objects) to include in the video. Each example can either be an image set (frontal + reference images) or a video. Reference in prompt as @Element1, @Element2, etc."},"prompt":{"examples":["Camera slowly orbits around the vase. Soft light shifts across the ceramic surface. The pampas grass sways gently. Shadows move elegantly. Smooth continuous motion, premium feel."],"title":"Prompt","anyOf":[{"maxLength":2500,"type":"string"},{"type":"null"}],"description":"Text prompt for video generation. Either prompt or multi_prompt must be provided, but not both."},"negative_prompt":{"default":"blur, distort, and low quality","maxLength":2500,"title":"Negative Prompt","type":"string"},"duration":{"default":"5","type":"string","title":"Duration","examples":["12"],"enum":["3","4","5","6","7","8","9","10","11","12","13","14","15"],"description":"The duration of the generated video in seconds"},"end_image_url":{"title":"End Image Url","anyOf":[{"ui":{"field":"image"},"x-fal":{"max_aspect_ratio":2.5,"min_width":300,"min_aspect_ratio":0.4,"timeout":20,"min_height":300,"max_file_size":10485760},"type":"string","limit_description":"Max file size: 10.0MB, Min width: 300px, Min height: 300px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Timeout: 20.0s"},{"type":"null"}],"description":"URL of the image to be used for the end of the video"},"multi_prompt":{"examples":[null],"title":"Multi Prompt","anyOf":[{"items":{"$ref":"#/components/schemas/KlingV3MultiPromptElement"},"type":"array"},{"type":"null"}],"description":"List of prompts for multi-shot video generation. If provided, divides the video into multiple shots."},"shot_type":{"default":"customize","title":"Shot Type","enum":["customize","intelligent"],"description":"The type of multi-shot video generation. 'intelligent' lets the model automatically determine shot structure.","type":"string"},"cfg_scale":{"minimum":0,"type":"number","title":"Cfg Scale","default":0.5,"description":"\n            The CFG (Classifier Free Guidance) scale is a measure of how close you want\n            the model to stick to your prompt.\n        ","maximum":1},"generate_audio":{"default":true,"type":"boolean","title":"Generate Audio","description":"Whether to generate native audio for the video. Supports Chinese and English voice output. Other languages are automatically translated to English. For English speech, use lowercase letters; for acronyms or proper nouns, use uppercase."}},"title":"ImageToVideoV3StandardRequest","type":"object","x-fal-order-properties":["prompt","multi_prompt","start_image_url","duration","generate_audio","end_image_url","elements","shot_type","negative_prompt","cfg_scale"]},"KlingVideoV3StandardImageToVideoOutput":{"required":["video"],"properties":{"video":{"$ref":"#/components/schemas/File","description":"The generated video","examples":[{"content_type":"video/mp4","file_size":3149129,"url":"https://storage.googleapis.com/falserverless/example_outputs/kling-v3/standard-i2v/out.mp4","file_name":"out.mp4"}]}},"title":"ImageToVideoV3StandardOutput","type":"object","x-fal-order-properties":["video"]},"KlingV3ComboElementInput":{"title":"KlingV3ComboElementInput","properties":{"voice_id":{"title":"Voice Id","anyOf":[{"type":"string"},{"type":"null"}],"description":"The voice ID for this element. The voice will be binded to the element and references to this element will use the binded voice. Get voice IDs from the following endpoint: https://fal.ai/models/fal-ai/kling-video/create-voice"},"frontal_image_url":{"title":"Frontal Image Url","anyOf":[{"ui":{"field":"image"},"x-fal":{"max_aspect_ratio":2.5,"min_width":300,"min_aspect_ratio":0.4,"timeout":20,"min_height":300,"max_file_size":10485760},"type":"string","limit_description":"Max file size: 10.0MB, Min width: 300px, Min height: 300px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Timeout: 20.0s"},{"type":"null"}],"description":"The frontal image of the element (main view)."},"reference_image_urls":{"title":"Reference Image Urls","anyOf":[{"items":{"ui":{"field":"image"},"x-fal":{"max_aspect_ratio":2.5,"min_width":300,"min_aspect_ratio":0.4,"timeout":20,"min_height":300,"max_file_size":10485760},"_fal_ui_field":"image","type":"string","limit_description":"Max file size: 10.0MB, Min width: 300px, Min height: 300px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Timeout: 20.0s"},"type":"array"},{"type":"null"}],"description":"Additional reference images from different angles. 1-3 images supported. At least one image is required."},"video_url":{"title":"Video Url","anyOf":[{"ui":{"field":"video"},"x-fal":{"min_fps":24,"max_duration":10.05,"max_file_size":209715200,"min_duration":3,"min_width":720,"max_height":2160,"max_fps":60,"min_height":720,"max_width":2160,"timeout":30},"type":"string","limit_description":"Max file size: 200.0MB, Min width: 720px, Min height: 720px, Max width: 2160px, Max height: 2160px, Min duration: 3.0s, Max duration: 10.05s, Min FPS: 24.0, Max FPS: 60.0, Timeout: 30.0s"},{"type":"null"}],"description":"The video URL of the element. A request can only have one element with a video."}},"type":"object","x-fal-order-properties":["frontal_image_url","reference_image_urls","video_url","voice_id"]},"KlingV3MultiPromptElement":{"required":["prompt"],"properties":{"prompt":{"title":"Prompt","description":"The prompt for this shot.","type":"string"},"duration":{"default":"5","title":"Duration","enum":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15"],"description":"The duration of this shot in seconds","type":"string"}},"title":"KlingV3MultiPromptElement","type":"object","x-fal-order-properties":["prompt","duration"]},"File":{"required":["url"],"properties":{"content_type":{"title":"Content Type","anyOf":[{"type":"string"},{"type":"null"}],"description":"The mime type of the file.","examples":["image/png"]},"file_size":{"title":"File Size","anyOf":[{"type":"integer"},{"type":"null"}],"description":"The size of the file in bytes.","examples":[4404019]},"url":{"title":"Url","description":"The URL where the file can be downloaded from.","type":"string"},"file_name":{"title":"File Name","anyOf":[{"type":"string"},{"type":"null"}],"description":"The name of the file. It will be auto-generated if not provided.","examples":["z9RV14K95DvU.png"]}},"title":"File","type":"object","x-fal-order-properties":["url","content_type","file_name","file_size"]}}},"paths":{"/fal-ai/kling-video/v3/standard/image-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"}}}}}}},"/fal-ai/kling-video/v3/standard/image-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."}}}}}}}}},"/fal-ai/kling-video/v3/standard/image-to-video":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KlingVideoV3StandardImageToVideoInput"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/fal-ai/kling-video/v3/standard/image-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/KlingVideoV3StandardImageToVideoOutput"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}},{"endpoint_id":"bytedance/seedance-2.0/image-to-video","metadata":{"display_name":"Seedance 2 Image to Video","category":"image-to-video","description":"ByteDance's most advanced image-to-video model. Animate still images into cinematic video with synchronized audio, start and end frame control, and motion prompts.","status":"active","tags":["stylized","transform","lipsync"],"updated_at":"2026-06-22T18:20:04.465Z","is_favorited":null,"thumbnail_url":"https://v3b.fal.media/files/b/0a9c2f2b/C5HNQz1oux7K-6Tqfd_-9_c4a7c912a6db402686fe2c01591a1687.jpg","model_url":"https://fal.run/bytedance/seedance-2.0/image-to-video","license_type":"commercial","date":"2026-04-01T18:47:20.614Z","group":{"key":"seedance-2.0-fal","label":"Image to Video"},"highlighted":false,"kind":"inference","pinned":false},"openapi":{"openapi":"3.0.4","info":{"title":"Queue OpenAPI for bytedance/seedance-2.0/image-to-video","version":"1.0.0","description":"The OpenAPI schema for the bytedance/seedance-2.0/image-to-video queue.","x-fal-metadata":{"endpointId":"bytedance/seedance-2.0/image-to-video","category":"image-to-video","thumbnailUrl":"https://v3b.fal.media/files/b/0a9c2f2b/C5HNQz1oux7K-6Tqfd_-9_c4a7c912a6db402686fe2c01591a1687.jpg","playgroundUrl":"https://fal.ai/models/bytedance/seedance-2.0/image-to-video","documentationUrl":"https://fal.ai/models/bytedance/seedance-2.0/image-to-video/api","about":"Image 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"]},"Seedance20ImageToVideoInput":{"required":["prompt","image_url"],"x-fal-order-properties":["prompt","image_url","end_image_url","resolution","duration","aspect_ratio","generate_audio","bitrate_mode","end_user_id"],"title":"Seedance2I2VInput","type":"object","properties":{"image_url":{"description":"The URL of the starting frame image to animate. Supported formats: JPEG, PNG, WebP. Max 30 MB.","title":"Image Url","examples":["https://v3b.fal.media/files/b/0a8eba37/Cqg-4Uwzyz4DELfceT1CF_a17e588773ec45b1a9e6f100a787b80b.jpg"],"type":"string"},"prompt":{"description":"The text prompt describing the desired motion and action for the video.","title":"Prompt","examples":["An octopus finds a football in the ocean and excitedly calls its octopus friends to come and play. Cut scene to an octopus football game under the sea."],"type":"string"},"generate_audio":{"description":"Whether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech. The cost of video generation is the same regardless of whether audio is generated or not.","title":"Generate Audio","type":"boolean","default":true},"bitrate_mode":{"description":"Output bitrate mode. 'high' requests a higher-quality, larger-file encode from the model; 'standard' uses the default bitrate.","title":"Bitrate Mode","examples":["standard"],"type":"string","default":"standard","enum":["standard","high"]},"duration":{"description":"Duration of the video in seconds. Supports 4 to 15 seconds, or auto to let the model decide based on the prompt.","type":"string","title":"Duration","default":"auto","enum":["auto","4","5","6","7","8","9","10","11","12","13","14","15"]},"resolution":{"description":"Video resolution - 480p for faster generation, 720p for balance, 1080p for high quality, 4k for highest quality.","type":"string","title":"Resolution","default":"720p","enum":["480p","720p","1080p","4k"]},"end_user_id":{"description":"The unique user ID of the end user.","title":"End User Id","anyOf":[{"type":"string"},{"type":"null"}]},"end_image_url":{"description":"The URL of the image to use as the last frame of the video. When provided, the generated video will transition from the starting image to this ending image. Supported formats: JPEG, PNG, WebP. Max 30 MB.","title":"End Image Url","anyOf":[{"type":"string"},{"type":"null"}]},"aspect_ratio":{"description":"The aspect ratio of the generated video. Use 16:9 for landscape, 9:16 for portrait/vertical, 1:1 for square, 21:9 for ultrawide cinematic, or auto to infer from the input image.","title":"Aspect Ratio","type":"string","default":"auto","enum":["auto","21:9","16:9","4:3","1:1","3:4","9:16"]}}},"Seedance20ImageToVideoOutput":{"required":["video","seed"],"x-fal-order-properties":["video","seed"],"title":"Seedance2VideoOutput","type":"object","properties":{"video":{"description":"The generated video file.","$ref":"#/components/schemas/File","examples":[{"url":"https://storage.googleapis.com/falserverless/example_outputs/bytedance/seedance_2/output.mp4"}]},"seed":{"description":"The seed used for generation.","title":"Seed","examples":[42],"type":"integer"}}},"File":{"required":["url"],"x-fal-order-properties":["url","content_type","file_name","file_size"],"title":"File","type":"object","properties":{"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"},"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"}]}}}}},"paths":{"/bytedance/seedance-2.0/image-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"}}}}}}},"/bytedance/seedance-2.0/image-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."}}}}}}}}},"/bytedance/seedance-2.0/image-to-video":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Seedance20ImageToVideoInput"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/bytedance/seedance-2.0/image-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/Seedance20ImageToVideoOutput"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}},{"endpoint_id":"bytedance/seedance-2.0/reference-to-video","metadata":{"display_name":"Seedance 2 Reference to Video","category":"image-to-video","description":"ByteDance's most advanced reference-to-video model. Generate video from up to 9 images, 3 videos, and 3 audio clips with native audio and cinematic camera control.","status":"active","tags":["stylized","transform","lipsync"],"updated_at":"2026-07-01T20:49:35.883Z","is_favorited":null,"thumbnail_url":"https://v3b.fal.media/files/b/0a9c2f1a/nie2992p9QXZaJbgszHZY_d584fa3e77b44d57a33417a48fac06ab.jpg","model_url":"https://fal.run/bytedance/seedance-2.0/reference-to-video","license_type":"commercial","date":"2026-04-01T18:48:22.239Z","group":{"key":"seedance-2.0-fal","label":"Reference to Video"},"highlighted":false,"kind":"inference","pinned":false},"openapi":{"openapi":"3.0.4","info":{"title":"Queue OpenAPI for bytedance/seedance-2.0/reference-to-video","version":"1.0.0","description":"The OpenAPI schema for the bytedance/seedance-2.0/reference-to-video queue.","x-fal-metadata":{"endpointId":"bytedance/seedance-2.0/reference-to-video","category":"image-to-video","thumbnailUrl":"https://v3b.fal.media/files/b/0a9c2f1a/nie2992p9QXZaJbgszHZY_d584fa3e77b44d57a33417a48fac06ab.jpg","playgroundUrl":"https://fal.ai/models/bytedance/seedance-2.0/reference-to-video","documentationUrl":"https://fal.ai/models/bytedance/seedance-2.0/reference-to-video/api","about":"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"]},"Seedance20ReferenceToVideoInput":{"required":["prompt"],"x-fal-order-properties":["prompt","image_urls","video_urls","audio_urls","resolution","duration","aspect_ratio","generate_audio","bitrate_mode","end_user_id"],"title":"Seedance2R2VInput","type":"object","properties":{"prompt":{"description":"The text prompt used to generate the video.","title":"Prompt","examples":["An octopus finds a football in the ocean and excitedly calls its octopus friends to come and play. Cut scene to an octopus football game under the sea."],"type":"string"},"generate_audio":{"description":"Whether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech. The cost of video generation is the same regardless of whether audio is generated or not.","title":"Generate Audio","type":"boolean","default":true},"audio_urls":{"description":"Reference audio to guide video generation. Refer to them in the prompt as @Audio1, @Audio2, etc. Supported formats: MP3, WAV. Up to 3 files, combined duration must not exceed 15 seconds. Max 15 MB per file. At least one reference image or video is required.","type":"array","maxItems":3,"items":{"_fal_ui_field":"audio","type":"string"},"title":"Audio Urls"},"bitrate_mode":{"description":"Output bitrate mode. 'high' requests a higher-quality, larger-file encode from the model; 'standard' uses the default bitrate.","title":"Bitrate Mode","examples":["standard"],"type":"string","default":"standard","enum":["standard","high"]},"video_urls":{"description":"Reference videos to guide video generation. Refer to them in the prompt as @Video1, @Video2, etc. Supported formats: MP4, MOV. Up to 3 videos, combined duration must be between 2 and 15 seconds, total size under 50 MB. Each video must be between ~480p (640x640) and ~720p (834x1112) in resolution.","type":"array","maxItems":3,"items":{"_fal_ui_field":"video","type":"string"},"title":"Video Urls"},"duration":{"description":"Duration of the video in seconds. Supports 4 to 15 seconds, or auto to let the model decide based on the prompt.","type":"string","title":"Duration","default":"auto","enum":["auto","4","5","6","7","8","9","10","11","12","13","14","15"]},"resolution":{"description":"Video resolution - 480p for faster generation, 720p for balance, 1080p for high quality, 4k for highest quality.","type":"string","title":"Resolution","default":"720p","enum":["480p","720p","1080p","4k"]},"end_user_id":{"description":"The unique user ID of the end user.","title":"End User Id","anyOf":[{"type":"string"},{"type":"null"}]},"image_urls":{"title":"Image Urls","description":"Reference images to guide video generation. Refer to them in the prompt as @Image1, @Image2, etc. Supported formats: JPEG, PNG, WebP. Max 30 MB per image. Up to 9 images. Total files across all modalities must not exceed 12.","type":"array","examples":[["https://v3b.fal.media/files/b/0a8eba37/Cqg-4Uwzyz4DELfceT1CF_a17e588773ec45b1a9e6f100a787b80b.jpg"]],"items":{"type":"string"},"maxItems":9},"aspect_ratio":{"description":"The aspect ratio of the generated video. Use 16:9 for landscape, 9:16 for portrait/vertical, 1:1 for square, 21:9 for ultrawide cinematic, or auto to let the model decide.","title":"Aspect Ratio","type":"string","default":"auto","enum":["auto","21:9","16:9","4:3","1:1","3:4","9:16"]}}},"Seedance20ReferenceToVideoOutput":{"required":["video","seed"],"x-fal-order-properties":["video","seed"],"title":"Seedance2VideoOutput","type":"object","properties":{"video":{"description":"The generated video file.","$ref":"#/components/schemas/File","examples":[{"url":"https://storage.googleapis.com/falserverless/example_outputs/bytedance/seedance_2/output.mp4"}]},"seed":{"description":"The seed used for generation.","title":"Seed","examples":[42],"type":"integer"}}},"File":{"required":["url"],"x-fal-order-properties":["url","content_type","file_name","file_size"],"title":"File","type":"object","properties":{"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"},"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"}]}}}}},"paths":{"/bytedance/seedance-2.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"}}}}}}},"/bytedance/seedance-2.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."}}}}}}}}},"/bytedance/seedance-2.0/reference-to-video":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Seedance20ReferenceToVideoInput"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/bytedance/seedance-2.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/Seedance20ReferenceToVideoOutput"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}}],"next_cursor":"Mg","has_more":true}