runapi-kling 0.2.7 → 0.2.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 584b5be5ffeeb256f9d0d2a33533132cce5d94a48ba70b67382f603e3f63993e
-  data.tar.gz: 0e3421cbd6a27db1744dfb5b4f79ed94cc7cace043ea8cd0e3adad8423520df8
+  metadata.gz: '06496c392220522b5dedc8acd4f71436ba22fd51df6ac685d8600fc5a5f3d02f'
+  data.tar.gz: ba507498208a38a168ec79b1e7a1041c95101c5aa510f1ba11cd55a3cd6e4a1a
 SHA512:
-  metadata.gz: ee240679da24f460d550384d362eb05b5547a3f96a6a96b188652bd51813c2237500daf89c6d236cc1d876560fbe17521deaf1590de946b020aad3b6bbc33fdd
-  data.tar.gz: 13b5771791a2148eaf1d7535e633ce6d4f372413a76133376909f92d6dc07ea2355b2b0d8643cd0d4a0dac3265b7ea6011d57fe6946ba9bd2ae1cb78b888197f
+  metadata.gz: 361d632584c9a124c7e295bd3ae2f337f0434166ee76e13871afc5e17a96fc11e30f86802daa65724f1c8ee421cc4638ab97329cacce8dff1e14a701f12e0f89
+  data.tar.gz: 2a4358323094f9d1d2269b857107927042707cb003df73abb7855d3305cf30d1bcf5e09bda2799dec94da92ca85fc72d5eb5ac334e448de688749ac81a16daba

data/README.md

@@ -24,6 +24,8 @@ status = client.generations.get(task.id)
 
 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 include text-to-video, image-to-video, AI avatars, V2.1/V2.5 video variants, and motion controls. Keep `RUNAPI_API_KEY` in the environment or your secret manager; never commit API keys or callback secrets.

data/lib/runapi/kling/client.rb

@@ -9,7 +9,7 @@ module RunApi
     #   result = client.text_to_video.run(
     #     model: "kling-3.0", prompt: "A cat walking through a garden"
     #   )
-    class Client
+    class Client < RunApi::Core::Client
       # @return [Resources::TextToVideo] Text-to-video operations.
       attr_reader :text_to_video
       # @return [Resources::AiAvatar] AI avatar generation operations.
@@ -20,10 +20,7 @@ module RunApi
       attr_reader :motion_control
 
       def initialize(api_key: nil, **options)
-        @api_key = Core::Auth.resolve_api_key(api_key)
-
-        client_options = Core::ClientOptions.new(api_key: @api_key, **options)
-        http = client_options.http_client || Core::HttpClient.new(client_options)
+        super
         @text_to_video = Resources::TextToVideo.new(http)
         @ai_avatar = Resources::AiAvatar.new(http)
         @image_to_video = Resources::ImageToVideo.new(http)

data/lib/runapi/kling/types.rb

@@ -2,13 +2,17 @@
 
 module RunApi
   module Kling
+    # Type definitions and constants for Kling video generation.
     module Types
+      # Text-to-video model variants. kling-3.0 supports multi-shot, sound, and elements;
+      # V2.x models support negative prompts and cfg_scale.
       TEXT_TO_VIDEO_MODELS = %w[
         kling-3.0
         kling-v2.5-turbo-text-to-video-pro
         kling-v2.1-master-text-to-video
       ].freeze
 
+      # AI avatar lip-sync quality tiers, from highest to fastest.
       AI_AVATAR_MODELS = %w[
         kling-ai-avatar-pro
         kling-ai-avatar-standard
@@ -16,6 +20,7 @@ module RunApi
         kling-v1-avatar-standard
       ].freeze
 
+      # Image-to-video model variants. V2.5 turbo and V2.1 pro support last-frame image control.
       IMAGE_TO_VIDEO_MODELS = %w[
         kling-v2.5-turbo-image-to-video-pro
         kling-v2.1-pro
@@ -23,26 +28,34 @@ module RunApi
         kling-v2.1-master-image-to-video
       ].freeze
 
+      # Output resolution options. 4k is highest quality but slowest.
       TEXT_TO_VIDEO_OUTPUT_RESOLUTIONS = %w[720p 1080p 4k].freeze
 
       MOTION_CONTROL_MODELS = %w[kling-3.0].freeze
 
       MOTION_CONTROL_OUTPUT_RESOLUTIONS = %w[720p 1080p].freeze
 
+      # Whether the character faces the direction from the video or the image.
       MOTION_CONTROL_CHARACTER_ORIENTATIONS = %w[video image].freeze
 
+      # Whether the background comes from the reference video or the subject image.
       MOTION_CONTROL_BACKGROUND_SOURCES = %w[video image].freeze
 
       ASPECT_RATIOS = %w[16:9 9:16 1:1].freeze
 
+      # Duration range for kling-3.0 (seconds).
       DURATION_RANGE = (3..15)
 
+      # Per-shot duration range in multi-shot mode (seconds).
       MULTI_PROMPT_DURATION_RANGE = (1..12)
 
+      # Fixed duration options for V2.x models (seconds).
       FIXED_DURATIONS = [5, 10].freeze
 
+      # Maximum character length for each multi-shot prompt segment.
       MULTI_PROMPT_MAX_LENGTH = 500
 
+      # A generated video file with a download URL.
       class Video < RunApi::Core::BaseModel
         optional :url, String
       end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: runapi-kling
 version: !ruby/object:Gem::Version
-  version: 0.2.7
+  version: 0.2.8
 platform: ruby
 authors:
 - RunAPI
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.5
+        version: 0.2.6
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.5
+        version: 0.2.6
 description: The kling ai api Ruby SDK is the language-specific package for Kling
   on RunAPI. Use this kling ai api package for text-to-video, image-to-video, video
   editing, and animation flows when your application needs JSON request bodies, task