runapi-kling 0.2.14 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4e9cf3bd778f4eb399c79e7a1fc81b24c6783d56ed625b6102e2e6c90cb066b5
-  data.tar.gz: 1932a3abf1e67949639c2ff9a75173bedd76d09a71fac883102985dab80c13de
+  metadata.gz: 140439beb109af76dad4b45b4e4f6f2ffb9ff6649b11fea5b7ed80b8a4000323
+  data.tar.gz: 4f4cfd9fa579b7c5c673243a24974529f0adee777666fec4c8da353cbf3a3711
 SHA512:
-  metadata.gz: 22f39494c76057427e7ffc927991bf52a980fce4330226103cb71fe0063e0f4f634edcba7b78764f3023e188e7bc91725ad8e503dfc5c28ba5102d4f59d7be75
-  data.tar.gz: 00e6370f82e94cad79e7f8c873818241f7df2e876060c054819fd86b9f737c30b66471fc44025ee778d0c3f7f82e2d95d8372f0e8bfb565b6310baeab9715e8c
+  metadata.gz: af7e49904ef9611be7add201a6ca3abc5486bf5349a530201c252bfe551efb234879c55ebe70c0d04b44efc6dbfbe558d58a129e875515933191b6855da2ebe5
+  data.tar.gz: 52712ddf7503925a719b436867b4aa41191ab9931e0d56d18d5c9061f604b67f3dd782245df3bcdc5dd7f6561d057f5a21c8ba3382eeee6c651a8b34ef43325a

data/README.md

@@ -39,13 +39,17 @@ result = client.text_to_video.run(
 
 Number reference images in prompt order as `<<<image_1>>>`, `<<<image_2>>>`, and so on; the optional video is `<<<video_1>>>`. With a video, send at most four images. Do not combine `last_frame_image_url` with reference images or a reference video. A `feature` reference video may be used with the required first frame; `base` cannot be combined with frame inputs. O1 requests are five seconds and keep sound disabled. Pricing and limits: https://runapi.ai/models/kling/o1.
 
+## Kling V3 Omni source-video editing
+
+Use `kling-v3-omni-reference` with `text_to_video` for image-only reference inputs. For a source video, use `edit_video` with either `kling-v3-omni-reference` or `kling-v3-omni-edit`. The reference model keeps sound disabled for source-video requests.
+
 Use `create` when you want to submit a task and return quickly, `get` when you need the latest task state, and `run` when a script should create and poll until completion. In web request handlers, prefer `create` plus webhook or later `get` polling so a worker is not held open.
 
 RunAPI-generated file URLs are temporary. Download and store generated images, videos, audio, or other files in your own durable storage within 7 days; do not treat returned URLs as long-term assets.
 
 ## Language notes
 
-Use Ruby keyword arguments and the `RunApi::Kling` error classes when building video jobs, Rails workers, or scripts. The available resources are `text_to_video`, `ai_avatar`, `image_to_video`, and `motion_control`. Keep `RUNAPI_API_KEY` in the environment or your secret manager; never commit API keys or callback secrets.
+Use Ruby keyword arguments and the `RunApi::Kling` error classes when building video jobs, Rails workers, or scripts. The available resources are `text_to_video`, `edit_video`, `ai_avatar`, `image_to_video`, and `motion_control`. Keep `RUNAPI_API_KEY` in the environment or your secret manager; never commit API keys or callback secrets.
 
 ## Links
 

data/lib/runapi/kling/client.rb

@@ -19,6 +19,8 @@ module RunApi
       # @return [Resources::MotionControl] Motion control operations.
       attr_reader :motion_control
       attr_reader :extend_video
+      # @return [Resources::EditVideo] Source-video editing operations.
+      attr_reader :edit_video
 
       def initialize(api_key: nil, **options)
         super
@@ -27,6 +29,7 @@ module RunApi
         @image_to_video = Resources::ImageToVideo.new(http)
         @motion_control = Resources::MotionControl.new(http)
         @extend_video = Resources::ExtendVideo.new(http)
+        @edit_video = Resources::EditVideo.new(http)
       end
     end
   end

data/lib/runapi/kling/contract_gen.rb

@@ -64,6 +64,236 @@ module RunApi
           }
         }
       },
