runapi-kling 0.2.9 → 0.2.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d2943605c3e518ce6a424760e18be4da5a853f87b167f2b4a61688e6aa810485
-  data.tar.gz: b7b43a3379b6be598313bce535b399a240237eda145b4e644f11ae02709fbba7
+  metadata.gz: 52976b2c6ead958e307eb73e1074e9dae605dce26e58d3320aa0df15f3eb2d7d
+  data.tar.gz: 4c6255e788fa2950a268419a646e7d7c07c8bd2344f0f7925ef8a760b7773c25
 SHA512:
-  metadata.gz: 7629e75af240e178d3d155d0f4d3430e5cbddeda6e34827fabdbcc0b54166d28c79633c6f2e2f385ea234ac4ed04c625d7174799ecfc60cf7376b664d83f885b
-  data.tar.gz: eca5d1069c584b2edcc402c053a6d0355012ec09a5294ff72a7a04abd3473d3fd5595fbb6d48260afc72369c0f0ea6f5b3a8b4bb1223f6c5509b647262f71c01
+  metadata.gz: 6f3a374bb8b623a477b6656f2fccb06eba3e0ebb3b6b97ead65ae491fa21fd67a64c83715ed806e79027e0ca6031f6371f69c085a085281ec3c60068547b8263
+  data.tar.gz: a233a64e104565e7be3bef7181944756460c78c3c7f9e647f1826b6ce440860fa4ee9fcc1cd6c3368b69a4c40813646b3e0278f168e548aec5f3305ca101c99e

data/lib/runapi/kling/client.rb

@@ -18,6 +18,7 @@ module RunApi
       attr_reader :image_to_video
       # @return [Resources::MotionControl] Motion control operations.
       attr_reader :motion_control
+      attr_reader :extend_video
 
       def initialize(api_key: nil, **options)
         super
@@ -25,6 +26,7 @@ module RunApi
         @ai_avatar = Resources::AiAvatar.new(http)
         @image_to_video = Resources::ImageToVideo.new(http)
         @motion_control = Resources::MotionControl.new(http)
+        @extend_video = Resources::ExtendVideo.new(http)
       end
     end
   end

data/lib/runapi/kling/contract_gen.rb

@@ -64,8 +64,29 @@ module RunApi
           }
         }
       },
