runapi-infinitetalk 0.2.5 → 0.2.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4fa0e1602f6bec3ba27af06b285047d873ab0994632c1018b0457c30ea538a6c
-  data.tar.gz: 86d3f1116b288566c4a1e0cf6dd18f16c3043b3e48b79da9211d3814ec650685
+  metadata.gz: e1a267d42796d65befec17a0e733b2db482e18c440d38edfb7be16c1a1fae597
+  data.tar.gz: a2f1b73ad67eb6f5a34fafae990e9b411f41dd4bc235b12370bc9de3ef408a30
 SHA512:
-  metadata.gz: 803e3c8713bc01a19513f2800cea7ac73dc12b875f589d5a92457a36810dd5d160c717fddb11022ac5eadea52227ae6e18f89ccd64aa36bbb868d01aaf97258c
-  data.tar.gz: e8f15d25513e3ca96775bbfdbdf18d26d74a8758ecbb4426b46b9134634e4f5be7f8a5ca0c99f137c3189839a98e272a5df60ef77d3d3e38367bfacc237ce946
+  metadata.gz: c2d66db62701612624579a88be2603250e752722233cfd11d379c4e95488b6dcb403265a344edc9491569b2eb9a87b393d4e669d160eec155caf635a35ccf145
+  data.tar.gz: 2bf5dab96aa4bd2b640e8ec70b9bfc6c2ad3ba62e491f452c6e02f1c38b17719557e3f57833e5053d1218e0d2a1f581b070a5105f55bfd68f71cc50e498b08f3

data/README.md

@@ -24,6 +24,8 @@ status = client.from_audios.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::Infinitalk` error classes when building video jobs, Rails workers, or scripts. The available resources include from audios. Keep `RUNAPI_API_KEY` in the environment or your secret manager; never commit API keys or callback secrets.

data/lib/runapi/infinitetalk/client.rb

@@ -2,14 +2,24 @@
 
 module RunApi
   module Infinitetalk
-    class Client
+    # InfiniteTalk lip-sync video generation client. Produces talking-head videos
+    # by animating a portrait image to match an audio track's speech or singing.
+    #
+    # @example
+    #   client = RunApi::Infinitetalk::Client.new(api_key: "sk-...")
+    #   result = client.audio_to_video.run(
+    #     model: "infinitetalk-from-audio",
+    #     source_image_url: "https://example.com/portrait.jpg",
+    #     source_audio_url: "https://example.com/voice.mp3",
+    #     prompt: "A young woman talking on a podcast"
+    #   )
+    #   puts result.videos.first.url
+    class Client < RunApi::Core::Client
+      # @return [Resources::AudioToVideo] Lip-synced video generation from a portrait image and audio track.
       attr_reader :audio_to_video
 
       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
         @audio_to_video = Resources::AudioToVideo.new(http)
       end
     end

data/lib/runapi/infinitetalk/resources/audio_to_video.rb

@@ -3,6 +3,8 @@
 module RunApi
   module Infinitetalk
     module Resources
+      # Generates lip-synced talking-head videos from a portrait image and an audio track.
+      # The output video shows the person speaking or singing in sync with the audio.
       class AudioToVideo
         include RunApi::Core::ResourceHelpers
 

data/lib/runapi/infinitetalk/types.rb

@@ -3,13 +3,18 @@
 module RunApi
   module Infinitetalk
     module Types
+      # Available model identifiers for audio-to-video generation.
       MODELS = %w[infinitetalk-from-audio].freeze
+      # Output resolution options. Higher resolution increases fidelity but takes longer.
       RESOLUTIONS = %w[480p 720p].freeze
 
+      # A generated video asset.
       class Video < RunApi::Core::BaseModel
         optional :url, String
       end
 
+      # Result of an audio-to-video generation task.
+      # While processing, +videos+ is nil; once completed, it contains the generated lip-synced video(s).
       class AudioToVideoResponse < RunApi::Core::TaskResponse
         required :id, String
         optional :status, String, enum: -> { RunApi::Core::TaskResponse::Status::ALL }
@@ -17,6 +22,7 @@ module RunApi
         optional :error, String
       end
 
+      # Narrowed response type guaranteed to contain completed videos.
       class CompletedAudioToVideoResponse < AudioToVideoResponse
         required :videos, [-> { Video }]
       end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: runapi-infinitetalk
 version: !ruby/object:Gem::Version
-  version: 0.2.5
+  version: 0.2.6
 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 infinitetalk api Ruby SDK is the language-specific package for InfiniteTalk
   on RunAPI. Use this infinitetalk api package for text-to-video, image-to-video,
   video editing, and animation flows when your application needs JSON request bodies,