runapi-infinitetalk 0.2.5 → 0.2.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4fa0e1602f6bec3ba27af06b285047d873ab0994632c1018b0457c30ea538a6c
-  data.tar.gz: 86d3f1116b288566c4a1e0cf6dd18f16c3043b3e48b79da9211d3814ec650685
+  metadata.gz: e89cac6baa5f9d175c9fd56314131d2af51d6487c9a9367e61938f3627f003c8
+  data.tar.gz: fb5b1c2e61201b5a9d6459cfb361c7f967d9b35cd9264b9b37eab0692acc250c
 SHA512:
-  metadata.gz: 803e3c8713bc01a19513f2800cea7ac73dc12b875f589d5a92457a36810dd5d160c717fddb11022ac5eadea52227ae6e18f89ccd64aa36bbb868d01aaf97258c
-  data.tar.gz: e8f15d25513e3ca96775bbfdbdf18d26d74a8758ecbb4426b46b9134634e4f5be7f8a5ca0c99f137c3189839a98e272a5df60ef77d3d3e38367bfacc237ce946
+  metadata.gz: 7e77fd019642d0bfb19b9646134df5f273d6cc6dfde150d98d8d7fb5ea50ae3b64844031145ecfb9e9c8e3db4d78ef37795ec2c1e9db8a13cd55fb4446b0c539
+  data.tar.gz: 53d70b3746b85b30ff80863c5c50fcc615831ad0f0dd6fca4846a0db9d2f203d26e2d8152c09f58eb21d9b29bd80b9ce0d8b70fc3b72e6c6fbb91916283fcd54

data/README.md

@@ -1,42 +1,44 @@
-# Infinitetalk API Ruby SDK for RunAPI
+# InfiniteTalk Ruby SDK for RunAPI
 
-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, task status lookup, and consistent RunAPI errors in Ruby.
+The InfiniteTalk Ruby SDK is the language-specific package for InfiniteTalk 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 errors in Ruby.
 