+      "edit-video" => {
+        "models" => ["kling-v3-omni-edit", "kling-v3-omni-reference"],
+        "fields_by_model" => {
+          "kling-v3-omni-edit" => {
+            "aspect_ratio" => {
+              "enum" => ["auto", "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
+            },
+            "reference_image_urls" => {
+              "min_items" => 1,
+              "max_items" => 4
+            }
+          },
+          "kling-v3-omni-reference" => {
+            "aspect_ratio" => {
+              "enum" => ["auto", "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
+            },
+            "reference_image_urls" => {
+              "min_items" => 1,
+              "max_items" => 4
+            }
+          }
+        },
+        "rules" => [{
+          "when" => {
+            "model" => "kling-v3-omni-edit",
+            "source_task_id" => {
+              "present" => false
+            },
+            "source_video_url" => {
+              "present" => false
+            }
+          },
+          "required_any" => ["source_video_url", "source_task_id"]
+        }, {
+          "when" => {
+            "model" => "kling-v3-omni-edit",
+            "source_video_url" => {
+              "present" => true
+            }
+          },
+          "forbidden" => ["source_task_id"]
+        }, {
+          "when" => {
+            "model" => "kling-v3-omni-edit",
+            "source_task_id" => {
+              "present" => true
+            }
+          },
+          "forbidden" => ["source_video_url"]
+        }, {
+          "enum" => {
+            "aspect_ratio" => ["auto"],
+            "duration_seconds" => [5]
+          },
+          "when" => {
+            "model" => "kling-v3-omni-edit",
+            "source_video_url" => {
+              "present" => true
+            },
+            "reference_image_urls" => {
+              "present" => false
+            }
+          },
+          "required" => ["aspect_ratio"]
+        }, {
+          "enum" => {
+            "aspect_ratio" => ["auto"],
+            "duration_seconds" => [5]
+          },
+          "when" => {
+            "model" => "kling-v3-omni-edit",
+            "source_task_id" => {
+              "present" => true
+            },
+            "reference_image_urls" => {
+              "present" => false
+            }
+          },
+          "required" => ["aspect_ratio"]
+        }, {
+          "enum" => {
+            "aspect_ratio" => ["16:9", "9:16", "1:1"]
+          },
+          "when" => {
+            "model" => "kling-v3-omni-edit",
+            "source_video_url" => {
+              "present" => true
+            },
+            "reference_image_urls" => {
+              "present" => true
+            }
+          },
+          "required" => ["aspect_ratio"]
+        }, {
+          "enum" => {
+            "aspect_ratio" => ["16:9", "9:16", "1:1"]
+          },
+          "when" => {
+            "model" => "kling-v3-omni-edit",
+            "source_task_id" => {
+              "present" => true
+            },
+            "reference_image_urls" => {
+              "present" => true
+            }
+          },
+          "required" => ["aspect_ratio"]
+        }, {
+          "when" => {
+            "model" => "kling-v3-omni-reference",
+            "source_task_id" => {
+              "present" => false
+            },
+            "source_video_url" => {
+              "present" => false
+            }
+          },
+          "required_any" => ["source_video_url", "source_task_id"]
+        }, {
+          "when" => {
+            "model" => "kling-v3-omni-reference",
+            "source_video_url" => {
+              "present" => true
+            }
+          },
+          "forbidden" => ["source_task_id"]
+        }, {
+          "when" => {
+            "model" => "kling-v3-omni-reference",
+            "source_task_id" => {
+              "present" => true
+            }
+          },
+          "forbidden" => ["source_video_url"]
+        }, {
+          "enum" => {
+            "aspect_ratio" => ["auto"],
+            "enable_sound" => [false],
+            "duration_seconds" => [5]
+          },
+          "when" => {
+            "model" => "kling-v3-omni-reference",
+            "source_video_url" => {
+              "present" => true
+            },
+            "reference_image_urls" => {
+              "present" => false
+            }
+          },
+          "required" => ["aspect_ratio"]
+        }, {
+          "enum" => {
+            "aspect_ratio" => ["auto"],
+            "enable_sound" => [false],
+            "duration_seconds" => [5]
+          },
+          "when" => {
+            "model" => "kling-v3-omni-reference",
+            "source_task_id" => {
+              "present" => true
+            },
+            "reference_image_urls" => {
+              "present" => false
+            }
+          },
+          "required" => ["aspect_ratio"]
+        }, {
+          "enum" => {
+            "aspect_ratio" => ["16:9", "9:16", "1:1"],
+            "enable_sound" => [false]
+          },
+          "when" => {
+            "model" => "kling-v3-omni-reference",
+            "source_video_url" => {
+              "present" => true
+            },
+            "reference_image_urls" => {
+              "present" => true
+            }
+          },
+          "required" => ["aspect_ratio"]
+        }, {
+          "enum" => {
+            "aspect_ratio" => ["16:9", "9:16", "1:1"],
+            "enable_sound" => [false]
+          },
+          "when" => {
+            "model" => "kling-v3-omni-reference",
+            "source_task_id" => {
+              "present" => true
+            },
+            "reference_image_urls" => {
+              "present" => true
+            }
+          },
+          "required" => ["aspect_ratio"]
+        }]
+      },
       "extend-video" => {
         "models" => ["kling-v2.5-turbo-image-to-video-pro", "kling-v2.5-turbo-text-to-video-pro"],
         "fields_by_model" => {
@@ -346,7 +576,7 @@ module RunApi
         }]
       },
       "text-to-video" => {
-        "models" => ["kling-3.0", "kling-o1", "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"],
+        "models" => ["kling-3.0", "kling-o1", "kling-v2.1-master-text-to-video", "kling-v2.5-turbo-text-to-video-pro", "kling-v2.6", "kling-v3-omni", "kling-v3-omni-reference", "kling-v3-turbo-text-to-video"],
         "fields_by_model" => {
           "kling-3.0" => {
             "aspect_ratio" => {
@@ -457,6 +687,33 @@ module RunApi
               "length" => true
             }
           },
+          "kling-v3-omni-reference" => {
+            "aspect_ratio" => {
+              "enum" => ["16:9", "9:16", "1:1"],
+              "required" => true
+            },
+            "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
+            },
+            "reference_image_urls" => {
+              "required" => true,
+              "min_items" => 1,
+              "max_items" => 7
+            }
+          },
           "kling-v3-turbo-text-to-video" => {
             "aspect_ratio" => {
               "enum" => ["16:9", "9:16", "1:1"]

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

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module RunApi
+  module Kling
+    module Resources
+      # Edit a source video with a selected Kling V3 Omni model.
+      class EditVideo
+        include RunApi::Core::ResourceHelpers
+
+        ENDPOINT = "/api/v1/kling/edit_video"
+        RESPONSE_CLASS = Types::TextToVideoResponse
+        COMPLETED_RESPONSE_CLASS = Types::CompletedTextToVideoResponse
+
+        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["edit-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.rb

@@ -9,6 +9,7 @@ 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/resources/edit_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.14
+  version: 0.3.0
 platform: ruby
 authors:
 - 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/edit_video.rb
 - lib/runapi/kling/resources/extend_video.rb
 - lib/runapi/kling/resources/image_to_video.rb
 - lib/runapi/kling/resources/motion_control.rb
@@ -71,7 +72,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: []