@flatkey-ai/cli 0.1.19 → 0.1.21

package/README.md

@@ -92,6 +92,12 @@ flatkey image generate \
   -o cover.png
 ```
 
+Upload a local image and get a temporary signed URL:
+
+```bash
+flatkey image upload --file ./reference.png
+```
+
 ### Generate Video
 
 ```bash
@@ -106,6 +112,27 @@ flatkey video generate \
 Video ratios: `16:9`, `9:16`, `4:3`, `3:4`, `21:9`, `1:1`.
 Video resolutions: `480p`, `720p`, `1080p`.
 
+Local reference images are uploaded through Flatkey temporary media first:
+
+```bash
+flatkey video generate \
+  --model Seedance2.0-pro \
+  --prompt "a sleepy kitten, soft window light" \
+  --image ./reference.png \
+  -o kitten.mp4
+```
+
+First/last frame:
+
+```bash
+flatkey video generate \
+  --model Seedance2.0-pro \
+  --prompt "slow camera push-in" \
+  --first-frame ./first.png \
+  --last-frame ./last.png \
+  -o transition.mp4
+```
+
 ### Generate Audio
 
 Text to speech:
@@ -196,6 +223,8 @@ Agent rules:
 - Prefer `FLATKEY_API_KEY`.
 - Always pass `--json` for machine-readable output.
 - Use `--output` / `-o` when the generated file path matters.
+- Use `flatkey image upload --file <path>` for a temporary signed image URL.
+- Use `--image`, `--first-frame`, or `--last-frame` to pass local images into video generation.
 - Call `flatkey models --json` before choosing a model.
 - Call `flatkey audio voices --json` before choosing a TTS `voice_id`.
 - Use `--dry-run` to inspect request shape without spending credits.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flatkey-ai/cli",
-  "version": "0.1.19",
+  "version": "0.1.21",
   "description": "Flatkey media generation CLI for image, video, audio, credits, status, and models.",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -15,7 +15,7 @@ const COMMANDS = new Set([
 ]);
 
 const GROUP_ACTIONS = new Set(["audio", "auth", "image", "text", "video"]);
-const GLOBAL_OPTIONS = new Set(["api_key", "base_url", "dry_run", "help", "json", "output", "out"]);
+const GLOBAL_OPTIONS = new Set(["api_key", "base_url", "console_url", "dry_run", "help", "json", "output", "out"]);
 const REPEATABLE_OPTIONS = new Set(["image", "image_url", "video_url"]);
 const COMMAND_OPTIONS = {
   "audio generate": new Set(["model", "prompt", "similarity_boost", "stability", "style", "voice_id"]),
@@ -414,14 +414,14 @@ async function handleImageUpload(command, deps) {
     env: deps.env ?? process.env,
     configDir: deps.configDir,
   });
-  const { routerOrigin } = await resolveOrigins({
-    baseUrl: command.options.base_url,
+  const { consoleOrigin } = await resolveOrigins({
+    consoleUrl: command.options.console_url,
     env: deps.env ?? process.env,
     configDir: deps.configDir,
   });
   const response = await uploadTempMediaImage({
     apiKey,
-    baseUrl: routerOrigin,
+    baseUrl: consoleOrigin,
     file: await readFile(await expandHomePath(file)),
     filename: basename(file),
     fetch: deps.fetch,
@@ -467,8 +467,14 @@ async function handleGenerate(command, deps) {
         env: deps.env ?? process.env,
         configDir: deps.configDir,
       });
-  const { routerOrigin } = await resolveOrigins({
+  const { routerOrigin, consoleOrigin } = await resolveOrigins({
     baseUrl: command.options.base_url,
+    consoleUrl: command.options.console_url,
+    env: deps.env ?? process.env,
+    configDir: deps.configDir,
+  });
+  const { consoleOrigin: tempMediaBaseUrl } = await resolveOrigins({
+    consoleUrl: command.options.console_url,
     env: deps.env ?? process.env,
     configDir: deps.configDir,
   });
@@ -476,6 +482,7 @@ async function handleGenerate(command, deps) {
     ...command.options,
     apiKey,
     baseUrl: routerOrigin,
+    tempMediaBaseUrl: tempMediaBaseUrl ?? consoleOrigin,
     env: deps.env ?? process.env,
     fetch: deps.fetch,
   };
@@ -560,7 +567,7 @@ async function uploadLocalImage(file, options, deps) {
   const { readFile } = await import("node:fs/promises");
   const response = await deps.uploadTempMediaImage({
     apiKey: options.apiKey,
-    baseUrl: options.baseUrl,
+    baseUrl: options.tempMediaBaseUrl ?? options.baseUrl,
     file: await readFile(await expandHomePath(file)),
     filename: basename(file),
     fetch: options.fetch,