-This infinitetalk api README is the Ruby package guide inside the public `infinitalk-sdk` repository. For the repository overview, start at `../README.md`; for model details, use https://runapi.ai/models/infinitalk; for API reference, use https://runapi.ai/docs#infinitalk; for SDK docs, use https://runapi.ai/docs#sdk-infinitalk.
+This README is the Ruby package guide inside the public `infinitetalk-sdk` repository. For the repository overview, start at `../README.md`; for model details, use https://runapi.ai/models/infinitetalk; for API reference, use https://runapi.ai/docs#infinitetalk; for SDK docs, use https://runapi.ai/docs#sdk-infinitetalk.
 
 ## Install
 
 ```bash
-gem install runapi-infinitalk
+gem install runapi-infinitetalk
 ```
 
 ## Quick start
 
 ```ruby
-require "runapi-infinitalk"
+require "runapi-infinitetalk"
 
 client = RunApi::Infinitalk::Client.new
-task = client.from_audios.create(
-  # Pass the InfiniteTalk JSON request body from https://runapi.ai/docs#infinitalk.
+task = client.audio_to_video.create(
+  # Pass the InfiniteTalk JSON request body from https://runapi.ai/docs#infinitetalk.
 )
-status = client.from_audios.get(task.id)
+status = client.audio_to_video.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.
+Use Ruby keyword arguments and the `RunApi::Infinitalk` error classes when building video jobs, Rails workers, or scripts. The available resources are `audio_to_video`. Keep `RUNAPI_API_KEY` in the environment or your secret manager; never commit API keys or callback secrets.
 
 ## Links
 
-- Model page: https://runapi.ai/models/infinitalk
-- SDK docs: https://runapi.ai/docs#sdk-infinitalk
-- Product docs: https://runapi.ai/docs#infinitalk
-- Pricing and rate limits: https://runapi.ai/models/infinitalk
+- Model page: https://runapi.ai/models/infinitetalk
+- SDK docs: https://runapi.ai/docs#sdk-infinitetalk
+- Product docs: https://runapi.ai/docs#infinitetalk
+- Pricing and rate limits: https://runapi.ai/models/infinitetalk
 - Provider comparison: https://runapi.ai/providers/meigen-ai
 - Full catalog: https://runapi.ai/models
-- Repository: https://github.com/runapi-ai/infinitalk-sdk
+- Repository: https://github.com/runapi-ai/infinitetalk-sdk
 
 ## License
 

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://cdn.runapi.ai/public/samples/portrait.jpg",
+    #     source_audio_url: "https://cdn.runapi.ai/public/samples/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/contract_gen.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module RunApi
+  module Infinitetalk
+    CONTRACT = {
+      "audio-to-video" => {
+        "models" => ["infinitetalk-from-audio"],
+        "fields_by_model" => {
+          "infinitetalk-from-audio" => {
+            "output_resolution" => {
+              "enum" => ["480p", "720p"]
+            },
+            "seed" => {
+              "type" => "integer"
+            },
+            "source_audio_url" => {
+              "required" => true
+            },
+            "source_image_url" => {
+              "required" => true
+            }
+          }
+        }
+      }
+    }.freeze
+  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
 
@@ -34,22 +36,14 @@ module RunApi
         private
 
         def validate_params!(params)
-          model = param(params, :model)
-          raise Core::ValidationError, "model is required" unless model
-          unless Types::MODELS.include?(model)
-            raise Core::ValidationError, "Invalid model: #{model}. Must be one of: #{Types::MODELS.join(", ")}"
-          end
+          validate_contract!(CONTRACT["audio-to-video"], params)
 
-          validate_required!(params, :source_image_url)
-          validate_required!(params, :source_audio_url)
           prompt = param(params, :prompt)
           raise Core::ValidationError, "prompt is required" unless prompt.is_a?(String) && !prompt.empty?
           if prompt.length > PROMPT_MAX_LENGTH
             raise Core::ValidationError, "prompt must be at most #{PROMPT_MAX_LENGTH} characters"
           end
 
-          validate_optional!(params, :output_resolution, Types::RESOLUTIONS)
-
           seed = param(params, :seed)
           return if seed.nil?
 
@@ -58,13 +52,6 @@ module RunApi
 
           raise Core::ValidationError, "seed must be an integer between #{SEED_RANGE.min} and #{SEED_RANGE.max}"
         end
-
-        def validate_required!(params, key)
-          value = param(params, key)
-          return if value.is_a?(String) ? !value.empty? : !value.nil?
-
-          raise Core::ValidationError, "#{key} is required"
-        end
       end
     end
   end

data/lib/runapi/infinitetalk/types.rb

@@ -3,13 +3,13 @@
 module RunApi
   module Infinitetalk
     module Types
-      MODELS = %w[infinitetalk-from-audio].freeze
-      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 +17,7 @@ module RunApi
         optional :error, String
       end
 
+      # Narrowed response type guaranteed to contain completed videos.
       class CompletedAudioToVideoResponse < AudioToVideoResponse
         required :videos, [-> { Video }]
       end

data/lib/runapi/infinitetalk.rb

@@ -2,6 +2,7 @@
 
 require "runapi/core"
 require_relative "infinitetalk/types"
+require_relative "infinitetalk/contract_gen"
 require_relative "infinitetalk/resources/audio_to_video"
 require_relative "infinitetalk/client"
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: runapi-infinitetalk
 version: !ruby/object:Gem::Version
-  version: 0.2.5
+  version: 0.2.7
 platform: ruby
 authors:
 - RunAPI
@@ -15,18 +15,18 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.5
+        version: 0.2.7
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.5
-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,
-  task status lookup, and consistent RunAPI errors in Ruby.
+        version: 0.2.7
+description: The InfiniteTalk Ruby SDK is the language-specific package for InfiniteTalk
+  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
+  errors in Ruby.
 email:
 - contact@runapi.ai
 executables: []
@@ -39,15 +39,18 @@ files:
 - lib/runapi-infinitetalk.rb
 - lib/runapi/infinitetalk.rb
 - lib/runapi/infinitetalk/client.rb
+- lib/runapi/infinitetalk/contract_gen.rb
 - lib/runapi/infinitetalk/resources/audio_to_video.rb
 - lib/runapi/infinitetalk/types.rb
 homepage: https://runapi.ai/models/infinitetalk
 licenses:
 - Apache-2.0
 metadata:
+  runapi_slug: infinitetalk
   homepage_uri: https://runapi.ai/models/infinitetalk
   documentation_uri: https://github.com/runapi-ai/infinitetalk-sdk/blob/main/ruby/README.md
   source_code_uri: https://github.com/runapi-ai/infinitetalk-sdk
+  bug_tracker_uri: https://github.com/runapi-ai/infinitetalk-sdk/issues
   changelog_uri: https://github.com/runapi-ai/infinitetalk-sdk/blob/main/CHANGELOG.md
 rdoc_options: []
 require_paths:
@@ -65,5 +68,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 4.0.10
 specification_version: 4
-summary: Infinitetalk API Ruby SDK for RunAPI
+summary: InfiniteTalk Ruby SDK for RunAPI
 test_files: []