saymaker 0.1.0__py3-none-any.whl

saymaker/__init__.py

@@ -0,0 +1,271 @@
+"""Generate images and video on SayMaker (https://saymaker.ai) from Python.
+
+    from saymaker import generate, generate_video
+    url = generate("a paper-cut layered mountain range at dusk")
+    clip = generate_video("a paper boat drifting down a rain gutter, low angle")
+
+One API key runs the whole SayMaker shelf: Nano Banana 2, GPT Image 2.5,
+Seedream 5.0, Veo 3.1, Kling 3.0, Seedance 2.0, MiniMax H3 and more, on your
+own credits. Create a key at https://saymaker.ai/settings/apikeys and pass it
+as ``api_key=`` or set ``SAYMAKER_API_KEY``.
+
+Standard library only.
+"""
+
+from __future__ import annotations
+
+import json
+import os
+import time
+import urllib.error
+import urllib.request
+from typing import Callable, Optional
+
+__version__ = "0.1.0"
+__all__ = [
+    "generate",
+    "generate_video",
+    "SayMakerError",
+    "AuthError",
+    "QuotaError",
+    "PlanError",
+    "RejectedError",
+    "MODELS",
+    "BASE",
+]
+
+BASE = "https://saymaker.ai"
+KEYS_URL = BASE + "/settings/apikeys"
+
+#: Model id -> the routing field the API expects next to it. Ids not listed
+#: here are sent with "kie"; the full list with inputs is on saymaker.ai/models.
+MODELS = {
+    # image
+    "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",
+    # video
+    "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",
+}
+
+#: The cheapest text-to-image model; the edit default takes an input image.
+DEFAULT_IMAGE_MODEL = "saymaker-image-v1"
+DEFAULT_EDIT_MODEL = "nano-banana-2-lite"
+#: The video model a free account can run (480p or 768p, 4 to 15 seconds).
+DEFAULT_VIDEO_MODEL = "minimax-h3-fast"
+
+
+class SayMakerError(RuntimeError):
+    """Base class. Catch a subclass to decide what to do next."""
+
+
+class AuthError(SayMakerError):
+    """No API key, or the key is invalid or deleted."""
+
+
+class QuotaError(SayMakerError):
+    """The account is out of credits."""
+
+
+class PlanError(SayMakerError):
+    """This model needs a paid plan or a credit pack."""
+
+
+class RejectedError(SayMakerError):
+    """The content filter or the model refused the prompt. Reword it."""
+
+
+Transport = Callable[[str, str, Optional[dict], dict], dict]
+
+
+def _http(method: str, url: str, body: Optional[dict], headers: dict) -> dict:
+    headers = {**headers, "User-Agent": f"saymaker-python/{__version__}"}
+    data = None
+    if body is not None:
+        data = json.dumps(body).encode()
+        headers["Content-Type"] = "application/json"
+    req = urllib.request.Request(url, data=data, headers=headers, method=method)
+    try:
+        with urllib.request.urlopen(req, timeout=60) as r:
+            return json.loads(r.read())
+    except urllib.error.HTTPError as e:
+        return json.loads(e.read() or b"{}")
+
+
+def _parse_submit(env: dict) -> str:
+    # Refusals arrive as HTTP 200 with code -1; the status code alone reads as success.
+    if env.get("code") != 0:
+        msg = str(env.get("message") or "request refused")
+        low = msg.lower()
+        if "api key" in low or "no auth" in low:
+            raise AuthError(f"{msg} — create a key at {KEYS_URL}")
+        if "insufficient credits" in low:
+            raise QuotaError(msg)
+        if "subscription" in low or "plan" in low or "sign in" in low:
+            raise PlanError(msg)
+        raise SayMakerError(msg)
+    data = env.get("data") or {}
+    # A signed-out request is also a 200 with code 0 — only `wall` tells it apart.
+    if data.get("wall"):
+        raise AuthError(f"SayMaker needs an API key; create one at {KEYS_URL}")
+    task = data.get("id")
+    if not task:
+        raise SayMakerError("the service returned no task id")
+    return str(task)
+
+
+def _run(
+    media: str,
+    scene: str,
+    model: str,
+    prompt: str,
+    options: dict,
+    api_key: Optional[str],
+    timeout: float,
+    poll_every: float,
+    base_url: str,
+    transport: Optional[Transport],
+) -> str:
+    if not str(prompt or "").strip():
+        raise ValueError("prompt is required")
+    key = api_key or os.environ.get("SAYMAKER_API_KEY") or None
+    if not key:
+        raise AuthError(f"pass api_key= or set SAYMAKER_API_KEY; create a key at {KEYS_URL}")
+    http = transport or _http
+    headers = {"Authorization": f"Bearer {key}"}
+    task = _parse_submit(
+        http(
+            "POST",
+            base_url + "/api/ai/generate",
+            {
+                "provider": MODELS.get(model, "kie"),
+                "mediaType": media,
+                "model": model,
+                "scene": scene,
+                "prompt": prompt,
+                "options": options,
+            },
+            headers,
+        )
+    )
+
+    # Free-account runs wait in a queue and only reach the model on the poll
+    # that crosses the end of the wait, so polling is what starts the work.
+    deadline = time.monotonic() + timeout
+    while time.monotonic() < deadline:
+        time.sleep(poll_every)
+        try:
+            env = http("POST", base_url + "/api/ai/query", {"taskId": task}, headers)
+        except (OSError, ValueError):
+            continue  # a dropped poll is not a failed generation
+        if env.get("code") != 0:
+            continue
+        data = env.get("data") or {}
+        for field in ("cleanImages", "images", "videos"):
+            if data.get(field):
+                return data[field][0]
+        if str(data.get("status") or "").lower() in {"failed", "error"}:
+            raise RejectedError("the run failed; reword the prompt rather than retrying the same text")
+    raise SayMakerError(f"deadline passed after {timeout:g}s; the run may still finish in your SayMaker history")
+
+
+def _check_url(image_url: Optional[str]) -> None:
+    if image_url is not None and not image_url.startswith(("http://", "https://")):
+        raise ValueError("image_url must be a public http(s) url")
+
+
+def generate(
+    prompt: str,
+    *,
+    image_url: Optional[str] = None,
+    model: Optional[str] = None,
+    aspect_ratio: Optional[str] = None,
+    api_key: Optional[str] = None,
+    timeout: float = 360.0,
+    poll_every: float = 5.0,
+    base_url: str = BASE,
+    transport: Optional[Transport] = None,
+) -> str:
+    """Generate one image — or edit ``image_url`` — and return its URL.
+
+    For an edit the prompt describes the change and should name what must stay
+    ("keep the same face and lighting"). Raises a :class:`SayMakerError`
+    subclass on a refusal, an empty balance or a timeout.
+    """
+    _check_url(image_url)
+    chosen = model or (DEFAULT_EDIT_MODEL if image_url else DEFAULT_IMAGE_MODEL)
+    # `size` carries the aspect ratio — the site's own field name. An edit
+    # defaults to "auto", which keeps the source framing.
+    options: dict = {"size": aspect_ratio or ("auto" if image_url else "1:1"), "resolution": "1K", "n": 1}
+    if image_url:
+        options["image_input"] = [image_url]
+    return _run(
+        "image",
+        "image-to-image" if image_url else "text-to-image",
+        chosen,
+        prompt,
+        options,
+        api_key,
+        timeout,
+        poll_every,
+        base_url,
+        transport,
+    )
+
+
+def generate_video(
+    prompt: str,
+    *,
+    image_url: Optional[str] = None,
+    model: str = DEFAULT_VIDEO_MODEL,
+    duration: Optional[int] = None,
+    resolution: Optional[str] = None,
+    aspect_ratio: str = "16:9",
+    sound: bool = True,
+    api_key: Optional[str] = None,
+    timeout: float = 900.0,
+    poll_every: float = 10.0,
+    base_url: str = BASE,
+    transport: Optional[Transport] = None,
+) -> str:
+    """Generate one clip — or animate ``image_url`` as the first frame — and return its URL.
+
+    Video takes minutes. ``model`` defaults to MiniMax H3 Fast, the one a free
+    account can run; Veo 3.1, Kling 3.0 and Seedance 2.0 need a plan or a pack.
+    """
+    _check_url(image_url)
+    options: dict = {"aspect_ratio": aspect_ratio, "sound": sound}
+    if image_url:
+        options["image_input"] = [image_url]
+    if duration:
+        options["duration"] = duration
+    if resolution:
+        options["resolution"] = resolution
+    return _run(
+        "video",
+        "image-to-video" if image_url else "text-to-video",
+        model,
+        prompt,
+        options,
+        api_key,
+        timeout,
+        poll_every,
+        base_url,
+        transport,
+    )

