falImage to videoComing soon

nvidia/cosmos-3-super/image-to-video

Name: nvidia/cosmos-3-super/image-to-video
Brand: fal

nvidia/cosmos-3-super/image-to-video is an image to video tool from fal that runs in the background and returns video. Coming soon: listed with its price, not yet open to runs.

This tool is listed but not yet available to run.

Price pending

Pricing

Price pending.

Limits

Runs: In the background
Returns: video
Longest queue wait: 3600s
Run deadline: 3600s
Largest inline input: 1024 KB
Largest input file: 500 MB
Largest output: 4768 MB
Outputs per run: 16

Input

Field	Kind	Default	Description
`prompt` required	text	—	Text prompt describing the motion and scene of the video to generate.
`image_url` required	URL or file	—	URL of the conditioning first-frame image for the video.
`negative_prompt`	text	The video captures a series of frames showing macroblocking artifacts, chromatic aberration, high-frequency noise, and rolling shutter distortion. It includes static with no motion, motion blur, over-saturation, shaky footage, low resolution, grainy texture, pixelated images, poorly lit areas, underexposed and overexposed scenes, poor color balance, washed out colors, choppy sequences, jerky movements, low frame rate, bit-depth compression artifacts, color banding, unnatural transitions, outdated special effects, fake elements, unconvincing visuals, poorly edited content, jump cuts, hard cut, visual noise, and flickering. It features moiré patterns, edge halos, and temporal aliasing. Furthermore, the content defies common sense, generating illogical scenarios, nonsensical entities, absurd character behaviors, and conceptual paradoxes that violate basic human reasoning and everyday reality. The video looks like a surreal or glitchy hallucination. Overall, the video is of poor quality.	Content to steer the generation away from (artifacts, unwanted motion). Defaults to NVIDIA's recommended i2v negative prompt; pass an empty string to disable.
`enable_prompt_expansion`	true or false	true	If true, the Cosmos3-Nano Reasoner (a VLM that sees the first frame) rewrites the prompt into the dense caption Cosmos3 was trained on. The app starts a local Reasoner by default, or uses COSMOS_PROMPT_UPSAMPLER_BASE_URL when configured. Falls back to the raw prompt if expansion fails.
`enable_agentic_generation`	true or false	false	Enable the iterative Cosmos agentic loop: prompt upsampling, candidate video generation, VLM critique of sampled frames, and prompt rewrite. Each candidate is a full render, so this is substantially slower and costlier than a single generation.
`agentic_max_iterations`	number (whole) 1 to 3	2	Maximum agentic prompt stages when agentic generation is enabled.
`agentic_samples_per_iteration`	number (whole) 1 to 3	2	Candidate videos to generate and judge per agentic iteration. The best candidate advances to the next rewrite stage.
`agentic_early_stop`	true or false	true	Stop the agentic loop early when the critic score clears the strict quality threshold.
`image_size`	JSON	{"width":832,"height":480}	The size of the generated video. The request is clamped and snapped to the nearest supported NVIDIA tier (256p/480p/720p) and aspect ratio.
`num_frames`	number (whole) 5 to 189	189	Number of frames to generate. More frames yield a longer video.
`frames_per_second`	number (whole) 4 to 60	24	Frames per second of the output video.
`num_inference_steps`	number (whole) 1 to 50	28	Number of denoising steps. More steps yield higher quality but take longer.
`guidance_scale`	number 0 to 20	6	Classifier-free guidance scale. Higher values increase prompt adherence at the cost of diversity.
`seed`	number (whole)	—	The same seed and prompt given to the same model version will produce the same video every time.

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "nvidia/cosmos-3-super/image-to-video",
    "input": {
      "prompt": "The camera slowly pushes in as the subject turns their head toward the light, hair drifting in a gentle breeze, dust motes floating through warm afternoon sun.",
      "image_url": "https://storage.googleapis.com/falserverless/example_inputs/hunyuan_i2v.jpg"
    }
  }'