runapi-runway 0.2.7 → 0.2.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 59ad3e607d33dc4bb65bd09cbf86eaf3ff1de1c48c319db17a6ff01e28e506e1
-  data.tar.gz: bdb1f84d784e5edcb01566aafd8f82865c6b6cf2b2552464981c16d6e29745c5
+  metadata.gz: ad79cfb3fe2fd25106c5b06257c8f4a204bc2f423fa033cf7fd7c37af6aaf5a0
+  data.tar.gz: 0ea01d23599ba93b73cca5b682fceeb2d40c27d258f0c2c245f937dfbd5d4fff
 SHA512:
-  metadata.gz: 0b0be7c1953ea69ff61be3c96c23fb5f615288da5d6e8f8b9f72e71eb748049c0eab3697dc9576c3549116ac9f1eae18fbc1662040c6097971b5289adb16efef
-  data.tar.gz: d88f0bf293488b0c5da4bd817578820525f8b7edb7a0ccffcb57044bb8f09030f6de5389fb2264108e1adcfd12d4f11d0ea9ae4e795dca7ea6f5a01cac75d91e
+  metadata.gz: 4d452b908a3800518ccc32c8d9a300b24f8e47afd51f597d3703e1da2af01f899195437ad8483807825253b0970f3d67acd8da850674fb0c43f927f7d5a0f780
+  data.tar.gz: c8d1792c8e980bfe52f58c9fac6cfc4f8ce397bdae4abb31eebcd2cc74100574ed30f1311e8fc3f054f3481ad0605b0ec7cbd1bc00782a503c893b601decb521

data/README.md

@@ -1,8 +1,8 @@
-# Runway API Ruby SDK for RunAPI
+# Runway Ruby SDK for RunAPI
 
-The runway api Ruby SDK is the language-specific package for Runway on RunAPI. Use this runway 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 Runway Ruby SDK is the language-specific package for Runway 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 runway api README is the Ruby package guide inside the public `runway-sdk` repository. For the repository overview, start at `../README.md`; for model details, use https://runapi.ai/models/runway; for API reference, use https://runapi.ai/docs#runway; for SDK docs, use https://runapi.ai/docs#sdk-runway.
+This README is the Ruby package guide inside the public `runway-sdk` repository. For the repository overview, start at `../README.md`; for model details, use https://runapi.ai/models/runway; for API reference, use https://runapi.ai/docs#runway; for SDK docs, use https://runapi.ai/docs#sdk-runway.
 
 ## Install
 
