Image to Video

animate a single fashion, pet or product photo into a short shareable video clip (5 or 10 seconds; 9:16, 1:1 or 16:9). Use when the user wants to make a photo move, turn a picture into a video, or create a short clip for social media.

Overview

Item	Value
Command	`tufty image-to-video`
Type	Video
Required inputs	`--still` still image, exactly 1
Optional inputs	None
Output	Video: 5 or 10 seconds

Parameters

Flag	Description	Choices	Default
`--still <file\|url...>`	Still images for the video: local path, data: URL or http(s) URL	exactly 1	—
`--duration <seconds>`	Video length in seconds	`5`, `10`	`5`
`--ratio <id>`	Aspect ratio	`9:16`, `1:1`, `16:9`	`9:16`
`--resolution <id>`	Output resolution; see pricing below	`720P`	`720P`
`--notes <text>`	Extra instructions for this run, free text up to 2000 characters	—	—
`--no-cutout`	Skip the automatic cutout of input images (saves 1 credit per image)	Switch	cutout on
`--dry-run`	Validate and print the payload and credit estimate; no upload, no charge	Switch	—
`--no-wait`	Return the `runId` right after submitting	Switch	wait
`--timeout <seconds>`	Maximum seconds to wait for the run	positive number	`900`
`--save <dir>`	Download the outputs into this directory	—	—
`--format <mode>`	Stdout format: full envelope, or one URL per line	`json`, `url`	`json`

Pricing

Resolution	Credits per second	5 s	10 s
`720P`	19.05	95	191

Total = round(price per second × --duration), plus 1 credit per still for the automatic cutout.

Prices as of September 15, 2026; they may change. tufty tools describe image-to-video always shows the current ones, and --dry-run prints the exact estimate. See Credits.

Examples

A 5-second vertical clip from a lookbook photo

tufty image-to-video --still ./lookbook.jpg --duration 5 --ratio 9:16

10-second square clip with motion direction; return immediately and poll later

tufty image-to-video --still ./cat-in-sweater.png --duration 10 --ratio 1:1 --notes "the cat turns its head and blinks" --no-wait

Wait for a run submitted with --no-wait

tufty status <runId> --wait

Output example

{
  "ok": true,
  "result": {
    "tool": "image-to-video",
    "runId": "3f6c2a1e-8b4d-4e7a-9c55-0d2b7e1f4a90",
    "status": "completed",
    "outputs": [
      {
        "type": "video",
        "url": "https://static.tufty.ai/.../result.mp4"
      }
    ]
  }
}

With --save <dir> each output also has path; with --no-wait, status is running and outputs is empty. See Output modes.

Tips

Video runs take several minutes. With --no-wait, poll with tufty status <runId> --wait.
Use --notes to describe the motion you want.

On this page