runapi-happyhorse 0.2.6 → 0.2.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8420f63d7f99ed90385490503c24de7fcb1057aafe9c7d2e707e0509df9daeb2
-  data.tar.gz: 76648efbe65479f2c4c042ae4e5d11b2fc51e8f76c0fe113836f784e797c4f98
+  metadata.gz: f6dce8cdd8d38b5c1062594b3de7c673544d2558abe8db1c616b35e81ae1c9bc
+  data.tar.gz: c2ab10637f4c26d08b77e6b44dc80eb51be19c99b6ba34d610656426771b6555
 SHA512:
-  metadata.gz: f7e08714a1d7b8ffb5f22ac49c0d652876eeedff7c8e0a460cb9114db6604d9a98c275cb56d8244b46a0602891f62bf2ab9af652afa824476de778dc9ef6acbf
-  data.tar.gz: fefb8e30365b1d577314ef2de5dcda68bce75f85125fd0734128a5f648f255a5f2a3bdd26fc1078d637631662265ce7ab49ed197deb071cc1cfbbe5b6411c701
+  metadata.gz: 6e19584b1a78ef79a9d869b5eef458afd4fb5b7b7d87d395db073e7654caf27bdc0a656b97851796cc0d7eb979113c9a1aa555cfa0c67d875c395dc2c6ee5be6
+  data.tar.gz: cd1e0d2335573a8ac73d3df65640555fc0afb3f4bc1427c1bf1386d232a209769f3a7a94a68eee82c86d9910be40b5927427beb3f07e535ee6f993ab30c5c8e6

data/README.md

@@ -1,6 +1,6 @@
 # HappyHorse API Ruby SDK for RunAPI
 
-The happyhorse ai api Ruby SDK is the language-specific package for HappyHorse on RunAPI. Use this package for text, image, and edit-video workflows that need JSON request bodies, task status lookup, and consistent RunAPI errors in Ruby.
+The HappyHorse Ruby SDK is the language-specific package for HappyHorse 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.
 
 ## Install
 

data/lib/runapi/happyhorse/contract_gen.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+module RunApi
+  module HappyHorse
+    CONTRACT = {
+      "edit-video" => {
+        "models" => ["happyhorse-edit-video"],
+        "fields_by_model" => {
+          "happyhorse-edit-video" => {
+            "audio_setting" => {
+              "enum" => ["auto", "original"]
+            },
+            "output_resolution" => {
+              "enum" => ["720p", "1080p"]
+            },
+            "seed" => {
+              "type" => "integer"
+            },
+            "source_video_url" => {
+              "required" => true
+            }
+          }
+        }
+      },
+      "image-to-video" => {
+        "models" => ["happyhorse-image-to-video"],
+        "fields_by_model" => {
+          "happyhorse-image-to-video" => {
+            "duration_seconds" => {
+              "type" => "integer"
+            },
+            "first_frame_image_url" => {
+              "required" => true
+            },
+            "output_resolution" => {
+              "enum" => ["720p", "1080p"]
+            },
+            "seed" => {
+              "type" => "integer"
+            }
+          }
+        }
+      },
+      "text-to-video" => {
+        "models" => ["happyhorse-character", "happyhorse-text-to-video"],
+        "fields_by_model" => {
+          "happyhorse-character" => {
+            "aspect_ratio" => {
+              "enum" => ["16:9", "9:16", "1:1", "4:3", "3:4"]
+            },
+            "duration_seconds" => {
+              "type" => "integer"
+            },
+            "output_resolution" => {
+              "enum" => ["720p", "1080p"]
+            },
+            "reference_image_urls" => {
+              "required" => true
+            },
+            "seed" => {
+              "type" => "integer"
+            }
+          },
+          "happyhorse-text-to-video" => {
+            "aspect_ratio" => {
+              "enum" => ["16:9", "9:16", "1:1", "4:3", "3:4"]
+            },
+            "duration_seconds" => {
+              "type" => "integer"
+            },
+            "output_resolution" => {
+              "enum" => ["720p", "1080p"]
+            },
+            "seed" => {
+              "type" => "integer"
+            }
+          }
+        }
+      }
+    }.freeze
+  end
+end

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

@@ -48,17 +48,15 @@ module RunApi
         private
 
         def validate_params!(params)
-          raise Core::ValidationError, "model is required" unless param(params, :model) == Types::EDIT_VIDEO_MODEL
+          validate_contract!(CONTRACT["edit-video"], params)
+
           raise Core::ValidationError, "prompt is required" unless param(params, :prompt)
-          raise Core::ValidationError, "source_video_url is required" unless param(params, :source_video_url)
 
           reference_image_urls = param(params, :reference_image_urls)
           if reference_image_urls && (!reference_image_urls.is_a?(Array) || !REFERENCE_IMAGE_RANGE.cover?(reference_image_urls.size))
             raise Core::ValidationError, "reference_image_urls must include at most #{REFERENCE_IMAGE_RANGE.max} entries"
           end
 
-          validate_optional!(params, :output_resolution, Types::OUTPUT_RESOLUTIONS)
-          validate_optional!(params, :audio_setting, Types::AUDIO_SETTINGS)
           validate_integer_range!(params, :seed, Types::SEED_RANGE)
         end
 

data/lib/runapi/happyhorse/resources/image_to_video.rb

@@ -47,10 +47,8 @@ module RunApi
         private
 
         def validate_params!(params)
-          raise Core::ValidationError, "model is required" unless param(params, :model) == Types::IMAGE_TO_VIDEO_MODEL
-          raise Core::ValidationError, "first_frame_image_url is required" unless param(params, :first_frame_image_url)
+          validate_contract!(CONTRACT["image-to-video"], params)
 
