climage 0.4.1 → 0.5.0

package/README.md

@@ -100,11 +100,12 @@ Set one of:
 
 **Models:**
 
-| Model                 | Description                            |
-| --------------------- | -------------------------------------- |
-| `fal-ai/flux/dev`     | **Default.** Flux dev (fast & popular) |
-| `fal-ai/flux/pro`     | Flux pro (higher quality)              |
-| `fal-ai/flux-realism` | Photorealistic style                   |
+| Model                                      | Description                            |
+| ------------------------------------------ | -------------------------------------- |
+| `fal-ai/flux/dev`                          | **Default.** Flux dev (fast & popular) |
+| `fal-ai/flux/pro`                          | Flux pro (higher quality)              |
+| `fal-ai/flux-realism`                      | Photorealistic style                   |
+| `fal-ai/kling-video/v3/pro/image-to-video` | Kling v3 Pro image-to-video            |
 
 Example:
 
@@ -166,6 +167,9 @@ npx climage "the scene comes to life" --video --provider google --start-frame sc
 # Image-to-video with fal.ai
 npx climage "dramatic camera zoom" --video --provider fal --start-frame photo.jpg
 
+# Image-to-video with fal.ai Kling v3 Pro
+npx climage "dramatic camera zoom" --video --provider fal --model fal-ai/kling-video/v3/pro/image-to-video --start-frame photo.jpg
+
 # Image-to-video with xAI
 npx climage "animate this scene" --video --provider xai --start-frame cat.png
 ```
@@ -204,7 +208,9 @@ npx climage "character in motion" --video --provider fal --input ref1.png --inpu
 | Image-to-Video           | Yes    | Yes  | Yes    | No     |
 | Video Interpolation      | Yes    | No   | Yes    | No     |
 | Max Input Images         | 3      | 1    | 7      | 2      |
-| Video Duration (seconds) | 4-8    | 1-15 | 2-8    | N/A    |
+| Video Duration (seconds) | 4-8    | 1-15 | 2-15\* | N/A    |
+
+\* Model-specific on fal.ai (e.g. Vidu: 2-8, Kling v3 Pro: 3-15).
 
 ## Library API
 

package/dist/cli.js

@@ -285,8 +285,7 @@ async function generateXaiVideo(req, apiKey) {
     prompt: req.prompt,
     model,
     ...req.aspectRatio ? { aspect_ratio: req.aspectRatio } : {},
-    // Add image_url for image-to-video (data URI or URL string)
-    ...imageUrl ? { image_url: imageUrl } : {},
+    ...imageUrl ? { image: { url: imageUrl } } : {},
     // Add duration (xAI supports 1-15 seconds)
     ...req.duration !== void 0 ? { duration: req.duration } : {}
   };
@@ -294,7 +293,7 @@ async function generateXaiVideo(req, apiKey) {
     "Request body:",
     JSON.stringify({
       ...createBody,
-      image_url: createBody.image_url ? `...(${String(createBody.image_url).length} chars)` : void 0
+      image: createBody.image ? { url: `...(${String(createBody.image.url).length} chars)` } : void 0
     })
   );
   log("Calling xAI videos/generations...");
@@ -438,8 +437,15 @@ var DEFAULT_IMAGE_MODEL = "fal-ai/flux/dev";
 var DEFAULT_IMAGE_TO_IMAGE_MODEL = "fal-ai/flux/dev/image-to-image";
 var DEFAULT_VIDEO_MODEL = "fal-ai/ltxv-2/text-to-video/fast";
 var DEFAULT_IMAGE_TO_VIDEO_MODEL = "fal-ai/vidu/q2/image-to-video";
+var KLING_V3_PRO_IMAGE_TO_VIDEO_MODEL = "fal-ai/kling-video/v3/pro/image-to-video";
 var DEFAULT_START_END_VIDEO_MODEL = "fal-ai/vidu/start-end-to-video";
 var DEFAULT_REFERENCE_VIDEO_MODEL = "fal-ai/vidu/q2/reference-to-video";
+function isKlingV3Model(model) {
+  return model === KLING_V3_PRO_IMAGE_TO_VIDEO_MODEL || model.startsWith("fal-ai/kling-video/v3/");
+}
+function isViduModel(model) {
+  return model.includes("/vidu/");
+}
 function selectVideoModel(req) {
   if (req.model) return req.model;
   if (req.startFrame && req.endFrame) {
@@ -458,9 +464,12 @@ function selectImageModel(req) {
   if (req.inputImages?.length) return DEFAULT_IMAGE_TO_IMAGE_MODEL;
   return DEFAULT_IMAGE_MODEL;
 }
-function mapAspectRatio(aspectRatio) {
+function mapAspectRatio(aspectRatio, model) {
   if (!aspectRatio) return void 0;
   const ar = aspectRatio.trim();
+  if (model && isKlingV3Model(model)) {
+    return ar;
+  }
   if (ar === "1:1") return "square";
   if (ar === "4:3") return "landscape_4_3";
   if (ar === "16:9") return "landscape_16_9";
@@ -468,29 +477,50 @@ function mapAspectRatio(aspectRatio) {
   if (ar === "9:16") return "portrait_16_9";
   return ar;
 }
-function buildVideoInput(req) {
+function buildVideoInput(req, model) {
   const input = {
     prompt: req.prompt
   };
   if (req.startFrame && req.endFrame) {
     input.start_image_url = req.startFrame;
     input.end_image_url = req.endFrame;
+    const ar = mapAspectRatio(req.aspectRatio, model);
+    if (ar) input.aspect_ratio = ar;
+    if (req.duration) input.duration = String(req.duration);
     return input;
   }
   if (req.inputImages?.length && !req.startFrame) {
+    if (isKlingV3Model(model)) {
+      input.start_image_url = req.inputImages[0];
+      const ar2 = mapAspectRatio(req.aspectRatio, model);
+      if (ar2) input.aspect_ratio = ar2;
+      if (req.duration) input.duration = String(req.duration);
+      return input;
+    }
     input.reference_image_urls = req.inputImages.slice(0, 7);
-    const ar = mapAspectRatio(req.aspectRatio);
+    const ar = mapAspectRatio(req.aspectRatio, model);
     if (ar) input.aspect_ratio = ar;
     if (req.duration) input.duration = String(req.duration);
     return input;
   }
   const imageUrl = req.startFrame ?? req.inputImages?.[0];
   if (imageUrl) {
-    input.image_url = imageUrl;
+    if (isKlingV3Model(model)) {
+      input.start_image_url = imageUrl;
+      const ar = mapAspectRatio(req.aspectRatio, model);
+      if (ar) input.aspect_ratio = ar;
+    } else {
+      input.image_url = imageUrl;
+    }
     if (req.duration) input.duration = String(req.duration);
     return input;
   }
-  const imageSize = mapAspectRatio(req.aspectRatio);
+  if (isKlingV3Model(model)) {
+    throw new Error(
+      `Model ${model} requires --start-frame (or --input) because it is image-to-video only`
+    );
+  }
+  const imageSize = mapAspectRatio(req.aspectRatio, model);
   if (imageSize) input.image_size = imageSize;
   if (req.n) input.num_videos = req.n;
   return input;
@@ -515,8 +545,8 @@ var falCapabilities = {
   supportsCustomAspectRatio: true,
   supportsVideoInterpolation: true,
   // Vidu start-end-to-video
-  videoDurationRange: [2, 8],
-  // Vidu supports 2-8 seconds
+  videoDurationRange: [2, 15],
+  // Most models are 2-8; Kling v3 supports up to 15
   supportsImageEditing: true
 };
 var falProvider = {
@@ -544,7 +574,19 @@ var falProvider = {
     fal.config({ credentials: key });
     const model = req.kind === "video" ? selectVideoModel(req) : selectImageModel(req);
     log2(verbose, "Selected model:", model);
-    const input = req.kind === "video" ? buildVideoInput(req) : buildImageInput(req);
+    if (req.kind === "video" && req.duration !== void 0) {
+      if (isKlingV3Model(model) && (req.duration < 3 || req.duration > 15)) {
+        throw new Error(
+          `Model ${model} supports video duration 3-15s, but ${req.duration}s requested`
+        );
+      }
+      if (isViduModel(model) && (req.duration < 2 || req.duration > 8)) {
+        throw new Error(
+          `Model ${model} supports video duration 2-8s, but ${req.duration}s requested`
+        );
+      }
+    }
+    const input = req.kind === "video" ? buildVideoInput(req, model) : buildImageInput(req);
     const inputSummary = { ...input };
     for (const key2 of ["image_url", "start_image_url", "end_image_url"]) {
       if (typeof inputSummary[key2] === "string" && inputSummary[key2].startsWith("data:")) {