runapi-gemini-omni 0.2.7 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7befcdce5d30097c0c8ad440c86bd8cd873e14aef90f59304f60d89eed3c2a29
-  data.tar.gz: ae2353b876a73b19681e151c46310e67edf1dc2f0c04565b5a5c7b10ff3630ce
+  metadata.gz: 85c5d15f2668b0387fd150f9c760b653600540475846b855ee0a69e212cea615
+  data.tar.gz: d7733e385a5d8905e06cec363f1ebd08822fbfedeb8e51321aa5045b42c79cc7
 SHA512:
-  metadata.gz: 3bc31cf371de32b41d86090294fa7feb13ca132d777fa2944ec71a13e015cafed6ef6ec1a6a0f99a8b96c0401703e63d4d38f1d1c4f4e91d0b2639a9734a940e
-  data.tar.gz: 6056184058b318efb10aaf4eacf012b571fb27d64536faa374f33e1bc182458c1e6dbd2e7cb3b0d7ef2473fc4a07fd3f655bf5d9ce259bcbb4cce672a734b3fd
+  metadata.gz: c9b843698b8a21b1d03233970d5036c1d5f052fd094a112e9685d053670da1ce1bb1a1f21d7a6736e8d600f977f8288b6c371d57301004981f1237abc743d98c
+  data.tar.gz: edd34f97fb07712d230557a012f7791182bf1e04384fcd32556b27cd4ce743956f4e7ee86a3745503292f3913775e3ddf59ada37207c4191e6c14ffe8297a882

data/README.md

@@ -1,6 +1,6 @@
-# Gemini Omni API Ruby SDK for RunAPI
+# Gemini Omni Ruby SDK for RunAPI
 
-The gemini omni api Ruby SDK is the language-specific package for Gemini Omni on RunAPI. Use this package for voice resources, character resources, and multimodal video workflows that need JSON request bodies, task status lookup, and consistent RunAPI errors in Ruby.
+The Gemini Omni Ruby SDK is the language-specific package for Gemini Omni on RunAPI. Use this package for voice resources, character resources, and multimodal video generation workflows when your application needs request bodies, task status lookup, and consistent RunAPI errors in Ruby.
 
 ## Install
 
@@ -11,7 +11,7 @@ gem install runapi-gemini-omni
 ## Quick start
 
 ```ruby
-require "runapi-gemini_omni"
+require "runapi/gemini_omni"
 
 client = RunApi::GeminiOmni::Client.new
 voice = client.create_audio.run(
@@ -21,14 +21,14 @@ voice = client.create_audio.run(
 
 character = client.create_character.run(
   descriptions: "A silver-haired cyberpunk guide",
-  image_urls: ["https://file.runapi.ai/demo/character.png"]
+  reference_image_url: "https://cdn.runapi.ai/public/samples/reference-1.jpg"
 )
 
 video = client.text_to_video.run(
-  prompt: "Create a neon city tracking shot with the character walking forward.",
-  duration: "8",
-  resolution: "1080p",
-  character_ids: [character.id]
+  model: "gemini-omni-flash-preview",
+  prompt: "A paper airplane glides through a sunlit studio.",
+  aspect_ratio: "16:9",
+  output_resolution: "720p"
 )
 ```
 
@@ -39,7 +39,7 @@ RunAPI-generated file URLs are temporary. Download and store generated images, v
 - Model page: https://runapi.ai/models/gemini-omni
 - SDK docs: https://runapi.ai/docs#sdk-gemini-omni
 - Product docs: https://runapi.ai/docs#gemini-omni
-- Pricing and rate limits: https://runapi.ai/models/gemini-omni
+- Flash Preview pricing and rate limits: https://runapi.ai/models/gemini-omni/flash-preview
 - Provider comparison: https://runapi.ai/providers/google
 - Full catalog: https://runapi.ai/models
 

data/lib/runapi/gemini_omni/contract_gen.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+module RunApi
+  module GeminiOmni
+    CONTRACT = {
+      "create-audio" => {
+        "models" => ["gemini-omni-audio"],
+        "fields_by_model" => {
+          "gemini-omni-audio" => {
+            "audio_id" => {
+              "required" => true
+            },
+            "name" => {
+              "required" => true
+            }
+          }
+        }
+      },
+      "create-character" => {
+        "models" => ["gemini-omni-character"],
+        "fields_by_model" => {
+          "gemini-omni-character" => {
+            "descriptions" => {
+              "required" => true
+            },
+            "reference_image_url" => {
+              "required" => true
+            }
+          }
+        }
+      },
+      "text-to-video" => {
+        "models" => ["gemini-omni-flash-preview", "gemini-omni-text-to-video"],
+        "fields_by_model" => {
+          "gemini-omni-flash-preview" => {
+            "aspect_ratio" => {
+              "enum" => ["16:9", "9:16"]
+            },
+            "duration_seconds" => {
+              "type" => "integer"
+            },
+            "output_resolution" => {
+              "enum" => ["720p"]
+            },
+            "prompt" => {
+              "required" => true
+            },
+            "seed" => {
+              "type" => "integer"
+            }
+          },
+          "gemini-omni-text-to-video" => {
+            "aspect_ratio" => {
+              "enum" => ["16:9", "9:16"]
+            },
+            "audio_ids" => {
+              "max_items" => 3
+            },
+            "character_ids" => {
+              "max_items" => 3
+            },
+            "duration_seconds" => {
+              "enum" => [4, 6, 8, 10],
+              "required" => true,
+              "type" => "integer"
+            },
+            "output_resolution" => {
+              "enum" => ["720p", "1080p", "4k"]
+            },
+            "prompt" => {
+              "required" => true
+            },
+            "reference_image_urls" => {
+              "max_items" => 7
+            },
+            "seed" => {
+              "type" => "integer"
+            },
+            "video_list" => {
+              "max_items" => 1
+            }
+          }
+        },
+        "rules" => [{
+          "when" => {
+            "model" => "gemini-omni-flash-preview"
+          },
+          "forbidden" => ["reference_image_urls", "audio_ids", "video_list", "character_ids", "duration_seconds", "seed"]
+        }]
+      }
+    }.freeze
+  end
+end

data/lib/runapi/gemini_omni/resources/create_audio.rb

@@ -10,6 +10,7 @@ module RunApi
 
         ENDPOINT = "/api/v1/gemini_omni/create_audio"
         RESPONSE_CLASS = Types::CreateAudioResponse
+        MODEL = "gemini-omni-audio"
         NAME_MAX_LENGTH = 210
         VOICE_DESCRIPTION_MAX_LENGTH = 20_000
         EXAMPLE_DIALOGUE_MAX_LENGTH = 120
@@ -18,29 +19,21 @@ module RunApi
           @http = http
         end
 
-        def run(**params)
+        def run(options: nil, **params)
           params = compact_params(params)
           validate_params!(params)
-          request(:post, ENDPOINT, body: params)
+          request(:post, ENDPOINT, body: params, options: options)
         end
 
         private
 
         def validate_params!(params)
-          validate_required!(params, :audio_id)
-          validate_required!(params, :name)
+          validate_contract!(CONTRACT["create-audio"], params.merge(model: MODEL))
           validate_length!(params, :name, NAME_MAX_LENGTH)
           validate_length!(params, :voice_description, VOICE_DESCRIPTION_MAX_LENGTH)
           validate_length!(params, :example_dialogue, EXAMPLE_DIALOGUE_MAX_LENGTH)
         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
-
         def validate_length!(params, key, max_length)
           value = param(params, key)
           return if value.nil? || value.to_s.length <= max_length

data/lib/runapi/gemini_omni/resources/create_character.rb

@@ -11,6 +11,7 @@ module RunApi
 
         ENDPOINT = "/api/v1/gemini_omni/create_character"
         RESPONSE_CLASS = Types::CreateCharacterResponse
+        MODEL = "gemini-omni-character"
         DESCRIPTIONS_MAX_LENGTH = 20_000
         CHARACTER_NAME_MAX_LENGTH = 210
 
@@ -18,34 +19,21 @@ module RunApi
           @http = http
         end
 
-        def run(**params)
+        def run(options: nil, **params)
           params = compact_params(params)
           validate_params!(params)
-          request(:post, ENDPOINT, body: params)
+          request(:post, ENDPOINT, body: params, options: options)
         end
 
         private
 
         def validate_params!(params)
-          validate_required!(params, :descriptions)
-          validate_required!(params, :reference_image_url)
+          validate_contract!(CONTRACT["create-character"], params.merge(model: MODEL))
           validate_array!(params, :audio_ids) if param(params, :audio_ids)
           validate_length!(params, :descriptions, DESCRIPTIONS_MAX_LENGTH)
           validate_length!(params, :character_name, CHARACTER_NAME_MAX_LENGTH)
         end
 
-        def validate_required!(params, key)
-          value = param(params, key)
-          present = if value.is_a?(Array)
-            value.any?
-          else
-            value.is_a?(String) ? !value.empty? : !value.nil?
-          end
-          return if present
-
-          raise Core::ValidationError, "#{key} is required"
-        end
-
         def validate_array!(params, key)
           return if param(params, key).is_a?(Array)
 

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

@@ -12,11 +12,8 @@ module RunApi
         ENDPOINT = "/api/v1/gemini_omni/text_to_video"
         RESPONSE_CLASS = Types::TextToVideoResponse
         COMPLETED_RESPONSE_CLASS = Types::CompletedTextToVideoResponse
+        DEFAULT_MODEL = "gemini-omni-text-to-video"
         PROMPT_MAX_LENGTH = 20_000
-        REFERENCE_IMAGE_URLS_MAX = 7
-        AUDIO_IDS_MAX = 3
-        VIDEO_LIST_MAX = 1
-        CHARACTER_IDS_MAX = 3
         REFERENCE_UNITS_MAX = 7
         VIDEO_REFERENCE_UNITS = 2
         MAX_TRIM_SECONDS = 10
@@ -25,51 +22,33 @@ module RunApi
           @http = http
         end
 
-        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
 
-        def create(**params)
+        def create(options: nil, **params)
           params = compact_params(params)
           validate_params!(params)
-          request(:post, ENDPOINT, body: params)
+          request(:post, ENDPOINT, body: params, options: options)
         end
 
-        def get(id)
-          request(:get, "#{ENDPOINT}/#{id}")
+        def get(id, options: nil)
+          request(:get, "#{ENDPOINT}/#{id}", options: options)
         end
 
         private
 
         def validate_params!(params)
-          validate_required!(params, :prompt)
-          validate_required!(params, :duration_seconds)
+          selected_model = param(params, :model)
+          selected_model = DEFAULT_MODEL if selected_model.nil? || selected_model.to_s.empty?
+          validate_contract!(CONTRACT["text-to-video"], params.merge(model: selected_model))
           validate_length!(params, :prompt, PROMPT_MAX_LENGTH)
-          validate_optional!(params, :duration_seconds, Types::DURATIONS)
-          validate_optional!(params, :aspect_ratio, Types::ASPECT_RATIOS)
-          validate_optional!(params, :output_resolution, Types::OUTPUT_RESOLUTIONS)
-          validate_array!(params, :reference_image_urls, REFERENCE_IMAGE_URLS_MAX) if param(params, :reference_image_urls)
-          validate_array!(params, :audio_ids, AUDIO_IDS_MAX) if param(params, :audio_ids)
-          validate_array!(params, :video_list, VIDEO_LIST_MAX) if param(params, :video_list)
-          validate_array!(params, :character_ids, CHARACTER_IDS_MAX) if param(params, :character_ids)
           validate_video_list!(param(params, :video_list)) if param(params, :video_list)
           validate_reference_units!(params)
           validate_seed!(params)
         end
 
