runapi-kling 0.2.10 → 0.2.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e320ba4bacde45051ec892890b4538a8fe2c415d86facc8c3c950bfeb43bd94e
-  data.tar.gz: 4ae9148e0a4b579a47f65c6b02ba40d3cc1c95bec9254fd423bf45b442ea99f3
+  metadata.gz: 60b66152ad919ac0d68333e322d2020f9b6b1494b1595d39cc40bdd3bdde4f16
+  data.tar.gz: a599aa79714ccb068cb43ebedcb3092ed00435185941f4b20a853fdacf9a4524
 SHA512:
-  metadata.gz: c1bc8ee1eb14d11292751fa2c24318335bb07b4a7bfa02b82454c30f9da7889281bf29067d5fc34d7d29c337d12fbadf934924c9a61c7df34b64bfe6ad937939
-  data.tar.gz: e64c06c27bebb03e97c45801a268ad752ab63a3b22cd24e85b7d3baf9d8fc4f7b16cb0547336c820c7a5c560a326fbf49614bf6806e6e9d3e9ec4561e486265d
+  metadata.gz: 0e5605502283c0488cbfcf1a521b14a4cc172d389cbc452fa0c4169afd2ce8fd2e147a0fd5230cac020fd43a91393d1fe1bc578da1238ae3c1425b6a28bb63b6
+  data.tar.gz: 7728476306ee7d0ab8d0877275093548347f60d6c08c831fab3e3f809643e5da95951b5561c0abbafa0ba4b8262ed6e38174f7dd838c845fde2fd52f22889afa

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-v2.6", "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" => {
@@ -151,6 +172,30 @@ module RunApi
               "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],
@@ -177,36 +222,41 @@ module RunApi
           "when" => {
             "model" => "kling-v2.1-master-image-to-video"
           },
-          "forbidden" => ["output_resolution", "mode", "enable_sound"]
+          "forbidden" => ["output_resolution", "enable_sound"]
         }, {
           "when" => {
             "model" => "kling-v2.1-pro"
           },
-          "forbidden" => ["output_resolution", "mode", "enable_sound"]
+          "forbidden" => ["output_resolution", "enable_sound"]
         }, {
           "when" => {
             "model" => "kling-v2.1-standard"
           },
-          "forbidden" => ["output_resolution", "mode", "enable_sound"]
+          "forbidden" => ["output_resolution", "enable_sound"]
         }, {
           "when" => {
             "model" => "kling-v2.5-turbo-image-to-video-pro"
           },
-          "forbidden" => ["output_resolution", "mode", "enable_sound"]
+          "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" => ["mode", "enable_sound", "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" => {
-        "models" => ["kling-3.0"],
+        "models" => ["kling-3.0", "kling-v2.6"],
         "fields_by_model" => {
           "kling-3.0" => {
             "background_source" => {
@@ -227,11 +277,40 @@ module RunApi
             "source_image_url" => {
               "required" => true
             }
+          },
+          "kling-v2.6" => {
+            "character_orientation" => {
+              "enum" => ["video", "image"],
+              "required" => true
+            },
+            "model" => {
+              "required" => true
+            },
+            "output_resolution" => {
+              "enum" => ["720p", "1080p"],
+              "required" => true
+            },
+            "prompt" => {
+              "max" => 2500,
+              "length" => true
+            },
+            "reference_video_url" => {
+              "required" => true
+            },
+            "source_image_url" => {
+              "required" => true
+            }
           }
-        }
+        },
+        "rules" => [{
+          "when" => {
+            "model" => "kling-v2.6"
+          },
+          "forbidden" => ["background_source"]
+        }]
       },
       "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-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" => {
@@ -293,6 +372,27 @@ module RunApi
               "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"]
@@ -316,16 +416,6 @@ module RunApi
           }
         },
         "rules" => [{
-          "when" => {
-            "model" => "kling-3.0"
-          },
-          "forbidden" => ["mode"]
-        }, {
-          "when" => {
-            "model" => "kling-v2.1-master-text-to-video"
-          },
-          "forbidden" => ["mode"]
-        }, {
           "when" => {
             "model" => "kling-v2.5-turbo-text-to-video-pro"
           },
@@ -335,11 +425,16 @@ module RunApi
             "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"
           },
-          "forbidden" => ["mode", "enable_sound", "negative_prompt", "cfg_scale", "multi_shots", "multi_prompt", "first_frame_image_url", "last_frame_image_url", "kling_elements"]
+          "forbidden" => ["enable_sound", "negative_prompt", "cfg_scale", "multi_shots", "multi_prompt", "first_frame_image_url", "last_frame_image_url", "kling_elements"]
         }]
       }
     }.freeze

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

@@ -13,6 +13,7 @@ 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
@@ -58,12 +59,16 @@ 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 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

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.10
+  version: 0.2.12
 platform: ruby
 authors:
 - RunAPI
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.14
+        version: 0.2.15
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.14
+        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: []