@@ -13,7 +13,7 @@ gem install runapi-runway
 ## Quick start
 
 ```ruby
-require "runapi-runway"
+require "runapi/runway"
 
 client = RunApi::Runway::Client.new
 task = client.text_to_video.create(

data/lib/runapi/runway/contract_gen.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module RunApi
+  module Runway
+    CONTRACT = {
+      "extend-video" => {
+        "models" => ["runway"],
+        "fields_by_model" => {
+          "runway" => {
+            "output_resolution" => {
+              "enum" => ["720p", "1080p"],
+              "required" => true
+            },
+            "prompt" => {
+              "required" => true
+            },
+            "source_task_id" => {
+              "required" => true
+            }
+          }
+        }
+      },
+      "text-to-video" => {
+        "models" => ["runway"],
+        "fields_by_model" => {
+          "runway" => {
+            "aspect_ratio" => {
+              "enum" => ["16:9", "9:16", "1:1", "4:3", "3:4"]
+            },
+            "duration_seconds" => {
+              "enum" => [5, 10],
+              "required" => true,
+              "type" => "integer"
+            },
+            "output_resolution" => {
+              "enum" => ["720p", "1080p"],
+              "required" => true
+            },
+            "prompt" => {
+              "required" => true
+            }
+          }
+        }
+      }
+    }.freeze
+  end
+end

data/lib/runapi/runway/resources/extend_video.rb

@@ -11,6 +11,7 @@ module RunApi
         ENDPOINT = "/api/v1/runway/extend_video"
         RESPONSE_CLASS = Types::TaskCreateResponse
         COMPLETED_RESPONSE_CLASS = Types::CompletedTaskResponse
+        MODEL = "runway"
 
         def initialize(http)
           @http = http
@@ -24,36 +25,27 @@ module RunApi
         # @param watermark [String, nil] watermark text burned into the output
         # @param callback_url [String, nil] webhook URL for completion notification
         # @return [RunApi::Runway::Types::CompletedTaskResponse] completed task with videos
-        def run(**params)
-          task = create(**params)
-          poll_until_complete { get(task.id) }
+        def run(options: nil, **params)
+          task = create(options: options, **params)
+          poll_until_complete { get(task.id, options: options) }
         end
 
         # Create an extend-video task without waiting for completion.
         #
         # @param params [Hash] extend-video parameters (see {#run} for details)
         # @return [RunApi::Runway::Types::TaskCreateResponse] task creation result with id
-        def create(**params)
+        def create(options: nil, **params)
           params = compact_params(params)
-          validate_params!(params)
-          request(:post, ENDPOINT, body: params)
+          validate_contract!(CONTRACT["extend-video"], params.merge(model: MODEL))
+          request(:post, ENDPOINT, body: params, options: options)
         end
 
         # Get extend-video task status by task ID.
         #
         # @param id [String] task ID
         # @return [RunApi::Runway::Types::TaskResponse] current task status
-        def get(id)
-          request(:get, "#{ENDPOINT}/#{id}")
-        end
-
-        private
-
-        def validate_params!(params)
-          raise Core::ValidationError, "source_task_id is required" unless param(params, :source_task_id)
-          raise Core::ValidationError, "prompt is required" unless param(params, :prompt)
-          raise Core::ValidationError, "output_resolution is required" unless param(params, :output_resolution)
-          validate_optional!(params, :output_resolution, Types::OUTPUT_RESOLUTIONS)
+        def get(id, options: nil)
+          request(:get, "#{ENDPOINT}/#{id}", options: options)
         end
       end
     end

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

@@ -11,6 +11,7 @@ module RunApi
         ENDPOINT = "/api/v1/runway/text_to_video"
         RESPONSE_CLASS = Types::TaskCreateResponse
         COMPLETED_RESPONSE_CLASS = Types::CompletedTaskResponse
+        MODEL = "runway"
 
         def initialize(http)
           @http = http
@@ -26,37 +27,27 @@ module RunApi
         # @param watermark [String, nil] watermark text burned into the output
         # @param callback_url [String, nil] webhook URL for completion notification
         # @return [RunApi::Runway::Types::CompletedTaskResponse] completed task with videos
-        def run(**params)
-          task = create(**params)
-          poll_until_complete { get(task.id) }
+        def run(options: nil, **params)
+          task = create(options: options, **params)
+          poll_until_complete { get(task.id, options: options) }
         end
 
         # Create a text-to-video task without waiting for completion.
         #
         # @param params [Hash] text-to-video parameters (see {#run} for details)
         # @return [RunApi::Runway::Types::TaskCreateResponse] task creation result with id
-        def create(**params)
+        def create(options: nil, **params)
           params = compact_params(params)
-          validate_params!(params)
-          request(:post, ENDPOINT, body: params)
+          validate_contract!(CONTRACT["text-to-video"], params.merge(model: MODEL))
+          request(:post, ENDPOINT, body: params, options: options)
         end
 
         # Get text-to-video task status by task ID.
         #
         # @param id [String] task ID
         # @return [RunApi::Runway::Types::TaskResponse] current task status
-        def get(id)
-          request(:get, "#{ENDPOINT}/#{id}")
-        end
-
-        private
-
-        def validate_params!(params)
-          raise Core::ValidationError, "prompt is required" unless param(params, :prompt)
-          raise Core::ValidationError, "duration_seconds is required" unless param(params, :duration_seconds)
-          raise Core::ValidationError, "output_resolution is required" unless param(params, :output_resolution)
-          validate_optional!(params, :output_resolution, Types::OUTPUT_RESOLUTIONS)
-          validate_optional!(params, :aspect_ratio, Types::ASPECT_RATIOS)
+        def get(id, options: nil)
+          request(:get, "#{ENDPOINT}/#{id}", options: options)
         end
       end
     end

data/lib/runapi/runway/types.rb

@@ -4,13 +4,6 @@ module RunApi
   module Runway
     # Type definitions and constants for Runway Gen-4 video generation.
     module Types
-      # Output resolution. 720p (1280x720) is faster and lower cost;
-      # 1080p (1920x1080) produces higher detail at higher cost.
-      OUTPUT_RESOLUTIONS = %w[720p 1080p].freeze
-
-      # Aspect ratio for pure text-to-video. Ignored when a first-frame image is provided.
-      ASPECT_RATIOS = %w[16:9 9:16 1:1 4:3 3:4].freeze
-
       # A generated video file with a download URL.
       class Video < RunApi::Core::BaseModel
         optional :id, String

data/lib/runapi/runway.rb

@@ -2,6 +2,7 @@
 
 require "runapi/core"
 require_relative "runway/types"
+require_relative "runway/contract_gen"
 require_relative "runway/resources/text_to_video"
 require_relative "runway/resources/extend_video"
 require_relative "runway/client"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: runapi-runway
 version: !ruby/object:Gem::Version
-  version: 0.2.7
+  version: 0.2.8
 platform: ruby
 authors:
 - RunAPI
@@ -15,18 +15,18 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.6
+        version: 0.3.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.6
-description: The runway api Ruby SDK is the language-specific package for Runway on
-  RunAPI. Use this runway 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.3.0
+description: The Runway Ruby SDK is the language-specific package for Runway 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,6 +39,7 @@ files:
 - lib/runapi-runway.rb
 - lib/runapi/runway.rb
 - lib/runapi/runway/client.rb
+- lib/runapi/runway/contract_gen.rb
 - lib/runapi/runway/resources/extend_video.rb
 - lib/runapi/runway/resources/text_to_video.rb
 - lib/runapi/runway/types.rb
@@ -46,9 +47,11 @@ homepage: https://runapi.ai/models/runway
 licenses:
 - Apache-2.0
 metadata:
+  runapi_slug: runway
   homepage_uri: https://runapi.ai/models/runway
   documentation_uri: https://github.com/runapi-ai/runway-sdk/blob/main/ruby/README.md
   source_code_uri: https://github.com/runapi-ai/runway-sdk
+  bug_tracker_uri: https://github.com/runapi-ai/runway-sdk/issues
   changelog_uri: https://github.com/runapi-ai/runway-sdk/blob/main/CHANGELOG.md
 rdoc_options: []
 require_paths:
@@ -64,7 +67,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: Runway API Ruby SDK for RunAPI
+summary: Runway Ruby SDK for RunAPI
 test_files: []