-        def validate_required!(params, key)
-          value = param(params, key)
-          present = if value.is_a?(Array)
-            value.any?
-          else
-            value.is_a?(String) ? !value.empty? : !value.nil?
-          end
-          return if present
-
-          raise Core::ValidationError, "#{key} is required"
-        end
-
         def validate_length!(params, key, max_length)
           value = param(params, key)
           return if value.nil? || value.to_s.length <= max_length
@@ -77,14 +56,6 @@ module RunApi
           raise Core::ValidationError, "#{key} must be at most #{max_length} characters"
         end
 
-        def validate_array!(params, key, max_length)
-          value = param(params, key)
-          raise Core::ValidationError, "#{key} must be an array" unless value.is_a?(Array)
-          return if value.length <= max_length
-
-          raise Core::ValidationError, "#{key} accepts at most #{max_length} items"
-        end
-
         def validate_video_list!(items)
           items.each_with_index do |item, index|
             url = param(item, :url)

data/lib/runapi/gemini_omni/types.rb

@@ -44,12 +44,6 @@ module RunApi
         optional :error, String
       end
 
-      # Allowed video durations in seconds. Longer durations consume more credits.
-      DURATIONS = [4, 6, 8, 10].freeze
-      # Output aspect ratios: landscape (16:9) or portrait (9:16).
-      ASPECT_RATIOS = %w[16:9 9:16].freeze
-      # Output resolutions -- higher values produce sharper video at higher cost.
-      OUTPUT_RESOLUTIONS = %w[720p 1080p 4k].freeze
       # Valid seed range for reproducible generation.
       SEED_RANGE = (0..2_147_483_647)
 

data/lib/runapi/gemini_omni.rb

@@ -2,6 +2,7 @@
 
 require "runapi/core"
 require_relative "gemini_omni/types"
+require_relative "gemini_omni/contract_gen"
 require_relative "gemini_omni/resources/create_audio"
 require_relative "gemini_omni/resources/create_character"
 require_relative "gemini_omni/resources/text_to_video"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: runapi-gemini-omni
 version: !ruby/object:Gem::Version
-  version: 0.2.7
+  version: 0.3.1
 platform: ruby
 authors:
 - RunAPI
@@ -15,18 +15,18 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.6
+        version: 0.2.14
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.6
-description: The gemini omni api Ruby SDK is the language-specific package for Gemini
+        version: 0.2.14
+description: The Gemini Omni Ruby SDK is the language-specific package for Gemini
   Omni on RunAPI. Use this package for voice resources, character resources, and multimodal
-  video workflows that need JSON request bodies, task status lookup, and consistent
-  RunAPI errors in Ruby.
+  video generation 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-gemini_omni.rb
 - lib/runapi/gemini_omni.rb
 - lib/runapi/gemini_omni/client.rb
+- lib/runapi/gemini_omni/contract_gen.rb
 - lib/runapi/gemini_omni/resources/create_audio.rb
 - lib/runapi/gemini_omni/resources/create_character.rb
 - lib/runapi/gemini_omni/resources/text_to_video.rb
@@ -47,9 +48,11 @@ homepage: https://runapi.ai/models/gemini-omni
 licenses:
 - Apache-2.0
 metadata:
+  runapi_slug: gemini-omni
   homepage_uri: https://runapi.ai/models/gemini-omni
   documentation_uri: https://github.com/runapi-ai/gemini-omni-sdk/blob/main/ruby/README.md
   source_code_uri: https://github.com/runapi-ai/gemini-omni-sdk
+  bug_tracker_uri: https://github.com/runapi-ai/gemini-omni-sdk/issues
   changelog_uri: https://github.com/runapi-ai/gemini-omni-sdk/blob/main/CHANGELOG.md
 rdoc_options: []
 require_paths:
@@ -67,5 +70,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 4.0.10
 specification_version: 4
-summary: Gemini Omni API Ruby SDK for RunAPI
+summary: Gemini Omni Ruby SDK for RunAPI
 test_files: []