omniflash-sdk 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 84399f2a33feab8225aa7595c6cdf64f509c0b3b2d89fdb33418b2f07440fb30
+  data.tar.gz: 7edb3db7f8899f7ea9c0315d2d1fede4a2d8a94edb7cfb7017117a08e0ea32e8
+SHA512:
+  metadata.gz: fda2a6b5c1ffda0ddbcdd4c8c6facd78a98ebd46e2899f753bc8d216e82148e96c2d740836e38ada949b75941033bb0c37eda4666ead90581c73b85d88db625e
+  data.tar.gz: 3a919446aec3b43097e87493b710e6dc7408f61ba2dadc82ff6f51551305be1136f3ea1e9a8ebae27f8c5c6cee2608f34b074d115763da99ed7ac025ff711798

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Omni Flash
+
+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,74 @@
+# omniflash-sdk (Ruby)
+
+Ruby client for [Gemini Omni Flash](https://omniflash.net/) — generate short video clips (with synchronized audio) and images using Google's **Gemini Omni Flash** family of models.
+
+[Gemini Omni Flash](https://omniflash.net/) wraps the Omni Flash family (`seedance-2` for text/image → video + audio, `gpt-image-2` and `nano-banana-2` for text/image → image) behind one simple REST API.
+
+## Install
+
+```bash
+gem install omniflash-sdk
+```
+
+```ruby
+gem "omniflash-sdk"
+```
+
+## Get an API key
+
+Sign in at **[Gemini Omni Flash](https://omniflash.net/)**, open the account page, then create a `sk-…` token.
+
+```bash
+export OMNIFLASH_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+```
+
+## Quick start
+
+```ruby
+require "omniflash_sdk"
+
+client = OmniflashSdk::Client.new  # reads ENV["OMNIFLASH_API_KEY"]
+
+task = client.run(
+  model_id: "seedance-2",
+  prompt: "a kettle whistles as steam rises, cozy kitchen, warm light",
+  aspect_ratio: "16:9"
+)
+puts task.video_url
+puts task.audio_url   # synchronized audio
+```
+
+### 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` + `audio_url` |
+| `gpt-image-2`   | text/image → image | `image_url`             |
+| `nano-banana-2` | text/image → image | `image_url`             |
+
+See current models and pricing on [Gemini Omni Flash](https://omniflash.net/).
+
+## Links
+
+- Website & account: [Gemini Omni Flash](https://omniflash.net/)
+- API docs: <https://omniflash.net/api-docs>
+
+## License
+
+MIT

data/lib/omniflash_sdk.rb

@@ -0,0 +1,162 @@
+# frozen_string_literal: true
+
+require "json"
+require "net/http"
+require "uri"
+
+# Omni Flash Ruby SDK — generate short videos (with synchronized audio) and images
+# via the Gemini Omni Flash family of models.
+# Sign in and create an API key at https://omniflash.net/.
+module OmniflashSdk
+  VERSION = "0.1.0"
+  DEFAULT_BASE_URL = "https://omniflash.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, :audio_url,
+    :request_id, :task_type, :model_id, :credits, :created_at, :raw,
+    keyword_init: true
+  ) do
+    def done?
+      [TaskStatus::SUCCESS, TaskStatus::FAILED].include?(task_status)
+    end
+
+    def output_url
+      video_url || image_url || audio_url
+    end
+  end
+
+  class Client
+    attr_reader :api_key, :base_url, :timeout
+    attr_accessor :http_factory
+
+    def initialize(api_key: nil, base_url: DEFAULT_BASE_URL, timeout: 60)
+      @api_key = api_key || ENV["OMNIFLASH_API_KEY"]
+      raise Error, "Missing API key. Pass api_key: or set OMNIFLASH_API_KEY. Get one at https://omniflash.net/" if @api_key.nil? || @api_key.empty?
+
+      @base_url = base_url.sub(%r{/+\z}, "")
+      @timeout = timeout
+      @http_factory = nil
+    end
+
+    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)
+      Task.new(
+        task_id: (data["task_id"] || "").to_s,
+        task_status: TaskStatus::QUEUED,
+        request_id: data["request_id"],
+        credits: data["credits"],
+        raw: data
+      )
+    end
+
+    def get_task(task_id)
+      data = request(:get, "/tasks/#{task_id}")
+      task_from_data(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 OMNIFLASH_API_KEY (https://omniflash.net/).", status: 401) if status == 401
+
+      envelope =
+        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(envelope["msg"] || "HTTP #{status}", code: envelope["code"], status: status)
+      end
+      if envelope["code"] && envelope["code"] != 200
+        raise Error.new(envelope["msg"] || "Business error", code: envelope["code"])
+      end
+      envelope["data"] || envelope
+    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 task_from_data(data)
+      Task.new(
+        task_id: (data["task_id"] || "").to_s,
+        task_status: data["task_status"] || TaskStatus::QUEUED,
+        image_url: data["image_url"],
+        video_url: data["video_url"],
+        audio_url: data["audio_url"],
+        request_id: data["request_id"],
+        task_type: data["task_type"],
+        model_id: data["model_id"],
+        credits: data["credits"],
+        created_at: data["created_at"],
+        raw: data
+      )
+    end
+
+    def monotonic
+      Process.clock_gettime(Process::CLOCK_MONOTONIC)
+    end
+
+    def sleep_for(seconds)
+      sleep(seconds)
+    end
+  end
+end

metadata

@@ -0,0 +1,51 @@
+--- !ruby/object:Gem::Specification
+name: omniflash-sdk
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Omni Flash
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-05-20 00:00:00.000000000 Z
+dependencies: []
+description: Tiny Ruby client for the Omni Flash API. Supports seedance-2 (video +
+  audio) and gpt-image-2 / nano-banana-2 (image) under the Gemini Omni Flash family.
+  Sign in and create a key at https://omniflash.net/.
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/omniflash_sdk.rb
+homepage: https://omniflash.net/
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://omniflash.net/
+  documentation_uri: https://omniflash.net/api-docs
+  source_code_uri: https://omniflash.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 Flash Ruby SDK — generate short videos (with synchronized audio) and
+  images using the Gemini Omni Flash family of models.
+test_files: []