saymaker 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1df4020cb61123a658e27f233b48a30194df8449e12312d64b074e7d315689eb
+  data.tar.gz: 649cf523e9c79b8714ecfb302afc1857e980367b4f9c4031560acfee46d41dcd
+SHA512:
+  metadata.gz: '097d1f55cad0f58a78b23754e8dfd3a05842cc02c0dd1a9c1fe276d4c9532ac016f0d143e7018d94763b72c2fe7909176a58237e70f4b45f13daec50fc7812f9'
+  data.tar.gz: b52db8346f12638f3d56647b817e282a1f465f2b2eeaa43167718a94d21330236aae353d81823ca04297b86c8b2c52d1c0ca2e4abe8ee8775a352b6fea41dedb

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SayMaker (https://saymaker.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,78 @@
+# saymaker
+
+Generate images and video on [SayMaker](https://saymaker.ai/?utm_source=rubygems&utm_medium=package) from your own code: one API key runs Veo 3.1, Kling 3.0, Seedance 2.0, MiniMax H3, Nano Banana 2, GPT Image 2.5, Seedream 5.0 and the rest of the shelf on your own credits.
+
+```ruby
+require "saymaker"
+
+url  = SayMaker.generate("a paper-cut layered mountain range at dusk")
+clip = SayMaker.generate_video("a paper boat drifting down a rain gutter, low angle")
+```
+
+Each call waits for the run and returns the URL of the finished file. Runs on a free account wait in a queue before they start, and the wait grows with each run of the day; a paid plan starts at once. The default timeouts cover the longest wait.
+
+## Install
+
+```bash
+gem install saymaker
+```
+
+Standard library only (`net/http` and `json`). Set `SAYMAKER_API_KEY` or pass `api_key:`.
+
+## API key
+
+Sign up on [saymaker.ai](https://saymaker.ai/?utm_source=rubygems&utm_medium=package) (new accounts get sign-up credits), create a key at [saymaker.ai/settings/apikeys](https://saymaker.ai/settings/apikeys?utm_source=rubygems&utm_medium=package), then pass it or export it:
+
+```bash
+export SAYMAKER_API_KEY=sk-...
+```
+
+A key runs on your account exactly like the site does: same models, same credit prices, same plan, and every run lands in your library at [saymaker.ai/history](https://saymaker.ai/history?utm_source=rubygems&utm_medium=package).
+
+## Images
+
+```ruby
+SayMaker.generate("isometric diorama of a ramen shop at night", aspect_ratio: "16:9")
+SayMaker.generate("product shot of a glass perfume bottle on wet slate", model: "gpt-image-2-5-flare")
+```
+
+The default model is `saymaker-image-v1`, the cheapest text-to-image run. Pass a model id for `nano-banana-2`, `gpt-image-2-5-flare`, `seedream-5-pro`, `qwen-image-3-pro` and the rest; see the [image models](https://saymaker.ai/image?utm_source=rubygems&utm_medium=package).
+
+### Editing a photo
+
+Pass an image URL and the prompt describes the change rather than the picture:
+
+```ruby
+SayMaker.generate(
+  "change the jacket to dark green, keep the face, pose and background exactly as they are",
+  image_url: "https://example.com/portrait.jpg"
+)
+```
+
+Naming what must stay is what decides whether the edit holds. Prompts that only name the change tend to drift the whole picture.
+
+## Video
+
+```ruby
+SayMaker.generate_video("a fox trotting through fresh snow at dawn, tracking shot", duration: 6)
+SayMaker.generate_video("the camera slowly orbits the statue", image_url: "https://example.com/statue.jpg")
+SayMaker.generate_video("a street drummer in the rain", model: "veo-3-1", resolution: "1080p")
+```
+
+The default model is `minimax-h3-fast`, the one a free account can run (480p or 768p, 4 to 15 seconds). Veo 3.1, Kling 3.0, Seedance 2.0 and the other video models need a plan or a credit pack; see [pricing](https://saymaker.ai/pricing?utm_source=rubygems&utm_medium=package). Each model's options are on its page: [Veo 3.1](https://saymaker.ai/video/veo-3-1?utm_source=rubygems&utm_medium=package), [Kling 3.0](https://saymaker.ai/video/kling-3-0?utm_source=rubygems&utm_medium=package), [Seedance 2.0](https://saymaker.ai/video/seedance-2?utm_source=rubygems&utm_medium=package).
+
+## Errors worth catching
+
+- `SayMaker::AuthError` — no key, or the key is wrong or deleted
+- `SayMaker::QuotaError` — the account is out of credits
+- `SayMaker::PlanError` — that model needs a paid plan or a credit pack
+- `SayMaker::BusyError` — another run on this account is still rendering; free accounts run one at a time
+- `SayMaker::RejectedError` — the content filter or the model refused the prompt; rewrite it rather than retrying
+
+All inherit from `SayMaker::Error`.
+
+The API answers refusals with HTTP 200 and an error code in the body, so a client that only checks the status code reports a refusal as success. This one reads the body.
+
+Free-account output carries a watermark; a paid plan returns the clean file.
+
+MIT licensed. Made by [SayMaker](https://saymaker.ai/?utm_source=rubygems&utm_medium=package), the AI video generator agent.

data/lib/saymaker/version.rb

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

data/lib/saymaker.rb

@@ -0,0 +1,137 @@
+# Generate images and video from Ruby on SayMaker (https://saymaker.ai).
+#
+#   require "saymaker"
+#   url  = SayMaker.generate("a paper-cut layered mountain range at dusk")
+#   clip = SayMaker.generate_video("a fox trotting through snow", duration: 6)
+#
+# One API key runs the whole shelf on your own credits: Veo 3.1, Kling 3.0,
+# Seedance 2.0, MiniMax H3, Nano Banana 2, GPT Image 2.5, Seedream 5.0 and more.
+# Create a key at https://saymaker.ai/settings/apikeys and set SAYMAKER_API_KEY
+# or pass api_key:. Standard library only.
+require "json"
+require "net/http"
+require "uri"
+require_relative "saymaker/version"
+
+module SayMaker
+  BASE = "https://saymaker.ai"
+  KEYS_URL = "#{BASE}/settings/apikeys"
+  MODEL_IMAGE = "saymaker-image-v1"
+  MODEL_EDIT = "nano-banana-2-lite"
+  # The video model a free account can run (480p or 768p, 4 to 15 seconds).
+  MODEL_VIDEO = "minimax-h3-fast"
+
+  # Model id => the routing field the API expects next to it. Unlisted ids go as "kie".
+  MODELS = {
+    "saymaker-image-v1" => "kie", "nano-banana-2-lite" => "kie", "nano-banana-2" => "poyo",
+    "nano-banana-pro" => "poyo", "gpt-image-2" => "poyo", "gpt-image-2-5-flare" => "kie",
+    "seedream-5-lite" => "poyo", "seedream-5-pro" => "kie", "qwen-image-3-pro" => "kie",
+    "grok-imagine-image-2-0" => "poyo", "minimax-h3-fast" => "vgenv", "minimax-h3" => "poyo",
+    "seedance-2" => "kie", "seedance-2-fast" => "kie", "seedance-2-5" => "kie", "veo-3-1" => "kie",
+    "kling-3-0" => "kie", "kling-3-0-turbo" => "kie", "wan-3-0" => "kie", "ltx-2-5-fast" => "replicate"
+  }.freeze
+
+  class Error < StandardError; 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 model needs a paid plan or a credit pack.
+  class PlanError < Error; end
+  # Another run on this account is still rendering. Free accounts run one at a time.
+  class BusyError < Error; end
+  # The content filter or the model refused the prompt. Reword it.
+  class RejectedError < Error; end
+
+  module_function
+
+  # Generate one image, or edit +image_url+, and return its URL.
+  def generate(prompt, image_url: nil, model: nil, aspect_ratio: nil, api_key: nil,
+               timeout: 4500, poll_every: 5, base_url: BASE, transport: nil)
+    check_url(image_url)
+    options = { "size" => aspect_ratio || (image_url ? "auto" : "1:1"), "resolution" => "1K", "n" => 1 }
+    options["image_input"] = [image_url] if image_url
+    run("image", image_url ? "image-to-image" : "text-to-image",
+        model || (image_url ? MODEL_EDIT : MODEL_IMAGE), prompt, options,
+        api_key, timeout, poll_every, base_url, transport)
+  end
+
+  # Generate one clip, or animate +image_url+ as the first frame, and return its URL.
+  def generate_video(prompt, image_url: nil, model: MODEL_VIDEO, duration: nil, resolution: nil,
+                     aspect_ratio: "16:9", sound: true, api_key: nil, timeout: 5400,
+                     poll_every: 10, base_url: BASE, transport: nil)
+    check_url(image_url)
+    options = { "aspect_ratio" => aspect_ratio, "sound" => sound }
+    options["image_input"] = [image_url] if image_url
+    options["duration"] = duration if duration
+    options["resolution"] = resolution if resolution
+    run("video", image_url ? "image-to-video" : "text-to-video", model, prompt, options,
+        api_key, timeout, poll_every, base_url, transport)
+  end
+
+  def check_url(url)
+    return if url.nil? || url.start_with?("http://", "https://")
+
+    raise ArgumentError, "image_url must be a public http(s) url"
+  end
+
+  def http(url, body, key)
+    uri = URI(url)
+    req = Net::HTTP::Post.new(uri)
+    req["Content-Type"] = "application/json"
+    req["Authorization"] = "Bearer #{key}"
+    req["User-Agent"] = "saymaker-ruby/#{VERSION}"
+    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) }
+    JSON.parse(res.body.to_s.empty? ? "{}" : res.body)
+  end
+
+  # Refusals answer HTTP 200 with code -1; the status code alone reads as success.
+  def classify(env)
+    msg = (env["message"] || "request refused").to_s
+    low = msg.downcase
+    return BusyError.new(msg) if (env["data"].is_a?(Hash) && env["data"]["busy"]) || low.include?("is rendering") || low.include?("at once")
+    return AuthError.new(msg) if low.include?("api key") || low.include?("no auth")
+    return QuotaError.new(msg) if low.include?("insufficient credits")
+    return PlanError.new(msg) if low.include?("subscription") || low.include?("plan") || low.include?("sign in")
+
+    Error.new(msg)
+  end
+
+  def run(media, scene, model, prompt, options, api_key, timeout, poll_every, base_url, transport)
+    raise ArgumentError, "prompt is required" if prompt.to_s.strip.empty?
+
+    key = api_key || ENV["SAYMAKER_API_KEY"]
+    raise AuthError, "pass api_key: or set SAYMAKER_API_KEY; create a key at #{KEYS_URL}" if key.nil? || key.empty?
+
+    send = transport || method(:http)
+    env = send.call("#{base_url}/api/ai/generate", {
+      "provider" => MODELS.fetch(model, "kie"), "mediaType" => media, "model" => model,
+      "scene" => scene, "prompt" => prompt, "options" => options
+    }, key)
+    raise classify(env) unless env["code"] == 0
+
+    data = env["data"] || {}
+    # A signed-out request is also a 200 with code 0 — only `wall` tells it apart.
+    raise AuthError, "SayMaker needs an API key; create one at #{KEYS_URL}" if data["wall"]
+
+    task = data["id"] or raise Error, "the service returned no task id"
+    # Free-account runs only reach the model on the poll that crosses the end of
+    # the queue wait, so polling is what starts the work.
+    deadline = Time.now + timeout
+    while Time.now < deadline
+      sleep poll_every
+      begin
+        q = send.call("#{base_url}/api/ai/query", { "taskId" => task }, key)
+      rescue StandardError
+        next # a dropped poll is not a failed generation
+      end
+      next unless q["code"] == 0
+
+      d = q["data"] || {}
+      %w[cleanImages images videos].each { |f| return d[f][0] if d[f].is_a?(Array) && !d[f].empty? }
+      raise RejectedError, "the run failed; reword the prompt rather than retrying" if %w[failed error].include?(d["status"].to_s.downcase)
+    end
+    raise Error, "deadline passed after #{timeout}s; the run may still finish in your SayMaker history"
+  end
+end

metadata

@@ -0,0 +1,54 @@
+--- !ruby/object:Gem::Specification
+name: saymaker
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- SayMaker
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-10-05 00:00:00.000000000 Z
+dependencies: []
+description: 'A zero-dependency client for saymaker.ai: text-to-image, photo edits
+  and text- or image-to-video across Veo 3.1, Kling 3.0, Seedance 2.0, MiniMax H3,
+  Nano Banana 2, GPT Image 2.5 and Seedream 5.0, on one API key.'
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/saymaker.rb
+- lib/saymaker/version.rb
+homepage: https://saymaker.ai/?utm_source=rubygems&utm_medium=package
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://saymaker.ai/?utm_source=rubygems&utm_medium=package
+  source_code_uri: https://github.com/hanshs474/saymaker-rb
+  documentation_uri: https://saymaker.ai/video?utm_source=rubygems&utm_medium=package
+  bug_tracker_uri: https://github.com/hanshs474/saymaker-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: 'Generate images and video from Ruby on SayMaker: Veo 3.1, Kling 3.0, Seedance
+  2.0, Nano Banana 2 with one API key'
+test_files: []