{"models":[{"endpoint_id":"fal-ai/minimax/hailuo-2.3/pro/image-to-video","metadata":{"display_name":"MiniMax Hailuo 2.3 [Pro] (Image to Video)","category":"image-to-video","description":"MiniMax Hailuo-2.3 Image To Video API (Pro, 1080p): Advanced image-to-video generation model with 1080p resolution","status":"active","tags":["image-to-video"],"updated_at":"2026-04-21T17:52:03.713Z","is_favorited":null,"thumbnail_url":"https://v3b.fal.media/files/b/elephant/tFrccsrBCt7X_80Je77Ie_a073f11dc9354f5eab801768841430a9.jpg","model_url":"https://fal.run/fal-ai/minimax/hailuo-2.3/pro/image-to-video","license_type":"commercial","date":"2025-10-27T13:16:08.044Z","group":{"key":"hailuo-23","label":"Image To 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/minimax/hailuo-2.3/pro/image-to-video","version":"1.0.0","description":"The OpenAPI schema for the fal-ai/minimax/hailuo-2.3/pro/image-to-video queue.","x-fal-metadata":{"endpointId":"fal-ai/minimax/hailuo-2.3/pro/image-to-video","category":"image-to-video","thumbnailUrl":"https://v3b.fal.media/files/b/elephant/tFrccsrBCt7X_80Je77Ie_a073f11dc9354f5eab801768841430a9.jpg","playgroundUrl":"https://fal.ai/models/fal-ai/minimax/hailuo-2.3/pro/image-to-video","documentationUrl":"https://fal.ai/models/fal-ai/minimax/hailuo-2.3/pro/image-to-video/api","about":"Image To Video Hailuo 23 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"]},"MinimaxHailuo23ProImageToVideoInput":{"properties":{"prompt":{"examples":["The camera follows the mountain biker as they navigate a technical forest trail at high speed, wheels bouncing over roots and rocks. The rider approaches a jump, launching into the air with the bike, both rider and machine perfectly synchronized. They land smoothly and continue through tight turns, splashing through a stream crossing. Mud and water spray as the bike powers through challenging terrain. The atmosphere is wild and adventurous. Audio: Tires gripping dirt, gears shifting, heavy breathing, branches whipping past, and water splashing."],"maxLength":2000,"description":"Text prompt for video generation","minLength":1,"title":"Prompt","type":"string"},"enable_safety_checker":{"default":true,"description":"Authorized callers may set false to request relaxed screening.","title":"Enable Safety Checker","type":"boolean"},"image_url":{"examples":["https://storage.googleapis.com/falserverless/example_inputs/hailuo23/pro_i2v_in.jpg"],"description":"URL of the image to use as the first frame","_fal_ui_field":"image","title":"Image Url","type":"string"},"prompt_optimizer":{"default":true,"description":"Whether to use the model's prompt optimizer","title":"Prompt Optimizer","type":"boolean"}},"x-fal-order-properties":["enable_safety_checker","prompt","prompt_optimizer","image_url"],"required":["prompt","image_url"],"title":"ProImageToVideoHailuo23Input","type":"object"},"MinimaxHailuo23ProImageToVideoOutput":{"properties":{"video":{"examples":[{"url":"https://storage.googleapis.com/falserverless/example_outputs/hailuo23/pro_i2v_out.mp4"}],"$ref":"#/components/schemas/File","description":"The generated video"}},"x-fal-order-properties":["video"],"required":["video"],"title":"ProImageToVideoHailuo23Output","type":"object"},"File":{"properties":{"content_type":{"examples":["image/png"],"title":"Content Type","anyOf":[{"type":"string"},{"type":"null"}],"description":"The mime type of the file."},"url":{"description":"The URL where the file can be downloaded from.","title":"Url","type":"string"},"file_size":{"examples":[4404019],"title":"File Size","anyOf":[{"type":"integer"},{"type":"null"}],"description":"The size of the file in bytes."},"file_name":{"examples":["z9RV14K95DvU.png"],"title":"File Name","anyOf":[{"type":"string"},{"type":"null"}],"description":"The name of the file. It will be auto-generated if not provided."}},"x-fal-order-properties":["url","content_type","file_name","file_size"],"required":["url"],"title":"File","type":"object"}}},"paths":{"/fal-ai/minimax/hailuo-2.3/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/minimax/hailuo-2.3/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/minimax/hailuo-2.3/pro/image-to-video":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MinimaxHailuo23ProImageToVideoInput"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/fal-ai/minimax/hailuo-2.3/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/MinimaxHailuo23ProImageToVideoOutput"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}},{"endpoint_id":"fal-ai/vidu/q4/reference-to-video","metadata":{"display_name":"Vidu Q4 Reference to Video","category":"image-to-video","description":"Vidu Q4 generates videos from up to 12 reference images and 3 voice clips, keeping characters, objects, and voices consistent across up to 16 seconds at up to 4K.","status":"active","tags":["reference-to-video","multi-shot","4k"],"updated_at":"2026-10-20T22:52:00.319Z","is_favorited":null,"thumbnail_url":"https://v3b.fal.media/files/b/0aad2f50/VDsdBXEj3Vk134o2SqAVM.jpg","model_url":"https://fal.run/fal-ai/vidu/q4/reference-to-video","license_type":"commercial","date":"2026-10-05T17:06:55.931Z","group":{"key":"Vidu Q4","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 fal-ai/vidu/q4/reference-to-video","version":"1.0.0","description":"Vidu Q4 Reference-to-Video builds a scene from your references. You tag up to 12 images (characters, products, objects, locations) and up to 3 voice clips directly in the prompt, and the model keeps each subject and voice consistent throughout the clip. It supports optional native audio with dialogue and sound effects, durations from 3 to 16 seconds, five aspect ratios, and output from 540p up to 4K, which makes it well suited for branded content, character-driven storytelling, and ads.","x-fal-metadata":{"endpointId":"fal-ai/vidu/q4/reference-to-video","category":"image-to-video","thumbnailUrl":"https://v3b.fal.media/files/b/0aad2f50/VDsdBXEj3Vk134o2SqAVM.jpg","playgroundUrl":"https://fal.ai/models/fal-ai/vidu/q4/reference-to-video","documentationUrl":"https://fal.ai/models/fal-ai/vidu/q4/reference-to-video/api","about":"Vidu Q4 Preview Reference to Video API: Generate a video from reference images and voices."}},"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"]},"ViduQ4ReferenceToVideoInput":{"required":["prompt"],"type":"object","x-fal-order-properties":["prompt","reference_image_urls","reference_audio_urls","duration","seed","aspect_ratio","resolution","audio","enable_safety_checker"],"properties":{"reference_image_urls":{"description":"URLs or base64 data URIs of up to 12 reference images (png, jpeg, jpg, webp) used to keep subjects consistent.","type":"array","title":"Reference Image Urls","items":{"type":"string"},"examples":[["https://storage.googleapis.com/falserverless/web-examples/vidu/new-examples/reference1.png","https://storage.googleapis.com/falserverless/web-examples/vidu/new-examples/reference2.png"]]},"audio":{"default":false,"description":"Whether to generate audio (dialogue and sound effects) with the video. When false, the output video is silent.","type":"boolean","title":"Audio"},"aspect_ratio":{"enum":["16:9","9:16","4:3","3:4","1:1"],"default":"16:9","description":"The aspect ratio of the output video","type":"string","title":"Aspect Ratio"},"resolution":{"enum":["540p","720p","1080p","2K","4K"],"default":"720p","description":"Output video resolution","type":"string","title":"Resolution"},"enable_safety_checker":{"default":true,"description":"Authorized callers may set false to request relaxed screening.","type":"boolean","title":"Enable Safety Checker"},"reference_audio_urls":{"description":"URLs or base64 data URIs of up to 3 mp3 reference audio clips (3-12 seconds each, max 50 MB) used to keep voices consistent.","type":"array","title":"Reference Audio Urls","items":{"type":"string"}},"prompt":{"minLength":1,"examples":["[@reference_image_1] walks along the beach at sunset holding [@reference_image_2], then turns to the camera and speaks in the voice of [reference_audio_1]."],"type":"string","maxLength":5000,"description":"Text prompt for video generation, max 5000 characters. Refer to references by their position in the lists: [@reference_image_1], [@reference_image_2], ... for images and [reference_audio_1], [reference_audio_2], ... for audio clips.","title":"Prompt"},"duration":{"minimum":3,"default":5,"description":"Duration of the video in seconds (3-16)","type":"integer","title":"Duration","maximum":16},"seed":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Random seed for reproducibility. If None, a random seed is chosen.","title":"Seed"}},"title":"Q4ReferenceToVideoRequest"},"ViduQ4ReferenceToVideoOutput":{"required":["video","seed"],"type":"object","x-fal-order-properties":["video","cover_image","seed"],"properties":{"cover_image":{"anyOf":[{"$ref":"#/components/schemas/Image"},{"type":"null"}],"description":"Cover image of the generated video"},"video":{"$ref":"#/components/schemas/File","examples":[{"url":"https://v3b.fal.media/files/b/0a8c9189/n9z3uUDPqmU2msAtqr25-_output.mp4"}],"description":"The generated video from references using the Q4 Preview model"},"seed":{"description":"The random seed used for generation","type":"integer","title":"Seed"}},"title":"Q4ReferenceToVideoOutput"},"Image":{"title":"Image","required":["url"],"description":"Represents an image file.","type":"object","x-fal-order-properties":["url","content_type","file_name","file_size","width","height"],"properties":{"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The height of the image in pixels.","examples":[1024],"title":"Height"},"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 Name"},"url":{"description":"The URL where the file can be downloaded from.","type":"string","title":"Url"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The width of the image in pixels.","examples":[1024],"title":"Width"},"file_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The size of the file in bytes.","examples":[4404019],"title":"File Size"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The mime type of the file.","examples":["image/png"],"title":"Content Type"}}},"File":{"required":["url"],"type":"object","x-fal-order-properties":["url","content_type","file_name","file_size"],"properties":{"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 Name"},"url":{"description":"The URL where the file can be downloaded from.","type":"string","title":"Url"},"file_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The size of the file in bytes.","examples":[4404019],"title":"File Size"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The mime type of the file.","examples":["image/png"],"title":"Content Type"}},"title":"File"}}},"paths":{"/fal-ai/vidu/q4/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"}}}}}}},"/fal-ai/vidu/q4/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."}}}}}}}}},"/fal-ai/vidu/q4/reference-to-video":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ViduQ4ReferenceToVideoInput"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/fal-ai/vidu/q4/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/ViduQ4ReferenceToVideoOutput"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}},{"endpoint_id":"fal-ai/vidu/q4/image-to-video","metadata":{"display_name":"Vidu Q4","category":"image-to-video","description":"Vidu Q4 turns a first-frame image into 3 to 16 second videos with native audio at up to 4K. Best for animating stills, product shots and character scenes with dialogue.","status":"active","tags":["image-to-video","multi-shot","4k"],"updated_at":"2026-10-20T22:51:59.857Z","is_favorited":null,"thumbnail_url":"https://v3b.fal.media/files/b/0aad2f3f/cmmJZ_YhOejfcxze6tBG6.jpg","model_url":"https://fal.run/fal-ai/vidu/q4/image-to-video","license_type":"commercial","date":"2026-10-05T17:04:50.200Z","group":{"key":"Vidu Q4","label":"Image 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/vidu/q4/image-to-video","version":"1.0.0","description":"Vidu Q4 Image-to-Video animates a start frame into a high-fidelity clip while preserving the subject and composition of the source image. Prompts can direct motion, camera cuts, and spoken dialogue, and native audio adds synchronized speech and sound effects. It supports durations from 3 to 16 seconds and output from 540p up to 4K.","x-fal-metadata":{"endpointId":"fal-ai/vidu/q4/image-to-video","category":"image-to-video","thumbnailUrl":"https://v3b.fal.media/files/b/0aad2f3f/cmmJZ_YhOejfcxze6tBG6.jpg","playgroundUrl":"https://fal.ai/models/fal-ai/vidu/q4/image-to-video","documentationUrl":"https://fal.ai/models/fal-ai/vidu/q4/image-to-video/api","about":"Vidu Q4 Image to Video API: Generate a video with audio from a first-frame image."}},"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"]},"ViduQ4ImageToVideoInput":{"required":["image_url"],"type":"object","x-fal-order-properties":["prompt","image_url","duration","seed","resolution","enable_safety_checker"],"properties":{"image_url":{"description":"URL or base64 data URI of the image to use as the first frame. Supports png, jpeg, jpg and webp up to 50 MB.","type":"string","title":"Image Url","examples":["https://storage.googleapis.com/falserverless/web-examples/vidu/stylish_woman.webp"]},"prompt":{"title":"Prompt","default":"","examples":["The woman turns toward the camera and smiles, then the shot cuts to a close-up as she says: \"Let's go.\""],"type":"string","maxLength":5000,"description":"Text prompt for video generation, max 5000 characters"},"duration":{"minimum":3,"default":5,"description":"Duration of the video in seconds (3-16)","type":"integer","title":"Duration","maximum":16},"resolution":{"enum":["540p","720p","1080p","2K","4K"],"default":"720p","description":"Output video resolution","type":"string","title":"Resolution"},"enable_safety_checker":{"default":true,"description":"Authorized callers may set false to request relaxed screening.","type":"boolean","title":"Enable Safety Checker"},"seed":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Random seed for reproducibility. If None, a random seed is chosen.","title":"Seed"}},"title":"Q4ImageToVideoRequest"},"ViduQ4ImageToVideoOutput":{"required":["video","seed"],"type":"object","x-fal-order-properties":["video","cover_image","seed"],"properties":{"cover_image":{"anyOf":[{"$ref":"#/components/schemas/Image"},{"type":"null"}],"description":"Cover image of the generated video"},"video":{"$ref":"#/components/schemas/File","examples":[{"url":"https://v3b.fal.media/files/b/0a8c9189/n9z3uUDPqmU2msAtqr25-_output.mp4"}],"description":"The generated video from image using the Q4 model"},"seed":{"description":"The random seed used for generation","type":"integer","title":"Seed"}},"title":"Q4ImageToVideoOutput"},"Image":{"title":"Image","required":["url"],"description":"Represents an image file.","type":"object","x-fal-order-properties":["url","content_type","file_name","file_size","width","height"],"properties":{"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The height of the image in pixels.","examples":[1024],"title":"Height"},"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 Name"},"url":{"description":"The URL where the file can be downloaded from.","type":"string","title":"Url"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The width of the image in pixels.","examples":[1024],"title":"Width"},"file_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The size of the file in bytes.","examples":[4404019],"title":"File Size"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The mime type of the file.","examples":["image/png"],"title":"Content Type"}}},"File":{"required":["url"],"type":"object","x-fal-order-properties":["url","content_type","file_name","file_size"],"properties":{"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 Name"},"url":{"description":"The URL where the file can be downloaded from.","type":"string","title":"Url"},"file_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The size of the file in bytes.","examples":[4404019],"title":"File Size"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The mime type of the file.","examples":["image/png"],"title":"Content Type"}},"title":"File"}}},"paths":{"/fal-ai/vidu/q4/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/vidu/q4/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/vidu/q4/image-to-video":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ViduQ4ImageToVideoInput"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/fal-ai/vidu/q4/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/ViduQ4ImageToVideoOutput"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}},{"endpoint_id":"alibaba/happy-horse/v1.1/image-to-video","metadata":{"display_name":"Happy Horse 1.1 Image to Video","category":"image-to-video","description":"Happy Horse 1.1 is Alibaba's #1-ranked video model. This image-to-video endpoint animates a still image into 1080p video with synchronized native audio and multilingual lip-sync","status":"active","tags":["happy-horse","video","image"],"updated_at":"2026-10-20T22:26:50.861Z","is_favorited":null,"thumbnail_url":"https://v3b.fal.media/files/b/0a9f396f/HeOG8Txxcrw0irt78kQYt_108f8bf0e80940b49fe4a66cb732e3af.jpg","model_url":"https://fal.run/alibaba/happy-horse/v1.1/image-to-video","license_type":"commercial","date":"2026-06-21T19:49:12.948Z","group":{"key":"happy-horse-1.1","label":"Image to Video"},"highlighted":false,"kind":"inference","pinned":false},"retires_at":null,"replacement":null,"openapi":{"openapi":"3.1.0","info":{"title":"Queue OpenAPI for alibaba/happy-horse/v1.1/image-to-video","version":"1.0.0","description":"The OpenAPI schema for the alibaba/happy-horse/v1.1/image-to-video queue.","x-fal-metadata":{"endpointId":"alibaba/happy-horse/v1.1/image-to-video","category":"image-to-video","thumbnailUrl":"https://v3b.fal.media/files/b/0a9f396f/HeOG8Txxcrw0irt78kQYt_108f8bf0e80940b49fe4a66cb732e3af.jpg","playgroundUrl":"https://fal.ai/models/alibaba/happy-horse/v1.1/image-to-video","documentationUrl":"https://fal.ai/models/alibaba/happy-horse/v1.1/image-to-video/api","about":"Animate a still image using the Happy Horse 1.1 image-to-video model\n(``happyhorse-1.1-i2v``).\n\nThe provided ``image_url`` is used as the first frame. Image must be\nat least 300px in width and height, with an aspect ratio between\n1:2.5 and 2.5:1, up to 20 MB (JPEG, JPG, PNG, BMP, or WEBP)."}},"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"]},"HappyHorseV11ImageToVideoInput":{"required":["image_url"],"description":"Input for Happy Horse 1.1 image-to-video generation (first frame only).\n\nIdentical to 1.0 except the first-frame image may be up to 20 MB (1.0\ncaps at 10 MB).","type":"object","x-fal-order-properties":["image_url","prompt","resolution","duration","seed","enable_safety_checker"],"properties":{"image_url":{"examples":["https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png"],"type":"string","title":"Image Url","description":"URL of the first frame image. Formats: JPEG, JPG, PNG, BMP, WEBP. Dimensions must be at least 300px. Aspect ratio must be between 1:2.5 and 2.5:1. Max 20 MB."},"prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"examples":["Bring the scene in the image to life."],"description":"Optional text prompt guiding the animation. Max 2500 characters.","title":"Prompt"},"duration":{"enum":[3,4,5,6,7,8,9,10,11,12,13,14,15],"default":5,"description":"Output video duration in seconds (3-15).","type":"integer","title":"Duration","examples":[5,10,15]},"resolution":{"enum":["720p","1080p"],"default":"1080p","description":"Output video resolution tier.","type":"string","title":"Resolution"},"enable_safety_checker":{"default":true,"description":"Enable content moderation for input and output. Disabling it requires account authorization; unauthorized requests are always checked.","type":"boolean","title":"Enable Safety Checker"},"seed":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Random seed for reproducibility (0-2147483647).","title":"Seed"}},"title":"HappyHorse15ImageToVideoInput"},"HappyHorseV11ImageToVideoOutput":{"properties":{"video":{"$ref":"#/components/schemas/VideoFile","description":"The generated video file."},"seed":{"description":"The seed used for generation.","title":"Seed","type":"integer"}},"x-fal-order-properties":["video","seed"],"description":"Output for Happy Horse video generation.","required":["video","seed"],"title":"HappyHorseOutput","type":"object"},"VideoFile":{"properties":{"duration":{"title":"Duration","anyOf":[{"type":"number"},{"type":"null"}],"description":"The duration of the video"},"file_name":{"examples":["z9RV14K95DvU.png"],"title":"File Name","anyOf":[{"type":"string"},{"type":"null"}],"description":"The name of the file. It will be auto-generated if not provided."},"width":{"title":"Width","anyOf":[{"type":"integer"},{"type":"null"}],"description":"The width of the video"},"file_size":{"examples":[4404019],"title":"File Size","anyOf":[{"type":"integer"},{"type":"null"}],"description":"The size of the file in bytes."},"fps":{"title":"Fps","anyOf":[{"type":"number"},{"type":"null"}],"description":"The FPS of the video"},"height":{"title":"Height","anyOf":[{"type":"integer"},{"type":"null"}],"description":"The height of the video"},"content_type":{"examples":["image/png"],"title":"Content Type","anyOf":[{"type":"string"},{"type":"null"}],"description":"The mime type of the file."},"url":{"description":"The URL where the file can be downloaded from.","title":"Url","type":"string"},"num_frames":{"title":"Num Frames","anyOf":[{"type":"integer"},{"type":"null"}],"description":"The number of frames in the video"}},"x-fal-order-properties":["url","content_type","file_name","file_size","width","height","fps","duration","num_frames"],"required":["url"],"title":"VideoFile","type":"object"}}},"paths":{"/alibaba/happy-horse/v1.1/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"}}}}}}},"/alibaba/happy-horse/v1.1/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."}}}}}}}}},"/alibaba/happy-horse/v1.1/image-to-video":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HappyHorseV11ImageToVideoInput"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/alibaba/happy-horse/v1.1/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/HappyHorseV11ImageToVideoOutput"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}},{"endpoint_id":"fal-ai/bytedance/omnihuman","metadata":{"display_name":"OmniHuman","category":"image-to-video","description":"OmniHuman generates video using an image of a human figure paired with an audio file. It produces vivid, high-quality videos where the character’s emotions and movements maintain a strong correlation with the audio.","status":"active","tags":["image-to-video","lipsync"],"updated_at":"2026-04-21T17:44:31.854Z","is_favorited":null,"thumbnail_url":"https://storage.googleapis.com/fal_cdn/fal/Sound.jpg","model_url":"https://fal.run/fal-ai/bytedance/omnihuman","license_type":"commercial","date":"2025-07-27T12:18:13.247Z","highlighted":false,"kind":"inference","pinned":false},"retires_at":null,"replacement":null,"openapi":{"openapi":"3.1.0","info":{"title":"Queue OpenAPI for fal-ai/bytedance/omnihuman","version":"1.0.0","description":"The OpenAPI schema for the fal-ai/bytedance/omnihuman queue.","x-fal-metadata":{"endpointId":"fal-ai/bytedance/omnihuman","category":"image-to-video","thumbnailUrl":"https://storage.googleapis.com/fal_cdn/fal/Sound.jpg","playgroundUrl":"https://fal.ai/models/fal-ai/bytedance/omnihuman","documentationUrl":"https://fal.ai/models/fal-ai/bytedance/omnihuman/api","about":"Generate incredibly accurate videos of human beings speaking a dialogue using Bytednce's OmniHuman model.\n\nThis endpoint allows you to provide an image of a human along with an audio file\nto generate a video. The model will animate the image based on the audio."}},"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"]},"BytedanceOmnihumanInput":{"required":["image_url","audio_url"],"type":"object","x-fal-order-properties":["image_url","audio_url"],"properties":{"image_url":{"description":"The URL of the image used to generate the video","type":"string","title":"Image Url","examples":["https://storage.googleapis.com/falserverless/example_inputs/omnihuman.png"]},"audio_url":{"description":"The URL of the audio file to generate the video. Audio must be under 30s long.","type":"string","title":"Audio Url","examples":["https://storage.googleapis.com/falserverless/example_inputs/omnihuman_audio.mp3"]}},"title":"OmniHumanInput"},"BytedanceOmnihumanOutput":{"required":["video","duration"],"type":"object","x-fal-order-properties":["video","duration"],"properties":{"video":{"$ref":"#/components/schemas/File","description":"Generated video file","examples":[{"url":"https://storage.googleapis.com/falserverless/example_outputs/omnihuman_output.mp4"}]},"duration":{"description":"Duration of audio input/video output as used for billing.","type":"number","title":"Duration"}},"title":"OmniHumanOutput"},"File":{"required":["url"],"type":"object","x-fal-order-properties":["url","content_type","file_name","file_size"],"properties":{"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 Name"},"url":{"description":"The URL where the file can be downloaded from.","type":"string","title":"Url"},"file_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The size of the file in bytes.","examples":[4404019],"title":"File Size"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The mime type of the file.","examples":["image/png"],"title":"Content Type"}},"title":"File"}}},"paths":{"/fal-ai/bytedance/omnihuman/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/omnihuman/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/omnihuman":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BytedanceOmnihumanInput"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/fal-ai/bytedance/omnihuman/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/BytedanceOmnihumanOutput"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}},{"endpoint_id":"bytedance/seedance-2.0/us/image-to-video","metadata":{"display_name":"Seedance 2.0 US Image to Video","category":"image-to-video","description":"US hosted version of 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-10-29T22:03:01.259Z","is_favorited":null,"thumbnail_url":"https://v3b.fal.media/files/b/0aaa8c0f/moIjOdx9iGvFio-n6ROjH.jpg","model_url":"https://fal.run/bytedance/seedance-2.0/us/image-to-video","license_type":"commercial","date":"2026-09-15T16:56:27.143Z","group":{"key":"seedance-us","label":"Image to Video"},"highlighted":false,"kind":"inference","pinned":false},"retires_at":null,"replacement":null,"openapi":{"openapi":"3.1.0","info":{"title":"Queue OpenAPI for bytedance/seedance-2.0/us/image-to-video","version":"1.0.0","description":"The OpenAPI schema for the bytedance/seedance-2.0/us/image-to-video queue.","x-fal-metadata":{"endpointId":"bytedance/seedance-2.0/us/image-to-video","category":"image-to-video","thumbnailUrl":"https://v3b.fal.media/files/b/0aaa8c0f/moIjOdx9iGvFio-n6ROjH.jpg","playgroundUrl":"https://fal.ai/models/bytedance/seedance-2.0/us/image-to-video","documentationUrl":"https://fal.ai/models/bytedance/seedance-2.0/us/image-to-video/api","about":"Us 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"]},"Seedance20UsImageToVideoInput":{"required":["prompt","image_url"],"type":"object","title":"Seedance2I2VUSInput","properties":{"image_url":{"examples":["https://v3b.fal.media/files/b/0a8eba37/Cqg-4Uwzyz4DELfceT1CF_a17e588773ec45b1a9e6f100a787b80b.jpg"],"type":"string","title":"Image Url","description":"The URL of the starting frame image to animate. Supported formats: JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF. Max 30 MB."},"bitrate_mode":{"enum":["standard","high"],"default":"standard","examples":["standard"],"type":"string","title":"Bitrate Mode","description":"Output bitrate mode. 'high' requests a higher-quality, larger-file encode from the model; 'standard' uses the default bitrate."},"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, BMP, TIFF, GIF, HEIC, HEIF. Max 30 MB.","title":"End Image Url"},"codec":{"enum":["auto","H264","H265"],"default":"auto","examples":["auto","H264","H265"],"type":"string","title":"Codec","description":"'auto' retains default video codec behaviour; 'H264' uses H.264; 'H265' uses H.265."},"resolution":{"enum":["480p","720p","1080p","4k"],"default":"720p","description":"Video resolution - 480p for faster generation, 720p for balance, 1080p for high quality, 4k for highest quality.","type":"string","title":"Resolution"},"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","title":"Generate Audio"},"aspect_ratio":{"enum":["auto","21:9","16:9","4:3","1:1","3:4","9:16"],"default":"auto","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.","type":"string","title":"Aspect Ratio"},"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","title":"Prompt","description":"The text prompt describing the desired motion and action for the video."},"end_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The unique user ID of the end user.","title":"End User Id"},"duration":{"enum":["auto","4","5","6","7","8","9","10","11","12","13","14","15"],"default":"auto","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"}},"x-fal-order-properties":["prompt","image_url","end_image_url","resolution","duration","aspect_ratio","generate_audio","bitrate_mode","codec","end_user_id"]},"Seedance20UsImageToVideoOutput":{"required":["video","seed"],"type":"object","title":"Seedance2VideoOutput","properties":{"video":{"$ref":"#/components/schemas/File","examples":[{"url":"https://storage.googleapis.com/falserverless/example_outputs/bytedance/seedance_2/output.mp4"}],"description":"The generated video file."},"seed":{"examples":[42],"type":"integer","title":"Seed","description":"The seed used for generation."}},"x-fal-order-properties":["video","seed"]},"File":{"required":["url"],"type":"object","title":"File","properties":{"file_name":{"anyOf":[{"type":"string"},{"type":"null"}],"examples":["z9RV14K95DvU.png"],"description":"The name of the file. It will be auto-generated if not provided.","title":"File Name"},"url":{"description":"The URL where the file can be downloaded from.","type":"string","title":"Url"},"file_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"examples":[4404019],"description":"The size of the file in bytes.","title":"File Size"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"examples":["image/png"],"description":"The mime type of the file.","title":"Content Type"}},"x-fal-order-properties":["url","content_type","file_name","file_size"]}}},"paths":{"/bytedance/seedance-2.0/us/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/us/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/us/image-to-video":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Seedance20UsImageToVideoInput"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/bytedance/seedance-2.0/us/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/Seedance20UsImageToVideoOutput"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}},{"endpoint_id":"fal-ai/vidu/q3/image-to-video","metadata":{"display_name":"Vidu","category":"image-to-video","description":"Vidu's latest Q3 pro models.","status":"active","tags":["image-to-video"],"updated_at":"2026-10-20T22:37:20.568Z","is_favorited":null,"thumbnail_url":"https://v3b.fal.media/files/b/0a8c915a/He8Pvpz77hcWVcUYC5hRZ_98109f8630944133a904fad6fe3a701d.jpg","model_url":"https://fal.run/fal-ai/vidu/q3/image-to-video","license_type":"commercial","date":"2026-01-31T07:34:05.888Z","group":{"key":"Vidu Q3","label":"Image 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/vidu/q3/image-to-video","version":"1.0.0","description":"The OpenAPI schema for the fal-ai/vidu/q3/image-to-video queue.","x-fal-metadata":{"endpointId":"fal-ai/vidu/q3/image-to-video","category":"image-to-video","thumbnailUrl":"https://v3b.fal.media/files/b/0a8c915a/He8Pvpz77hcWVcUYC5hRZ_98109f8630944133a904fad6fe3a701d.jpg","playgroundUrl":"https://fal.ai/models/fal-ai/vidu/q3/image-to-video","documentationUrl":"https://fal.ai/models/fal-ai/vidu/q3/image-to-video/api","about":"Vidu Q3 Image to Video API: Generate a video from a single image using the Q3 model."}},"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"]},"ViduQ3ImageToVideoInput":{"required":["image_url"],"type":"object","x-fal-order-properties":["enable_safety_checker","prompt","image_url","end_image_url","duration","seed","resolution","audio"],"properties":{"image_url":{"description":"URL or base64 image to use as the starting frame","type":"string","title":"Image Url","examples":["https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png"]},"audio":{"default":true,"description":"Whether to use direct audio-video generation. When true, outputs video with sound (including dialogue and sound effects).","type":"boolean","title":"Audio"},"end_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"URL of the image to use as the ending frame. When provided, generates a transition video between start and end frames.","title":"End Image Url"},"resolution":{"enum":["360p","540p","720p","1080p"],"default":"720p","description":"Output video resolution. Note: 360p is not available when end_image_url is provided.","type":"string","title":"Resolution"},"enable_safety_checker":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":true,"description":"Enable safety checks; disabling requires authorization.","title":"Enable Safety Checker","hidden":true},"prompt":{"title":"Prompt","default":"","examples":["The astronaut waved and the camera moved up."],"type":"string","maxLength":2000,"description":"Text prompt for video generation, max 2000 characters"},"duration":{"minimum":1,"default":5,"description":"Duration of the video in seconds (1-16 for Q3 models)","type":"integer","title":"Duration","maximum":16},"seed":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Random seed for reproducibility. If None, a random seed is chosen.","title":"Seed"}},"title":"Q3ImageToVideoRequest"},"ViduQ3ImageToVideoOutput":{"required":["video"],"type":"object","x-fal-order-properties":["video"],"properties":{"video":{"$ref":"#/components/schemas/File","examples":[{"url":"https://v3b.fal.media/files/b/0a8c9189/n9z3uUDPqmU2msAtqr25-_output.mp4"}],"description":"The generated video from image using the Q3 model"}},"title":"Q3ImageToVideoOutput"},"File":{"required":["url"],"type":"object","x-fal-order-properties":["url","content_type","file_name","file_size"],"properties":{"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 Name"},"url":{"description":"The URL where the file can be downloaded from.","type":"string","title":"Url"},"file_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The size of the file in bytes.","examples":[4404019],"title":"File Size"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The mime type of the file.","examples":["image/png"],"title":"Content Type"}},"title":"File"}}},"paths":{"/fal-ai/vidu/q3/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/vidu/q3/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/vidu/q3/image-to-video":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ViduQ3ImageToVideoInput"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/fal-ai/vidu/q3/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/ViduQ3ImageToVideoOutput"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}},{"endpoint_id":"fal-ai/kling-video/o3/4k/image-to-video","metadata":{"display_name":"Kling Video","category":"image-to-video","description":"Kling's Native 4K is a video generation model that directly outputs professional-grade 4K video in one step, eliminating the need for post-production upscaling","status":"active","tags":["stylized","transform","lipsync"],"updated_at":"2026-04-26T22:25:17.147Z","is_favorited":null,"thumbnail_url":"https://v3b.fal.media/files/b/0a9740be/nUTPtoiXouNNHisPlCKB6_4c0365b62d0c413dbd5c12152b7d1fc5.jpg","model_url":"https://fal.run/fal-ai/kling-video/o3/4k/image-to-video","license_type":"commercial","date":"2026-04-22T08:32:21.551Z","group":{"key":"kling-o3","label":"Image to Video (4K)"},"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/4k/image-to-video","version":"1.0.0","description":"The OpenAPI schema for the fal-ai/kling-video/o3/4k/image-to-video queue.","x-fal-metadata":{"endpointId":"fal-ai/kling-video/o3/4k/image-to-video","category":"image-to-video","thumbnailUrl":"https://v3b.fal.media/files/b/0a9740be/nUTPtoiXouNNHisPlCKB6_4c0365b62d0c413dbd5c12152b7d1fc5.jpg","playgroundUrl":"https://fal.ai/models/fal-ai/kling-video/o3/4k/image-to-video","documentationUrl":"https://fal.ai/models/fal-ai/kling-video/o3/4k/image-to-video/api","about":"Generate a video from image using O3 model (4k mode).\n\nO3 4k produces ultra-high-resolution output with start/end frames and\nnative audio. Only the Singapore server supports this mode."}},"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"]},"KlingVideoO34kImageToVideoInput":{"properties":{"generate_audio":{"type":"boolean","description":"Whether to generate native audio for the video.","default":false,"title":"Generate Audio"},"multi_prompt":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/KlingV3MultiPromptElement"}},{"type":"null"}],"description":"List of prompts for multi-shot video generation.","examples":[null],"title":"Multi Prompt"},"prompt":{"anyOf":[{"type":"string","maxLength":2500},{"type":"null"}],"description":"Text prompt for video generation. Either prompt or multi_prompt must be provided, but not both.","examples":["The character walks forward slowly, with the camera following from behind."],"title":"Prompt"},"enable_safety_checker":{"type":"boolean","description":"Disabling safety checks requires account authorization; unauthorized requests are always checked.","default":true,"title":"Enable Safety Checker"},"duration":{"type":"string","description":"Video duration in seconds (3-15s).","examples":["10"],"default":"5","title":"Duration","enum":["3","4","5","6","7","8","9","10","11","12","13","14","15"]},"end_image_url":{"anyOf":[{"type":"string","_fal_ui_field":"image","ui":{"field":"image"},"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_aspect_ratio":2.5,"max_file_size":52428800,"min_aspect_ratio":0.4,"min_width":300,"min_height":300,"timeout":20}},{"type":"null"}],"description":"URL of the end frame image (optional).","title":"End Image Url"},"shot_type":{"type":"string","description":"The type of multi-shot video generation. 'intelligent' lets the model automatically determine shot structure.","default":"customize","title":"Shot Type","enum":["customize","intelligent"]},"image_url":{"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_aspect_ratio":2.5,"max_file_size":52428800,"min_aspect_ratio":0.4,"min_width":300,"min_height":300,"timeout":20},"type":"string","_fal_ui_field":"image","examples":["https://v3b.fal.media/files/b/0a8cfd5a/8ABMp4n9rh3kfD2Rq8fHd_start_frame.png"],"description":"URL of the start frame image.","title":"Image Url"}},"type":"object","x-fal-order-properties":["enable_safety_checker","prompt","image_url","end_image_url","duration","generate_audio","multi_prompt","shot_type"],"title":"O3_4kImageToVideoInput","required":["image_url"]},"KlingVideoO34kImageToVideoOutput":{"properties":{"video":{"$ref":"#/components/schemas/File","description":"The generated video.","examples":[{"content_type":"video/mp4","file_size":12037975,"url":"https://v3b.fal.media/files/b/0a8d0278/pgIO9yOXTFCTetKBsqDwX_output.mp4","file_name":"output.mp4"}]}},"type":"object","x-fal-order-properties":["video"],"title":"O3_4kImageToVideoOutput","required":["video"]},"KlingV3MultiPromptElement":{"properties":{"duration":{"type":"string","description":"The duration of this shot in seconds","default":"5","title":"Duration","enum":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15"]},"prompt":{"type":"string","description":"The prompt for this shot.","title":"Prompt"}},"type":"object","x-fal-order-properties":["prompt","duration"],"title":"KlingV3MultiPromptElement","required":["prompt"]},"File":{"properties":{"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The mime type of the file.","examples":["image/png"],"title":"Content Type"},"url":{"type":"string","description":"The URL where the file can be downloaded from.","title":"Url"},"file_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The size of the file in bytes.","examples":[4404019],"title":"File Size"},"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 Name"}},"type":"object","x-fal-order-properties":["url","content_type","file_name","file_size"],"title":"File","required":["url"]}}},"paths":{"/fal-ai/kling-video/o3/4k/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/o3/4k/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/o3/4k/image-to-video":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KlingVideoO34kImageToVideoInput"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/fal-ai/kling-video/o3/4k/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/KlingVideoO34kImageToVideoOutput"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}},{"endpoint_id":"fal-ai/wan/v2.7/reference-to-video","metadata":{"display_name":"Wan 2.7 Reference to Video","category":"image-to-video","description":"Wan 2.7 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-04-26T23:07:28.840Z","is_favorited":null,"thumbnail_url":"https://v3b.fal.media/files/b/0a940488/7aXOy6uHTo2EHtaZX89Uj_f2a95842752d4ef999d2b00006960480.jpg","model_url":"https://fal.run/fal-ai/wan/v2.7/reference-to-video","license_type":"commercial","date":"2026-03-28T20:44:41.245Z","group":{"key":"Wan27","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 fal-ai/wan/v2.7/reference-to-video","version":"1.0.0","description":"The OpenAPI schema for the fal-ai/wan/v2.7/reference-to-video queue.","x-fal-metadata":{"endpointId":"fal-ai/wan/v2.7/reference-to-video","category":"image-to-video","thumbnailUrl":"https://v3b.fal.media/files/b/0a940488/7aXOy6uHTo2EHtaZX89Uj_f2a95842752d4ef999d2b00006960480.jpg","playgroundUrl":"https://fal.ai/models/fal-ai/wan/v2.7/reference-to-video","documentationUrl":"https://fal.ai/models/fal-ai/wan/v2.7/reference-to-video/api","about":"Generate video from reference images/videos using WAN 2.7 R2V model.\n\nSupports single-character performances and multi-character interactions.\nAlso supports multi-shot narration via the multi_shots parameter."}},"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"]},"WanV27ReferenceToVideoInput":{"x-fal-order-properties":["prompt","reference_image_urls","reference_video_urls","negative_prompt","aspect_ratio","resolution","duration","multi_shots","seed","enable_safety_checker"],"type":"object","title":"Wan27ReferenceToVideoInput","description":"Input for Wan 2.7 reference-to-video generation.\n\nSupports single or multi-character video generation from reference images\nand/or videos. Also supports multi-shot narration.","required":["prompt"],"properties":{"prompt":{"minLength":1,"title":"Prompt","description":"Text prompt describing the desired video. Max 5000 characters.","examples":["A person walking through a beautiful garden, cinematic style."],"type":"string"},"seed":{"title":"Seed","description":"Random seed for reproducibility (0-2147483647).","anyOf":[{"type":"integer"},{"type":"null"}]},"duration":{"type":"integer","title":"Duration","default":5,"description":"Output video duration in seconds (2-10).","examples":[5,10],"enum":[2,3,4,5,6,7,8,9,10]},"reference_video_urls":{"title":"Reference Video Urls","description":"Reference video URLs for character/object appearance and motion. Pass multiple videos for multi-subject generation. Max 100 MB each.","anyOf":[{"items":{"_fal_ui_field":"video","ui":{"field":"video"},"limit_description":"Max file size: 100.0MB, Max duration: 30s, Timeout: 30.0s","x-fal":{"timeout":30,"max_duration":30,"max_file_size":104857600},"type":"string"},"type":"array"},{"type":"null"}]},"negative_prompt":{"title":"Negative Prompt","description":"Content to avoid in the video. Max 500 characters.","examples":["low resolution, errors, worst quality, low quality"],"anyOf":[{"type":"string"},{"type":"null"}]},"reference_image_urls":{"title":"Reference Image Urls","description":"Reference image URLs for character/object appearance. Pass multiple images for multi-subject generation. Max 20 MB each.","anyOf":[{"items":{"_fal_ui_field":"image","ui":{"field":"image"},"type":"string"},"type":"array"},{"type":"null"}]},"aspect_ratio":{"type":"string","title":"Aspect Ratio","default":"16:9","description":"Aspect ratio of the generated video.","enum":["16:9","9:16","1:1","4:3","3:4"]},"resolution":{"type":"string","title":"Resolution","default":"1080p","description":"Output video resolution tier.","enum":["720p","1080p"]},"multi_shots":{"title":"Multi Shots","default":false,"description":"When true, enables intelligent multi-shot segmentation. When false (default), generates a single continuous shot.","type":"boolean"},"enable_safety_checker":{"title":"Enable Safety Checker","default":true,"description":"Enable content moderation for input and output. Disabling it requires account authorization; unauthorized requests are always checked.","type":"boolean"}}},"WanV27ReferenceToVideoOutput":{"x-fal-order-properties":["video","seed","actual_prompt"],"type":"object","title":"Wan27ReferenceToVideoOutput","description":"Output for Wan 2.7 reference-to-video generation.","required":["video","seed"],"properties":{"actual_prompt":{"title":"Actual Prompt","description":"The actual prompt used if prompt rewriting was enabled.","anyOf":[{"type":"string"},{"type":"null"}]},"video":{"$ref":"#/components/schemas/VideoFile","description":"The generated video file."},"seed":{"title":"Seed","description":"The seed used for generation.","type":"integer"}}},"VideoFile":{"properties":{"duration":{"title":"Duration","anyOf":[{"type":"number"},{"type":"null"}],"description":"The duration of the video"},"file_name":{"examples":["z9RV14K95DvU.png"],"title":"File Name","anyOf":[{"type":"string"},{"type":"null"}],"description":"The name of the file. It will be auto-generated if not provided."},"height":{"title":"Height","anyOf":[{"type":"integer"},{"type":"null"}],"description":"The height of the video"},"file_size":{"examples":[4404019],"title":"File Size","anyOf":[{"type":"integer"},{"type":"null"}],"description":"The size of the file in bytes."},"fps":{"title":"Fps","anyOf":[{"type":"number"},{"type":"null"}],"description":"The FPS of the video"},"width":{"title":"Width","anyOf":[{"type":"integer"},{"type":"null"}],"description":"The width of the video"},"content_type":{"examples":["image/png"],"title":"Content Type","anyOf":[{"type":"string"},{"type":"null"}],"description":"The mime type of the file."},"url":{"type":"string","title":"Url","description":"The URL where the file can be downloaded from."},"num_frames":{"title":"Num Frames","anyOf":[{"type":"integer"},{"type":"null"}],"description":"The number of frames in the video"}},"x-fal-order-properties":["url","content_type","file_name","file_size","width","height","fps","duration","num_frames"],"required":["url"],"title":"VideoFile","type":"object"}}},"paths":{"/fal-ai/wan/v2.7/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"}}}}}}},"/fal-ai/wan/v2.7/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."}}}}}}}}},"/fal-ai/wan/v2.7/reference-to-video":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WanV27ReferenceToVideoInput"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/fal-ai/wan/v2.7/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/WanV27ReferenceToVideoOutput"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}},{"endpoint_id":"fal-ai/kling-video/o1/reference-to-video","metadata":{"display_name":"Kling O1 Reference Image to Video [Pro]","category":"image-to-video","description":"Transform images, elements, and text into consistent, high-quality video scenes, ensuring stable character identity, object details, and environments.","status":"active","tags":[],"updated_at":"2026-04-26T22:25:17.147Z","is_favorited":null,"thumbnail_url":"https://v3b.fal.media/files/b/kangaroo/L7EgH8_I_ZIngBtpKaL-Y_ca0bcf7b2c8f4319b8af7dc386bdb3d9.jpg","model_url":"https://fal.run/fal-ai/kling-video/o1/reference-to-video","license_type":"commercial","date":"2025-12-01T11:37:01.777Z","group":{"key":"kling-video/o1","label":"Reference I2V [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/o1/reference-to-video","version":"1.0.0","description":"The OpenAPI schema for the fal-ai/kling-video/o1/reference-to-video queue.","x-fal-metadata":{"endpointId":"fal-ai/kling-video/o1/reference-to-video","category":"image-to-video","thumbnailUrl":"https://v3b.fal.media/files/b/kangaroo/L7EgH8_I_ZIngBtpKaL-Y_ca0bcf7b2c8f4319b8af7dc386bdb3d9.jpg","playgroundUrl":"https://fal.ai/models/fal-ai/kling-video/o1/reference-to-video","documentationUrl":"https://fal.ai/models/fal-ai/kling-video/o1/reference-to-video/api","about":"Generate a video from a start frame image with optional references and elements.\n\nThe image defines the first frame of the video. You can optionally add\nreference images for style/appearance and elements for characters/objects."}},"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"]},"KlingVideoO1ReferenceToVideoInput":{"properties":{"enable_safety_checker":{"type":"boolean","description":"Disabling safety checks requires account authorization; unauthorized requests are always checked.","default":true,"title":"Enable Safety Checker"},"duration":{"type":"string","description":"Video duration in seconds.","default":"5","title":"Duration","enum":["3","4","5","6","7","8","9","10"]},"prompt":{"type":"string","description":"Take @Element1, @Element2 to reference elements and @Image1, @Image2 to reference images in order.","examples":["Take @Image1 as the start frame. Start with a high-angle satellite view of the ancient greenhouse ruin surrounded by nature. The camera swoops down and flies inside the building, revealing the character from @Element1 standing in the sun-drenched center. The camera then seamlessly transitions into a smooth 180-degree orbit around the character, moving to the back view. As the open backpack comes into focus, the camera continues to push forward, zooming deep inside the bag to reveal the glowing stone from @Element2 nestled inside. Cinematic lighting, hopeful atmosphere, 35mm lens. Make sure to keep it as the style of @Image2."],"title":"Prompt","maxLength":2500},"image_urls":{"anyOf":[{"type":"array","items":{"type":"string","_fal_ui_field":"image","ui":{"field":"image"},"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_aspect_ratio":2.5,"max_file_size":52428800,"min_aspect_ratio":0.4,"min_width":300,"min_height":300,"timeout":20}}},{"type":"null"}],"description":"Additional reference images for style/appearance. Reference in prompt as @Image1, @Image2, etc. Maximum 7 total (elements + reference images + start image).","examples":[["https://v3b.fal.media/files/b/koala/v9COzzH23FGBYdGLgbK3u.png","https://v3b.fal.media/files/b/elephant/5Is2huKQFSE7A7c5uUeUF.png"]],"title":"Image Urls"},"elements":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/OmniVideoElementInput"}},{"type":"null"}],"description":"Elements (characters/objects) to include in the video. Reference in prompt as @Element1, @Element2, etc. Maximum 7 total (elements + reference images + start image).","examples":[[{"frontal_image_url":"https://v3b.fal.media/files/b/panda/MQp-ghIqshvMZROKh9lW3.png","reference_image_urls":["https://v3b.fal.media/files/b/kangaroo/YMpmQkYt9xugpOTQyZW0O.png","https://v3b.fal.media/files/b/zebra/d6ywajNyJ6bnpa_xBue-K.png"]},{"frontal_image_url":"https://v3b.fal.media/files/b/koala/gSnsA7HJlgcaTyR5Ujj2H.png","reference_image_urls":["https://v3b.fal.media/files/b/kangaroo/EBF4nWihspyv4pp6hgj7D.png"]}]],"title":"Elements"},"aspect_ratio":{"type":"string","description":"The aspect ratio of the generated video frame.","default":"16:9","title":"Aspect Ratio","enum":["16:9","9:16","1:1"]}},"type":"object","description":"Input for start-frame video generation with optional reference images and elements.","x-fal-order-properties":["enable_safety_checker","prompt","image_urls","elements","duration","aspect_ratio"],"title":"OmniVideoReferenceToVideoInput","required":["prompt"]},"KlingVideoO1ReferenceToVideoOutput":{"properties":{"video":{"$ref":"#/components/schemas/File","description":"The generated video.","examples":[{"content_type":"video/mp4","file_size":47359974,"url":"https://v3b.fal.media/files/b/panda/oVdiICFXY03Vbam-08Aj8_output.mp4","file_name":"output.mp4"}]}},"type":"object","x-fal-order-properties":["video"],"title":"OmniVideoReferenceToVideoOutput","required":["video"]},"OmniVideoElementInput":{"properties":{"frontal_image_url":{"type":"string","description":"The frontal image of the element (main view).\n\nMax file size: 50.0MB, Min width: 300px, Min height: 300px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Timeout: 20.0s","title":"Frontal Image Url","x-fal":{"max_aspect_ratio":2.5,"max_file_size":52428800,"min_aspect_ratio":0.4,"min_width":300,"min_height":300,"timeout":20}},"reference_image_urls":{"type":"array","description":"Additional reference images from different angles. 1-3 images supported. At least one image is required.","items":{"type":"string","_fal_ui_field":"image","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_aspect_ratio":2.5,"max_file_size":52428800,"min_aspect_ratio":0.4,"min_width":300,"min_height":300,"timeout":20}},"title":"Reference Image Urls"}},"type":"object","x-fal-order-properties":["frontal_image_url","reference_image_urls"],"title":"OmniVideoElementInput","required":["frontal_image_url"]},"File":{"properties":{"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The mime type of the file.","examples":["image/png"],"title":"Content Type"},"url":{"type":"string","description":"The URL where the file can be downloaded from.","title":"Url"},"file_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The size of the file in bytes.","examples":[4404019],"title":"File Size"},"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 Name"}},"type":"object","x-fal-order-properties":["url","content_type","file_name","file_size"],"title":"File","required":["url"]}}},"paths":{"/fal-ai/kling-video/o1/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"}}}}}}},"/fal-ai/kling-video/o1/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."}}}}}}}}},"/fal-ai/kling-video/o1/reference-to-video":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KlingVideoO1ReferenceToVideoInput"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/fal-ai/kling-video/o1/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/KlingVideoO1ReferenceToVideoOutput"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}}],"next_cursor":"MTA","has_more":true}