saymaker-0.1.0.dist-info/METADATA

@@ -0,0 +1,91 @@
+Metadata-Version: 2.4
+Name: saymaker
+Version: 0.1.0
+Summary: Generate images and video from Python on SayMaker: Veo 3.1, Kling 3.0, Seedance 2.0, Nano Banana 2, GPT Image 2.5 and more with one API key
+Author: SayMaker
+License: MIT
+Project-URL: Homepage, https://saymaker.ai/?utm_source=pypi&utm_medium=package
+Project-URL: Video models, https://saymaker.ai/video?utm_source=pypi&utm_medium=package
+Project-URL: API keys, https://saymaker.ai/settings/apikeys?utm_source=pypi&utm_medium=package
+Project-URL: Source, https://github.com/hanshs474/saymaker-py
+Keywords: ai,image-generation,video-generation,text-to-video,text-to-image,veo,kling,seedance
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Multimedia :: Video
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# saymaker
+
+Generate images and video from Python on [SayMaker](https://saymaker.ai/?utm_source=pypi&utm_medium=package): 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.
+
+```python
+from saymaker import generate, generate_video
+
+url = generate("a paper-cut layered mountain range at dusk, warm rim light")
+clip = generate_video("a paper boat drifting down a rain gutter, low angle, slow push-in")
+```
+
+Standard library only, no dependencies. Each call returns the URL of the finished file.
+
+## API key
+
+Sign up on [saymaker.ai](https://saymaker.ai/?utm_source=pypi&utm_medium=package) (new accounts get sign-up credits), create a key at [saymaker.ai/settings/apikeys](https://saymaker.ai/settings/apikeys?utm_source=pypi&utm_medium=package), then either 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=pypi&utm_medium=package).
+
+## Images
+
+```python
+generate("isometric diorama of a ramen shop at night", aspect_ratio="16:9")
+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 `model=` for `nano-banana-2`, `gpt-image-2-5-flare`, `seedream-5-pro`, `qwen-image-3-pro` and the others listed in `saymaker.MODELS`.
+
+### Editing a photo
+
+Pass `image_url` and the prompt describes the change rather than the picture:
+
+```python
+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
+
+```python
+generate_video("a fox trotting through fresh snow at dawn, tracking shot", duration=6)
+generate_video("the camera slowly orbits the statue", image_url="https://example.com/statue.jpg")
+generate_video("a street drummer in the rain", model="veo-3-1", resolution="1080p")
+```
+
+Video takes minutes; `generate_video` waits up to 15 minutes by default (`timeout=`). 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=pypi&utm_medium=package). Each model's options are on its page, e.g. [Veo 3.1](https://saymaker.ai/video/veo-3-1?utm_source=pypi&utm_medium=package), [Kling 3.0](https://saymaker.ai/video/kling-3-0?utm_source=pypi&utm_medium=package), [Seedance 2.0](https://saymaker.ai/video/seedance-2?utm_source=pypi&utm_medium=package).
+
+## Errors worth catching
+
+Each failure is its own subclass of `SayMakerError`, so you can branch on what to do next:
+
+- `AuthError` — no key, or the key is wrong or deleted
+- `QuotaError` — the account is out of credits
+- `PlanError` — that model needs a paid plan or a credit pack
+- `RejectedError` — the content filter or the model refused the prompt; rewrite it rather than retrying
+
+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=pypi&utm_medium=package), the AI video generator agent.

saymaker-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+saymaker/__init__.py,sha256=B9eTxyMIPUjTUZQzsL7GoisrLxevQ8QesfgMSklg624,8680
+saymaker-0.1.0.dist-info/licenses/LICENSE,sha256=qDYZDkMKi8miQ7F9rMaDn5siXO3-f0mNsH3Ud33atMo,1087
+saymaker-0.1.0.dist-info/METADATA,sha256=e5tKJj6bSEB1UeOcRZXnXxXak7BLqSpjK-lQKH2U4Yk,4707
+saymaker-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+saymaker-0.1.0.dist-info/top_level.txt,sha256=8S3WlAf1eE9jHMWXlyojD2iYkd3sQ-AS6eaZTs1e734,9
+saymaker-0.1.0.dist-info/RECORD,,

saymaker-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

saymaker-0.1.0.dist-info/licenses/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.

saymaker-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+saymaker