-          validate_optional!(params, :output_resolution, Types::OUTPUT_RESOLUTIONS)
           validate_integer_range!(params, :duration_seconds, Types::DURATION_RANGE)
           validate_integer_range!(params, :seed, Types::SEED_RANGE)
         end

data/lib/runapi/happyhorse/resources/text_to_video.rb

@@ -48,21 +48,19 @@ module RunApi
         private
 
         def validate_params!(params)
-          model = param(params, :model)
-          raise Core::ValidationError, "model is required" unless Types::TEXT_TO_VIDEO_MODELS.include?(model)
+          validate_contract!(CONTRACT["text-to-video"], params)
+
           raise Core::ValidationError, "prompt is required" unless param(params, :prompt)
 
           reference_image_urls = param(params, :reference_image_urls)
-          if model == Types::CHARACTER_MODEL
-            unless reference_image_urls.is_a?(Array) && REFERENCE_IMAGE_URLS_RANGE.cover?(reference_image_urls.size)
+          if param(params, :model) == Types::CHARACTER_MODEL
+            if reference_image_urls && !(reference_image_urls.is_a?(Array) && REFERENCE_IMAGE_URLS_RANGE.cover?(reference_image_urls.size))
               raise Core::ValidationError, "reference_image_urls must include between #{REFERENCE_IMAGE_URLS_RANGE.min} and #{REFERENCE_IMAGE_URLS_RANGE.max} entries"
             end
           elsif reference_image_urls
             raise Core::ValidationError, "reference_image_urls is only supported for #{Types::CHARACTER_MODEL}"
           end
 
-          validate_optional!(params, :output_resolution, Types::OUTPUT_RESOLUTIONS)
-          validate_optional!(params, :aspect_ratio, Types::ASPECT_RATIOS)
           validate_integer_range!(params, :duration_seconds, Types::DURATION_RANGE)
           validate_integer_range!(params, :seed, Types::SEED_RANGE)
         end

data/lib/runapi/happyhorse/types.rb

@@ -4,20 +4,8 @@ module RunApi
   module HappyHorse
     # Type definitions and constants for HappyHorse video generation and editing.
     module Types
-      # Standard text-to-video model.
-      TEXT_TO_VIDEO_MODEL = "happyhorse-text-to-video"
       # Character-consistent model; requires 1-9 reference_image_urls.
       CHARACTER_MODEL = "happyhorse-character"
-      # All text-to-video model variants.
-      TEXT_TO_VIDEO_MODELS = [TEXT_TO_VIDEO_MODEL, CHARACTER_MODEL].freeze
-      IMAGE_TO_VIDEO_MODEL = "happyhorse-image-to-video"
-      EDIT_VIDEO_MODEL = "happyhorse-edit-video"
-      # Output resolution options. Defaults to 1080p.
-      OUTPUT_RESOLUTIONS = %w[720p 1080p].freeze
-      # Aspect ratio options. Defaults to 16:9.
-      ASPECT_RATIOS = %w[16:9 9:16 1:1 4:3 3:4].freeze
-      # Audio handling for video editing: "auto" lets the model decide, "original" preserves source audio.
-      AUDIO_SETTINGS = %w[auto original].freeze
       # Duration range in seconds (3-15). Defaults to 5.
       DURATION_RANGE = (3..15)
       # Reproducibility seed range.

data/lib/runapi/happyhorse.rb

@@ -2,6 +2,7 @@
 
 require "runapi/core"
 require_relative "happyhorse/types"
+require_relative "happyhorse/contract_gen"
 require_relative "happyhorse/resources/edit_video"
 require_relative "happyhorse/resources/image_to_video"
 require_relative "happyhorse/resources/text_to_video"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: runapi-happyhorse
 version: !ruby/object:Gem::Version
-  version: 0.2.6
+  version: 0.2.7
 platform: ruby
 authors:
 - RunAPI
@@ -15,17 +15,18 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.6
+        version: 0.2.7
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.6
-description: The happyhorse ai api Ruby SDK is the language-specific package for HappyHorse
-  on RunAPI. Use this package for text, image, and edit-video workflows that need
-  JSON request bodies, task status lookup, and consistent RunAPI errors in Ruby.
+        version: 0.2.7
+description: The HappyHorse Ruby SDK is the language-specific package for HappyHorse
+  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: []
@@ -38,6 +39,7 @@ files:
 - lib/runapi-happyhorse.rb
 - lib/runapi/happyhorse.rb
 - lib/runapi/happyhorse/client.rb
+- lib/runapi/happyhorse/contract_gen.rb
 - lib/runapi/happyhorse/resources/edit_video.rb
 - lib/runapi/happyhorse/resources/image_to_video.rb
 - lib/runapi/happyhorse/resources/text_to_video.rb
@@ -46,9 +48,11 @@ homepage: https://runapi.ai/models/happyhorse
 licenses:
 - Apache-2.0
 metadata:
+  runapi_slug: happyhorse
   homepage_uri: https://runapi.ai/models/happyhorse
   documentation_uri: https://github.com/runapi-ai/happyhorse-sdk/blob/main/ruby/README.md
   source_code_uri: https://github.com/runapi-ai/happyhorse-sdk
+  bug_tracker_uri: https://github.com/runapi-ai/happyhorse-sdk/issues
   changelog_uri: https://github.com/runapi-ai/happyhorse-sdk/blob/main/CHANGELOG.md
 rdoc_options: []
 require_paths: