Skip to main content
Endpoint: POST https://fal.run/fal-ai/sora-2/image-to-video Endpoint ID: fal-ai/sora-2/image-to-video

Try it in the Playground

Run this model interactively with your own prompts.

Quick Start

Input Schema

string
required
The text prompt describing the video you want to generate
ResolutionEnum
default:"auto"
The resolution of the generated video Default value: "auto"Possible values: auto, 720p
AspectRatioEnum
default:"auto"
The aspect ratio of the generated video Default value: "auto"Possible values: auto, 9:16, 16:9
DurationEnum
default:"4"
Duration of the generated video in seconds Default value: "4"Possible values: 4, 8, 12, 16, 20
boolean
default:"true"
Whether to delete the video after generation for privacy reasons. If True, the video cannot be used for remixing and will be permanently deleted. Default value: true
ModelEnum
default:"sora-2"
The model to use for the generation. When the default model is selected, the latest snapshot of the model will be used - otherwise, select a specific snapshot of the model. Default value: "sora-2"Possible values: sora-2, sora-2-2025-12-08, sora-2-2025-10-06
boolean
default:"false"
If enabled, the prompt (and image for image-to-video) will be checked for known intellectual property references and the request will be blocked if any are detected.
list<string>
Up to two character IDs (from create-character) to use in the video. Refer to characters by name in the prompt. When set, only the OpenAI provider is used.
string
required
The URL of the image to use as the first frame

Output Schema

VideoFile
required
The generated video
string
required
The ID of the generated video
ImageFile
Thumbnail image for the video
ImageFile
Spritesheet image for the video

Input Example

Output Example

Limitations

  • resolution restricted to: auto, 720p
  • aspect_ratio restricted to: auto, 9:16, 16:9
  • duration restricted to: 4, 8, 12, 16, 20
  • model restricted to: sora-2, sora-2-2025-12-08, sora-2-2025-10-06
  • resolution restricted to: auto, 720p, 1080p, true_1080p