ツール
画像から動画
ファッション画像を動かして、シェアしやすいショート動画にします。
ファッション、ペット、商品の写真1枚を動かして、シェアしやすいショート動画（5秒または10秒、9:16・1:1・16:9）にします。写真を動かしたいとき、画像から動画を作りたいとき、SNS向けの短い動画を作りたいときに使います。
概要
| 項目 | 内容 |
|---|---|
| コマンド | tufty image-to-video |
| 種類 | 動画 |
| 必須の入力 | --still 静止画、ちょうど1枚 |
| 任意の入力 | なし |
| 出力 | 動画：5秒または10秒 |
パラメーター
| フラグ | 説明 | 選択肢 | デフォルト |
|---|---|---|---|
--still <file|url...> | 動画に使う静止画：ローカルのパス、data: URL、http(s)のURL | ちょうど1枚 | — |
--duration <seconds> | 動画の長さ（秒） | 5、10 | 5 |
--ratio <id> | アスペクト比 | 9:16、1:1、16:9 | 9:16 |
--resolution <id> | 出力の解像度。料金は下記を参照 | 720P | 720P |
--notes <text> | この実行の補足説明。最大2000文字の自由記述 | — | — |
--no-cutout | 入力画像の自動切り抜きを省略（1枚につき1クレジット節約） | スイッチ | 切り抜きあり |
--dry-run | 検証してペイロードとクレジットの見積もりを表示。アップロード・課金なし | スイッチ | — |
--no-wait | 送信直後にrunIdを返す | スイッチ | 待機する |
--timeout <seconds> | 実行を待機する最大秒数 | 正の数 | 900 |
--save <dir> | 生成物をこのディレクトリにダウンロード | — | — |
--format <mode> | 標準出力の形式：エンベロープ全体、または1行に1つのURL | json、url | json |
料金
| 解像度 | 1秒あたりのクレジット | 5秒 | 10秒 |
|---|---|---|---|
720P | 19.05 | 95 | 191 |
合計 ＝ round(1秒あたりの単価 × --duration)。これに自動切り抜きの費用として静止画1枚につき1クレジットが加算されます。
料金は2026年9月15日時点のもので、変わる場合があります。tufty tools describe image-to-videoで常に現在の料金を確認でき、--dry-runで正確な見積もりを表示できます。詳しくはクレジットを参照してください。
例
ルックブックの写真から5秒の縦型動画を作る
tufty image-to-video --still ./lookbook.jpg --duration 5 --ratio 9:16動きを指定した10秒の正方形動画。送信後すぐに戻り、あとで確認する
tufty image-to-video --still ./cat-in-sweater.png --duration 10 --ratio 1:1 --notes "猫が振り向いてまばたきする" --no-wait--no-waitで送信した実行を待機する
tufty status <runId> --wait出力例
{
"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"
}
]
}
}--save <dir>を使うと各生成物にpathも含まれます。--no-waitを使うとstatusはrunningになり、outputsは空になります。詳しくは出力モードを参照してください。
ヒント
- 動画の生成には数分かかります。
--no-waitを使った場合は、tufty status <runId> --waitで結果を取得してください。 --notesで、つけたい動きを説明してください。