+      "extend-video" => {
+        "models" => ["kling-v2.5-turbo-image-to-video-pro", "kling-v2.5-turbo-text-to-video-pro"],
+        "fields_by_model" => {
+          "kling-v2.5-turbo-image-to-video-pro" => {
+            "mode" => {
+              "enum" => ["std", "pro"]
+            },
+            "source_task_id" => {
+              "required" => true
+            }
+          },
+          "kling-v2.5-turbo-text-to-video-pro" => {
+            "mode" => {
+              "enum" => ["std", "pro"]
+            },
+            "source_task_id" => {
+              "required" => true
+            }
+          }
+        }
+      },
       "image-to-video" => {
-        "models" => ["kling-v2.1-master-image-to-video", "kling-v2.1-pro", "kling-v2.1-standard", "kling-v2.5-turbo-image-to-video-pro", "kling-v3-turbo-image-to-video"],
+        "models" => ["kling-v2.1-master-image-to-video", "kling-v2.1-pro", "kling-v2.1-standard", "kling-v2.5-turbo-image-to-video-pro", "kling-v2.6", "kling-v3-omni", "kling-v3-turbo-image-to-video"],
         "fields_by_model" => {
           "kling-v2.1-master-image-to-video" => {
             "duration_seconds" => {
@@ -127,6 +148,54 @@ module RunApi
               "required" => true
             }
           },
+          "kling-v2.6" => {
+            "aspect_ratio" => {
+              "enum" => ["16:9", "9:16", "1:1"]
+            },
+            "duration_seconds" => {
+              "enum" => [5, 10],
+              "type" => "integer"
+            },
+            "first_frame_image_url" => {
+              "required" => true
+            },
+            "mode" => {
+              "enum" => ["std", "pro"]
+            },
+            "model" => {
+              "required" => true
+            },
+            "prompt" => {
+              "required" => true,
+              "min" => 1,
+              "max" => 2500,
+              "length" => true
+            }
+          },
+          "kling-v3-omni" => {
+            "aspect_ratio" => {
+              "enum" => ["16:9", "9:16", "1:1"]
+            },
+            "duration_seconds" => {
+              "enum" => [3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
+              "type" => "integer"
+            },
+            "first_frame_image_url" => {
+              "required" => true
+            },
+            "model" => {
+              "required" => true
+            },
+            "output_resolution" => {
+              "enum" => ["720p", "1080p", "4k"]
+            },
+            "prompt" => {
+              "required" => true,
+              "min" => 1,
+              "max" => 2500,
+              "length" => true
+            }
+          },
           "kling-v3-turbo-image-to-video" => {
             "duration_seconds" => {
               "enum" => [3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
@@ -153,27 +222,37 @@ module RunApi
           "when" => {
             "model" => "kling-v2.1-master-image-to-video"
           },
-          "forbidden" => ["output_resolution"]
+          "forbidden" => ["output_resolution", "enable_sound"]
         }, {
           "when" => {
             "model" => "kling-v2.1-pro"
           },
-          "forbidden" => ["output_resolution"]
+          "forbidden" => ["output_resolution", "enable_sound"]
         }, {
           "when" => {
             "model" => "kling-v2.1-standard"
           },
-          "forbidden" => ["output_resolution"]
+          "forbidden" => ["output_resolution", "enable_sound"]
         }, {
           "when" => {
             "model" => "kling-v2.5-turbo-image-to-video-pro"
           },
-          "forbidden" => ["output_resolution"]
+          "forbidden" => ["output_resolution", "enable_sound"]
+        }, {
+          "when" => {
+            "model" => "kling-v2.6"
+          },
+          "forbidden" => ["output_resolution", "negative_prompt", "cfg_scale"]
+        }, {
+          "when" => {
+            "model" => "kling-v3-omni"
+          },
+          "forbidden" => ["negative_prompt", "cfg_scale"]
         }, {
           "when" => {
             "model" => "kling-v3-turbo-image-to-video"
           },
-          "forbidden" => ["aspect_ratio", "negative_prompt", "cfg_scale", "last_frame_image_url"]
+          "forbidden" => ["enable_sound", "aspect_ratio", "negative_prompt", "cfg_scale", "last_frame_image_url"]
         }]
       },
       "motion-control" => {
@@ -202,7 +281,7 @@ module RunApi
         }
       },
       "text-to-video" => {
-        "models" => ["kling-3.0", "kling-v2.1-master-text-to-video", "kling-v2.5-turbo-text-to-video-pro", "kling-v3-turbo-text-to-video"],
+        "models" => ["kling-3.0", "kling-v2.1-master-text-to-video", "kling-v2.5-turbo-text-to-video-pro", "kling-v2.6", "kling-v3-omni", "kling-v3-turbo-text-to-video"],
         "fields_by_model" => {
           "kling-3.0" => {
             "aspect_ratio" => {
@@ -243,6 +322,48 @@ module RunApi
               "required" => true
             }
           },
+          "kling-v2.6" => {
+            "aspect_ratio" => {
+              "enum" => ["16:9", "9:16", "1:1"]
+            },
+            "duration_seconds" => {
+              "enum" => [5, 10],
+              "type" => "integer"
+            },
+            "mode" => {
+              "enum" => ["std", "pro"]
+            },
+            "model" => {
+              "required" => true
+            },
+            "prompt" => {
+              "required" => true,
+              "min" => 1,
+              "max" => 2500,
+              "length" => true
+            }
+          },
+          "kling-v3-omni" => {
+            "aspect_ratio" => {
+              "enum" => ["16:9", "9:16", "1:1"]
+            },
+            "duration_seconds" => {
+              "enum" => [3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
+              "type" => "integer"
+            },
+            "model" => {
+              "required" => true
+            },
+            "output_resolution" => {
+              "enum" => ["720p", "1080p", "4k"]
+            },
+            "prompt" => {
+              "required" => true,
+              "min" => 1,
+              "max" => 2500,
+              "length" => true
+            }
+          },
           "kling-v3-turbo-text-to-video" => {
             "aspect_ratio" => {
               "enum" => ["16:9", "9:16", "1:1"]
@@ -266,6 +387,21 @@ module RunApi
           }
         },
         "rules" => [{
+          "when" => {
+            "model" => "kling-v2.5-turbo-text-to-video-pro"
+          },
+          "forbidden" => ["mode"]
+        }, {
+          "when" => {
+            "model" => "kling-v2.6"
+          },
+          "forbidden" => ["output_resolution", "negative_prompt", "cfg_scale", "multi_shots", "multi_prompt", "first_frame_image_url", "last_frame_image_url", "kling_elements"]
+        }, {
+          "when" => {
+            "model" => "kling-v3-omni"
+          },
+          "forbidden" => ["negative_prompt", "cfg_scale", "multi_shots", "multi_prompt", "first_frame_image_url", "last_frame_image_url", "kling_elements"]
+        }, {
           "when" => {
             "model" => "kling-v3-turbo-text-to-video"
           },

data/lib/runapi/kling/resources/extend_video.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module RunApi
+  module Kling
+    module Resources
+      # Continue a completed Kling V2.5 Turbo video task.
+      class ExtendVideo
+        include RunApi::Core::ResourceHelpers
+
+        ENDPOINT = "/api/v1/kling/extend_video"
+
+        def initialize(http)
+          @http = http
+        end
+
+        def run(options: nil, **params)
+          task = create(options: options, **params)
+          poll_until_complete { get(task.id, options: options) }
+        end
+
+        def create(options: nil, **params)
+          params = compact_params(params)
+          validate_contract!(CONTRACT["extend-video"], params)
+          request(:post, ENDPOINT, body: params, options: options)
+        end
+
+        def get(id, options: nil)
+          request(:get, "#{ENDPOINT}/#{id}", options: options)
+        end
+      end
+    end
+  end
+end

data/lib/runapi/kling/resources/image_to_video.rb

@@ -12,6 +12,8 @@ module RunApi
 
         RESPONSE_CLASS = Types::ImageToVideoResponse
         COMPLETED_RESPONSE_CLASS = Types::CompletedImageToVideoResponse
+        V26_MODEL = "kling-v2.6"
+        V3_OMNI_MODEL = "kling-v3-omni"
         V3_TURBO_MODEL = "kling-v3-turbo-image-to-video"
         V3_TURBO_UNSUPPORTED_FIELDS = %i[
           aspect_ratio
@@ -57,15 +59,36 @@ module RunApi
           reject_unsupported_v3_turbo_fields!(params)
           validate_contract!(CONTRACT["image-to-video"], params)
 
-          # Bespoke: last_frame_image_url is only allowed for select models
-          # (model-gating, not expressible as a contract enum/required rule).
+          # Bespoke last-frame rules that the generated contract cannot express.
           model = param(params, :model)
           last_frame_image_url = param(params, :last_frame_image_url)
-          if last_frame_image_url && !%w[kling-v2.5-turbo-image-to-video-pro kling-v2.1-pro].include?(model)
+          if model == V26_MODEL
+            validate_v26_params!(params, last_frame_image_url)
+          elsif last_frame_image_url && model == V3_OMNI_MODEL
+            duration_seconds = param(params, :duration_seconds) || 5
+            return if duration_seconds.to_i == 5
+
+            raise Core::ValidationError, "last_frame_image_url requires duration_seconds 5 for #{V3_OMNI_MODEL}"
+          elsif last_frame_image_url && !%w[kling-v2.5-turbo-image-to-video-pro kling-v2.1-pro].include?(model)
             raise Core::ValidationError, "last_frame_image_url is only supported by kling-v2.5-turbo-image-to-video-pro and kling-v2.1-pro"
           end
         end
 
+        def validate_v26_params!(params, last_frame_image_url)
+          mode = param(params, :mode) || "std"
+          if param(params, :enable_sound) == true && mode != "pro"
+            raise Core::ValidationError, "enable_sound requires mode pro for #{V26_MODEL}"
+          end
+          return unless last_frame_image_url
+
+          raise Core::ValidationError, "last_frame_image_url requires mode pro for #{V26_MODEL}" unless mode == "pro"
+
+          duration_seconds = param(params, :duration_seconds) || 5
+          return if duration_seconds.to_i == 5
+
+          raise Core::ValidationError, "last_frame_image_url requires duration_seconds 5 for #{V26_MODEL}"
+        end
+
         def reject_unsupported_v3_turbo_fields!(params)
           return unless param(params, :model) == V3_TURBO_MODEL
 

data/lib/runapi/kling/resources/text_to_video.rb

@@ -12,6 +12,7 @@ module RunApi
 
         RESPONSE_CLASS = Types::TextToVideoResponse
         COMPLETED_RESPONSE_CLASS = Types::CompletedTextToVideoResponse
+        V26_MODEL = "kling-v2.6"
         V3_TURBO_MODEL = "kling-v3-turbo-text-to-video"
         V3_TURBO_UNSUPPORTED_FIELDS = %i[
           enable_sound
@@ -60,6 +61,7 @@ module RunApi
         def validate_params!(params)
           reject_unsupported_v3_turbo_fields!(params)
           validate_contract!(CONTRACT["text-to-video"], params)
+          validate_v26_params!(params)
 
           # Bespoke cross-field rules the contract cannot express.
           multi_shots = param(params, :multi_shots) == true
@@ -75,6 +77,13 @@ module RunApi
           end
         end
 
+        def validate_v26_params!(params)
+          return unless param(params, :model) == V26_MODEL
+          return unless param(params, :enable_sound) == true && param(params, :mode) != "pro"
+
+          raise Core::ValidationError, "enable_sound requires mode pro for #{V26_MODEL}"
+        end
+
         def reject_unsupported_v3_turbo_fields!(params)
           return unless param(params, :model) == V3_TURBO_MODEL
 

data/lib/runapi/kling.rb

@@ -7,6 +7,7 @@ require_relative "kling/resources/text_to_video"
 require_relative "kling/resources/ai_avatar"
 require_relative "kling/resources/image_to_video"
 require_relative "kling/resources/motion_control"
+require_relative "kling/resources/extend_video"
 require_relative "kling/client"
 
 module RunApi

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: runapi-kling
 version: !ruby/object:Gem::Version
-  version: 0.2.9
+  version: 0.2.11
 platform: ruby
 authors:
 - RunAPI
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.11
+        version: 0.2.15
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.11
+        version: 0.2.15
 description: The Kling Ruby SDK is the language-specific package for Kling on RunAPI.
   Use this package for video generation, animation, and video editing workflows when
   your application needs request bodies, task status lookup, and consistent RunAPI
@@ -41,6 +41,7 @@ files:
 - lib/runapi/kling/client.rb
 - lib/runapi/kling/contract_gen.rb
 - lib/runapi/kling/resources/ai_avatar.rb
+- lib/runapi/kling/resources/extend_video.rb
 - lib/runapi/kling/resources/image_to_video.rb
 - lib/runapi/kling/resources/motion_control.rb
 - lib/runapi/kling/resources/text_to_video.rb
@@ -69,7 +70,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.10
+rubygems_version: 4.0.17
 specification_version: 4
 summary: Kling API Ruby SDK for RunAPI
 test_files: []