aigifmaker 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c93c6ee3782f75742a19707c49bfe0988a265330640750624fa23603b7851ea5
+  data.tar.gz: cf2f3f1c6c24ce99d569f081183b37bbdfb095eb27ed8f049f372a117d63ec5b
+SHA512:
+  metadata.gz: 59d9728075bd774d504deb46ee3aca29c15f1be907d37404bbf4239bd6dc7dd8aeac7937ad47ba1b7099c3aeb7f99882d0e51da72f3f201a93e42d28d9b324ab
+  data.tar.gz: dea93c1b9b94aeb4017f8da901d704ea513478c4e35901babd7d1d9403dea9e281097e948473c3d80e0a0c42a0ac4eb66f6da7b903c65efdd4ae8538d4adb03e

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AI GIF Maker (https://aigifmaker.ai)
+
+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,70 @@
+# aigifmaker
+
+Turn text into animated GIFs with AI GIF Maker. Native GIF generation — no video conversion. Type what you want and download your GIF in about a minute.
+
+This is the official Ruby client for [AI GIF Maker](https://aigifmaker.ai/?utm_source=rubygems&utm_medium=package). One call sends your prompt, waits for the GIF and returns its URL.
+
+```bash
+gem install aigifmaker
+```
+
+```ruby
+require "aigifmaker"
+
+url = Aigifmaker.generate("a corgi in sunglasses dancing on a beach, looping")
+puts url # the finished GIF
+```
+
+Standard library only (`net/http`, `json`), no dependencies. Ruby 2.6+.
+
+## API key
+
+Create a key at https://aigifmaker.ai/settings/apikeys, then pass it as `api_key:` or export it:
+
+```bash
+export AIGIFMAKER_API_KEY=sk-...
+```
+
+Each GIF costs 1 credit on your AI GIF Maker account, the same as on the website. New accounts get one free GIF (it carries a small aigifmaker.ai badge). A GIF that fails to generate gives its credit back. Credit packs are on the [pricing](https://aigifmaker.ai/pricing?utm_source=rubygems&utm_medium=package) page.
+
+```ruby
+puts Aigifmaker.credits # remaining credits, free to call
+```
+
+## Client
+
+```ruby
+gif = Aigifmaker::Client.new("sk-...", timeout: 300) # timeout in seconds, 5 minutes by default
+url = gif.generate("a tiny dragon sneezing a puff of glitter")
+```
+
+## Submit now, collect later
+
+```ruby
+task_id = gif.submit("happy birthday text bouncing in rainbow letters")
+puts gif.status(task_id)["status"] # pending | processing | success | failed
+url = gif.wait(task_id)            # polls every 3 seconds
+```
+
+A run from an account that has not bought credits yet may wait in a short queue first (`"queued" => true` while `status` stays `processing`). That is normal; `generate` and `wait` keep polling.
+
+## Errors worth catching
+
+Each failure is its own subclass of `Aigifmaker::Error`:
+
+- `Aigifmaker::AuthError`: no key, or the key is wrong or deleted
+- `Aigifmaker::QuotaError`: the account is out of credits
+- `Aigifmaker::RejectedError`: the content filter refused the prompt, or a cooldown is active; reword it
+- `Aigifmaker::GenerationFailed`: the run was accepted but failed; the message says why
+- `Aigifmaker::TimeoutError`: still running when the timeout passed; the GIF may finish later in your history
+
+Any other refusal raises `Aigifmaker::Error` with the server's message.
+
+## Tests
+
+```bash
+ruby test/test_aigifmaker.rb # mocked, offline
+ruby test/smoke_live.rb      # two free live checks, no generation
+```
+
+MIT licensed. Questions: support@aigifmaker.ai

data/lib/aigifmaker/version.rb

@@ -0,0 +1,3 @@
+module Aigifmaker
+  VERSION = "0.1.0"
+end

data/lib/aigifmaker.rb

@@ -0,0 +1,179 @@
+# Official Ruby SDK for AI GIF Maker (https://aigifmaker.ai): turn text into
+# animated GIFs.
+#
+#   require "aigifmaker"
+#   url = Aigifmaker.generate("a corgi in sunglasses dancing on a beach")
+#
+# Create a key at https://aigifmaker.ai/settings/apikeys and pass it as
+# api_key: or set AIGIFMAKER_API_KEY. Each GIF costs 1 credit on your
+# AI GIF Maker account, the same as on the website.
+require "json"
+require "net/http"
+require "uri"
+require_relative "aigifmaker/version"
+
+module Aigifmaker
+  BASE_URL = "https://aigifmaker.ai".freeze
+  KEYS_URL = "https://aigifmaker.ai/settings/apikeys".freeze
+  PRICING_URL = "https://aigifmaker.ai/pricing".freeze
+  DEFAULT_TIMEOUT = 300
+  POLL_EVERY = 3
+
+  # Base of every error this gem raises. #code is the JSON code when there was one.
+  class Error < StandardError
+    attr_reader :code
+    def initialize(msg = nil, code: nil)
+      super(msg)
+      @code = code
+    end
+  end
+  # No API key, or the key is invalid or deleted.
+  class AuthError < Error; end
+  # The account is out of credits.
+  class QuotaError < Error; end
+  # The content filter refused the prompt, or a cooldown is active. Reword it.
+  class RejectedError < Error; end
+  # The GIF was accepted but the run ended as failed or canceled.
+  class GenerationFailed < Error; end
+  # The deadline passed; the GIF may still finish in your AI GIF Maker history.
+  class TimeoutError < Error; end
+
+  # Return data for code 0; otherwise raise the error that says what to do next.
+  # Every response is HTTP 200; the JSON code tells success from refusal.
+  def self.unwrap(http_status, env)
+    env = {} unless env.is_a?(Hash)
+    code = env["code"]
+    data = env["data"].is_a?(Hash) ? env["data"] : {}
+    if code == 0
+      raise AuthError.new("an API key is required; create one at #{KEYS_URL} and set AIGIFMAKER_API_KEY", code: code) if data["wall"]
+
+      return data
+    end
+    msg = (env["message"] || env["error"] || "HTTP #{http_status}").to_s
+    low = msg.downcase
+    c = code.is_a?(Integer) ? code : nil
+    raise AuthError.new(msg, code: c) if low.include?("invalid api key") || low.include?("no auth") || http_status == 401
+    raise QuotaError.new("#{msg}. Top up at #{PRICING_URL}", code: c) if low.include?("insufficient credits")
+    raise RejectedError.new(msg, code: c) if c && c != -1
+
+    raise Error.new(msg, code: c)
+  end
+
+  # A client bound to one API key. transport: is a callable (url, body, headers) -> [status, hash], for tests.
+  class Client
+    attr_accessor :poll_every, :timeout
+
+    def initialize(api_key = nil, base_url: BASE_URL, timeout: DEFAULT_TIMEOUT, poll_every: POLL_EVERY, transport: nil)
+      key = (api_key || ENV["AIGIFMAKER_API_KEY"]).to_s.strip
+      @key = key.empty? ? nil : key
+      @base = base_url.chomp("/")
+      @timeout = timeout
+      @poll_every = poll_every
+      @transport = transport || method(:http)
+    end
+
+    # Start one GIF and return its task id without waiting.
+    def submit(prompt)
+      raise ArgumentError, "prompt is required" if prompt.to_s.strip.empty?
+
+      data = post("/api/ai/generate", {
+        "provider" => "openlux",
+        "mediaType" => "image",
+        "model" => "gif-maker-v1",
+        "scene" => "text-to-image",
+        "prompt" => prompt,
+        "options" => { "output_format" => "gif" }
+      })
+      raise Error, "the service returned no task id" unless data["id"]
+
+      data["id"].to_s
+    end
+
+    # Return the task record: "status" is pending, processing, success or failed;
+    # "images"[0] holds the GIF URL when it succeeds.
+    def status(task_id)
+      post("/api/ai/query", { "taskId" => task_id })
+    end
+
+    # Poll a task every 3 seconds until it finishes and return the GIF URL.
+    def wait(task_id, timeout: nil)
+      limit = timeout || @timeout
+      deadline = Process.clock_gettime(Process::CLOCK_MONOTONIC) + limit
+      loop do
+        d = begin
+          status(task_id)
+        rescue SystemCallError, SocketError, Net::OpenTimeout, Net::ReadTimeout
+          {} # a dropped poll is not a failed generation
+        end
+        state = d["status"].to_s.downcase
+        images = d["images"] || []
+        return images[0].to_s if state == "success" && !images.empty?
+
+        if %w[failed canceled].include?(state)
+          msg = (d["errorMessage"] || "the GIF #{state}").to_s
+          raise RejectedError, msg if d["failureKind"] == "moderation"
+
+          raise GenerationFailed, msg
+        end
+        if Process.clock_gettime(Process::CLOCK_MONOTONIC) >= deadline
+          raise TimeoutError, "still running after #{limit}s; task #{task_id} may finish later in your AI GIF Maker history"
+        end
+
+        sleep @poll_every
+      end
+    end
+
+    # Generate one animated GIF and return its URL.
+    def generate(prompt)
+      wait(submit(prompt))
+    end
+
+    # Remaining credits on the account. Free to call.
+    def credits
+      post("/api/user/get-user-credits", nil)["remainingCredits"].to_i
+    end
+
+    private
+
+    def post(path, body)
+      headers = { "Content-Type" => "application/json", "User-Agent" => "aigifmaker-ruby/#{VERSION}" }
+      headers["Authorization"] = "Bearer #{@key}" if @key
+      st, env = @transport.call("#{@base}#{path}", body, headers)
+      Aigifmaker.unwrap(st, env)
+    end
+
+    def http(url, body, headers)
+      uri = URI(url)
+      req = Net::HTTP::Post.new(uri)
+      headers.each { |k, v| req[k] = v }
+      req.body = JSON.generate(body || {})
+      res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https", read_timeout: 60) { |h| h.request(req) }
+      parsed = begin
+        JSON.parse(res.body.to_s.empty? ? "{}" : res.body)
+      rescue JSON::ParserError
+        { "code" => -1, "message" => res.body.to_s[0, 200] }
+      end
+      [res.code.to_i, parsed.is_a?(Hash) ? parsed : { "code" => -1, "message" => parsed.to_s }]
+    end
+  end
+
+  # Generate one animated GIF and return its URL.
+  def self.generate(prompt, api_key: nil, **opts)
+    Client.new(api_key, **opts).generate(prompt)
+  end
+
+  # Start one GIF and return its task id.
+  def self.submit(prompt, api_key: nil, **opts)
+    Client.new(api_key, **opts).submit(prompt)
+  end
+
+  # Return the task record for task_id.
+  def self.status(task_id, api_key: nil, **opts)
+    Client.new(api_key, **opts).status(task_id)
+  end
+
+  # Remaining credits on the account.
+  def self.credits(api_key: nil, **opts)
+    Client.new(api_key, **opts).credits
+  end
+end

metadata

@@ -0,0 +1,52 @@
+--- !ruby/object:Gem::Specification
+name: aigifmaker
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- hanshs474
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-11-09 00:00:00.000000000 Z
+dependencies: []
+description: Turn text into animated GIFs with AI GIF Maker. Native GIF generation
+  — no video conversion. Type what you want and download your GIF in about a minute.
+email:
+- support@aigifmaker.ai
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/aigifmaker.rb
+- lib/aigifmaker/version.rb
+homepage: https://aigifmaker.ai/?utm_source=rubygems&utm_medium=package
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://aigifmaker.ai/?utm_source=rubygems&utm_medium=package
+  source_code_uri: https://github.com/hanshs474/aigifmaker-rb
+  bug_tracker_uri: https://github.com/hanshs474/aigifmaker-rb/issues
+  rubygems_mfa_required: 'false'
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.6'
+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: 'Official SDK for AI GIF Maker (aigifmaker.ai): turn text into animated GIFs.'
+test_files: []