omnivideo-sdk 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 15b1fd7e7feac50200fa166f9877f560c1f5ca88221071399b76dd444e6318e8
+  data.tar.gz: 394cebc000b84e1d7f52bac3ec4dff2f69a986963272dea7378baeef8bdcce52
+SHA512:
+  metadata.gz: e8eb346898cd657e97f77bfb7b2c20993a3aa71529a278401aa2cdfcd7b055c2de81c0e0a287506e7a7b72da486c5a428049febe5210f7cf2e56869f22f7588b
+  data.tar.gz: 2276a07d746429d9529234a2859e6609d020b830ebe05d8796c9d1e78060f1061a2860e0d0cad0f7d3f02e357d59840c7220efa8c1814b4ce6ce8006a948b38d

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Omni Video
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,75 @@
+# omnivideo-sdk (Ruby)
+
+Ruby client for [Omni Video](https://omnivideo.net/) — generate video and image content with the **Gemini Omni Video** series of models.
+
+[Omni Video](https://omnivideo.net/) hosts the Gemini Omni Video family (`seedance-2` for text/image → video, `gpt-image-2` and `nano-banana-2` for text/image → image) behind one simple REST API.
+
+## Install
+
+```bash
+gem install omnivideo-sdk
+```
+
+Or in your Gemfile:
+
+```ruby
+gem "omnivideo-sdk"
+```
+
+## Get an API key
+
+Sign in at **<https://omnivideo.net/>**, open the account page, then create a `sk-…` token.
+
+```bash
+export OMNIVIDEO_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+```
+
+## Quick start
+
+```ruby
+require "omnivideo_sdk"
+
+client = OmnivideoSdk::Client.new  # reads ENV["OMNIVIDEO_API_KEY"]
+
+task = client.run(
+  model_id: "seedance-2",
+  prompt: "a serene zen garden at sunrise, ultra detailed",
+  aspect_ratio: "16:9"
+)
+puts task.output_url   # video_url or image_url
+```
+
+### Lower level
+
+```ruby
+task = client.create_task(
+  model_id: "gpt-image-2",
+  prompt: "cyberpunk corgi, neon rim light",
+  aspect_ratio: "1:1"
+)
+
+until task.done?
+  sleep 3
+  task = client.get_task(task.task_id)
+end
+puts task.image_url
+```
+
+## Models
+
+| `model_id`      | Modality           | Output      |
+| --------------- | ------------------ | ----------- |
+| `seedance-2`    | text/image → video | `video_url` |
+| `gpt-image-2`   | text/image → image | `image_url` |
+| `nano-banana-2` | text/image → image | `image_url` |
+
+See current models and pricing on [omnivideo.net](https://omnivideo.net/).
+
+## Links
+
+- Website & account: <https://omnivideo.net/>
+- API docs: <https://omnivideo.net/api-docs>
+
+## License
+
+MIT

data/lib/omnivideo_sdk.rb

@@ -0,0 +1,149 @@
+# frozen_string_literal: true
+
+require "json"
+require "net/http"
+require "uri"
+
+# Omni Video Ruby SDK — generate video and image content with the Gemini Omni Video models.
+# Sign in and create an API key at https://omnivideo.net/.
+module OmnivideoSdk
+  VERSION = "0.1.0"
+  DEFAULT_BASE_URL = "https://omnivideo.net/api/v1"
+
+  module TaskStatus
+    QUEUED  = 1
+    RUNNING = 2
+    SUCCESS = 3
+    FAILED  = 4
+  end
+
+  class Error < StandardError
+    attr_reader :code, :status
+    def initialize(message, code: nil, status: nil)
+      super(message)
+      @code = code
+      @status = status
+    end
+  end
+
+  Task = Struct.new(:task_id, :task_status, :image_url, :video_url, :credits, :raw, keyword_init: true) do
+    def done?
+      [TaskStatus::SUCCESS, TaskStatus::FAILED].include?(task_status)
+    end
+
+    def output_url
+      video_url || image_url
+    end
+  end
+
+  class Client
+    attr_reader :api_key, :base_url, :timeout
+
+    def initialize(api_key: nil, base_url: DEFAULT_BASE_URL, timeout: 60)
+      @api_key = api_key || ENV["OMNIVIDEO_API_KEY"]
+      raise Error, "Missing API key. Pass api_key: or set OMNIVIDEO_API_KEY. Get one at https://omnivideo.net/" if @api_key.nil? || @api_key.empty?
+
+      @base_url = base_url.sub(%r{/+\z}, "")
+      @timeout = timeout
+      @http_factory = nil
+    end
+
+    # Inject a custom HTTP factory (lambda yielding an object responding to #request) — used in tests.
+    attr_accessor :http_factory
+
+    def create_task(model_id:, prompt:, image_urls: nil, aspect_ratio: nil, **extra)
+      body = { model_id: model_id, prompt: prompt }
+      body[:image_urls] = image_urls unless image_urls.nil?
+      body[:aspect_ratio] = aspect_ratio unless aspect_ratio.nil?
+      body.merge!(extra)
+      data = request(:post, "/tasks/create", body: body)
+      to_task(data)
+    end
+
+    def get_task(task_id)
+      data = request(:get, "/tasks/#{task_id}")
+      to_task(data)
+    end
+
+    def run(model_id:, prompt:, image_urls: nil, aspect_ratio: nil, poll_interval: 3.0, max_wait: 600.0, **extra)
+      task = create_task(model_id: model_id, prompt: prompt, image_urls: image_urls, aspect_ratio: aspect_ratio, **extra)
+      deadline = monotonic + max_wait
+      until task.done?
+        raise Error.new("Task #{task.task_id} did not finish within #{max_wait}s", code: task.task_status) if monotonic > deadline
+
+        sleep_for(poll_interval)
+        task = get_task(task.task_id)
+      end
+      raise Error.new("Task #{task.task_id} failed", code: TaskStatus::FAILED) if task.task_status == TaskStatus::FAILED
+
+      task
+    end
+
+    private
+
+    def request(method, path, body: nil)
+      uri = URI.parse("#{@base_url}#{path}")
+      req = case method
+            when :get then Net::HTTP::Get.new(uri)
+            when :post then Net::HTTP::Post.new(uri)
+            else raise ArgumentError, "unsupported method: #{method}"
+            end
+      req["Authorization"] = "Bearer #{@api_key}"
+      req["Accept"] = "application/json"
+      if body
+        req["Content-Type"] = "application/json"
+        req.body = JSON.dump(body)
+      end
+      response = http_for(uri).request(req)
+      handle(response, uri)
+    end
+
+    def handle(response, uri)
+      status = response.code.to_i
+      raise Error.new("Unauthorized — check your OMNIVIDEO_API_KEY (https://omnivideo.net/).", status: 401) if status == 401
+
+      payload =
+        begin
+          response.body.to_s.empty? ? {} : JSON.parse(response.body)
+        rescue JSON::ParserError => e
+          raise Error.new("Invalid JSON from #{uri}: #{response.body.to_s[0, 200]}", status: status), cause: e
+        end
+      unless (200..299).cover?(status)
+        raise Error.new(payload["msg"] || "HTTP #{status}", code: payload["code"], status: status)
+      end
+      if payload["code"] && payload["code"] != 200
+        raise Error.new(payload["msg"] || "Business error", code: payload["code"])
+      end
+      payload
+    end
+
+    def http_for(uri)
+      return @http_factory.call(uri) if @http_factory
+
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.scheme == "https"
+      http.read_timeout = @timeout
+      http
+    end
+
+    def to_task(payload)
+      Task.new(
+        task_id: payload["task_id"].to_s,
+        task_status: payload["task_status"] || TaskStatus::QUEUED,
+        image_url: payload["image_url"],
+        video_url: payload["video_url"],
+        credits: payload["credits"],
+        raw: payload
+      )
+    end
+
+    def monotonic
+      Process.clock_gettime(Process::CLOCK_MONOTONIC)
+    end
+
+    # Hookable for tests.
+    def sleep_for(seconds)
+      sleep(seconds)
+    end
+  end
+end

metadata

@@ -0,0 +1,51 @@
+--- !ruby/object:Gem::Specification
+name: omnivideo-sdk
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Omni Video
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-05-16 00:00:00.000000000 Z
+dependencies: []
+description: Tiny Ruby client for the Omni Video API. Supports seedance-2 (video)
+  and gpt-image-2 / nano-banana-2 (image) under the Gemini Omni Video family. Sign
+  in and create a key at https://omnivideo.net/.
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/omnivideo_sdk.rb
+homepage: https://omnivideo.net/
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://omnivideo.net/
+  documentation_uri: https://omnivideo.net/api-docs
+  source_code_uri: https://omnivideo.net/
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.7'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3.1
+signing_key: 
+specification_version: 4
+summary: Omni Video Ruby SDK — generate video and image content with the Gemini Omni
+  Video series of models.
+test_files: []