@shotstack/cli 0.8.4 → 0.10.0

package/README.md

@@ -141,6 +141,29 @@ shotstack template update <id> my-template.json --name "Promo v2"
 shotstack template delete <id>
 ```
 
+### `shotstack models [id]`
+
+Lists the generation models for prompt-driven image, video and audio assets, with whether your API key can use each one. A model your plan doesn't include shows why. Pass a model id to see the options it accepts.
+
+```sh
+shotstack models
+# → nano-banana-2  image  unavailable: AiCapabilityNotIncluded
+shotstack models seedance-2.0-text-to-video    # the JSON Schema for its options
+shotstack models --output json
+```
+
+### `shotstack generate <model> <prompt>`
+
+Generates one image, video or audio asset from a prompt and prints its URL, without rendering an edit. `--options` takes the model's options as a JSON object (see `shotstack models <model>`). `--length` sets the clip length in seconds for models that generate to a duration. Generation is billed in credits on stage as well as v1; `--quote` prints what that exact request would cost, without generating or charging. Identical requests share one job and its cached result, so repeating a request returns the same job instead of generating and charging again.
+
+```sh
+shotstack generate nano-banana-2 "A ceramic mug on a walnut desk, soft window light" --watch
+# → processing  8a1f2c3d-…
+# → done  https://…/8a1f2c3d.png
+shotstack generate seedance-2.0-text-to-video "Waves break over black sand at dusk" \
+  --options '{"resolution":"480p"}' --length 5 --watch --output json
+```
+
 ### `shotstack login` / `shotstack logout`
 
 Saves (or removes) your API key so it persists across shell sessions. Keys are stored per environment in `~/.shotstack/credentials.json`.