@flatkey-ai/cli 0.1.19 → 0.1.20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +29 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -92,6 +92,12 @@ flatkey image generate \
92
92
  -o cover.png
93
93
  ```
94
94
 
95
+ Upload a local image and get a temporary signed URL:
96
+
97
+ ```bash
98
+ flatkey image upload --file ./reference.png
99
+ ```
100
+
95
101
  ### Generate Video
96
102
 
97
103
  ```bash
@@ -106,6 +112,27 @@ flatkey video generate \
106
112
  Video ratios: `16:9`, `9:16`, `4:3`, `3:4`, `21:9`, `1:1`.
107
113
  Video resolutions: `480p`, `720p`, `1080p`.
108
114
 
115
+ Local reference images are uploaded through Flatkey temporary media first:
116
+
117
+ ```bash
118
+ flatkey video generate \
119
+ --model Seedance2.0-pro \
120
+ --prompt "a sleepy kitten, soft window light" \
121
+ --image ./reference.png \
122
+ -o kitten.mp4
123
+ ```
124
+
125
+ First/last frame:
126
+
127
+ ```bash
128
+ flatkey video generate \
129
+ --model Seedance2.0-pro \
130
+ --prompt "slow camera push-in" \
131
+ --first-frame ./first.png \
132
+ --last-frame ./last.png \
133
+ -o transition.mp4
134
+ ```
135
+
109
136
  ### Generate Audio
110
137
 
111
138
  Text to speech:
@@ -196,6 +223,8 @@ Agent rules:
196
223
  - Prefer `FLATKEY_API_KEY`.
197
224
  - Always pass `--json` for machine-readable output.
198
225
  - Use `--output` / `-o` when the generated file path matters.
226
+ - Use `flatkey image upload --file <path>` for a temporary signed image URL.
227
+ - Use `--image`, `--first-frame`, or `--last-frame` to pass local images into video generation.
199
228
  - Call `flatkey models --json` before choosing a model.
200
229
  - Call `flatkey audio voices --json` before choosing a TTS `voice_id`.
201
230
  - Use `--dry-run` to inspect request shape without spending credits.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@flatkey-ai/cli",
3
- "version": "0.1.19",
3
+ "version": "0.1.20",
4
4
  "description": "Flatkey media generation CLI for image, video, audio, credits, status, and models.",
5
5
  "type": "module",
6
6
  "bin": {