Tools
Product Promo Video
Turn a product shot into a short promo cut.
cut one to nine product photos into a short promotional video (5 or 10 seconds, 720P or 1080P). Use when the user wants a product video, an ecommerce video ad, or a short promo clip made from product shots.
Overview
| Item | Value |
|---|---|
| Command | tufty product-promo |
| Type | Video |
| Required inputs | --still still image, 1–9 |
| 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 | 1–9 | — |
--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, 1080P | 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 | 31.75 | 159 | 318 |
1080P | 78.59 | 393 | 786 |
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 product-promo always shows the current ones, and --dry-run prints the exact estimate. See Credits.
Examples
Three angles of a bag into a 10-second 1080P vertical promo
tufty product-promo --still ./bag-1.jpg ./bag-2.jpg ./bag-3.jpg --duration 10 --resolution 1080P --ratio 9:16Check the credit cost of a 1080P run first
tufty product-promo --still ./sneaker.jpg --resolution 1080P --duration 10 --dry-runOutput example
{
"ok": true,
"result": {
"tool": "product-promo",
"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
- Several angles of the same product give the edit more to work with.
- Resolution is priced per second (see
--resolution); run with--dry-runto see the total.
