saymaker 0.1.0__tar.gz

saymaker-0.1.0/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/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,69 @@
+# 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/pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "saymaker"
+version = "0.1.0"
+description = "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"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [{ name = "SayMaker" }]
+keywords = ["ai", "image-generation", "video-generation", "text-to-video", "text-to-image", "veo", "kling", "seedance"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Topic :: Multimedia :: Graphics",
+  "Topic :: Multimedia :: Video",
+]
+
+[project.urls]
+Homepage = "https://saymaker.ai/?utm_source=pypi&utm_medium=package"
+"Video models" = "https://saymaker.ai/video?utm_source=pypi&utm_medium=package"
+"API keys" = "https://saymaker.ai/settings/apikeys?utm_source=pypi&utm_medium=package"
+Source = "https://github.com/hanshs474/saymaker-py"
+
+[tool.setuptools.packages.find]
+where = ["src"]

saymaker-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

saymaker-0.1.0/src/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/src/saymaker.egg-info/PKG-INFO

@@ -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/src/saymaker.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+pyproject.toml
+src/saymaker/__init__.py
+src/saymaker.egg-info/PKG-INFO
+src/saymaker.egg-info/SOURCES.txt
+src/saymaker.egg-info/dependency_links.txt
+src/saymaker.egg-info/top_level.txt
+tests/test_saymaker.py

saymaker-0.1.0/src/saymaker.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

saymaker-0.1.0/src/saymaker.egg-info/top_level.txt

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

saymaker-0.1.0/tests/test_saymaker.py

@@ -0,0 +1,76 @@
+import os
+import unittest
+
+import saymaker
+
+
+def fake(calls, final):
+    def t(method, url, body, headers):
+        calls.append((method, url, body, headers))
+        if url.endswith("/api/ai/generate"):
+            return {"code": 0, "data": {"id": "row1"}}
+        return {"code": 0, "data": final}
+
+    return t
+
+
+class SayMakerTests(unittest.TestCase):
+    def setUp(self):
+        os.environ.pop("SAYMAKER_API_KEY", None)
+
+    def test_validates(self):
+        with self.assertRaises(ValueError):
+            saymaker.generate("  ", api_key="sk-x")
+        with self.assertRaises(ValueError):
+            saymaker.generate("x", image_url="file:///x.png", api_key="sk-x")
+
+    def test_needs_a_key(self):
+        with self.assertRaises(saymaker.AuthError):
+            saymaker.generate("x")
+
+    def test_wall_is_a_200(self):
+        with self.assertRaises(saymaker.AuthError):
+            saymaker._parse_submit({"code": 0, "data": {"wall": True, "reason": "sign_in_required"}})
+
+    def test_refusals(self):
+        with self.assertRaises(saymaker.AuthError):
+            saymaker._parse_submit({"code": -1, "message": "invalid API key"})
+        with self.assertRaises(saymaker.QuotaError):
+            saymaker._parse_submit({"code": -1, "message": "insufficient credits"})
+
+    def test_image_prefers_clean_and_polls_query(self):
+        calls = []
+        final = {"status": "success", "images": ["https://cdn/m.webp"], "cleanImages": ["https://cdn/c.webp"]}
+        url = saymaker.generate("x", api_key="sk-abc", poll_every=0, base_url="https://t", transport=fake(calls, final))
+        self.assertEqual(url, "https://cdn/c.webp")
+        self.assertEqual(calls[0][3], {"Authorization": "Bearer sk-abc"})
+        self.assertEqual(calls[0][2]["model"], "saymaker-image-v1")
+        self.assertEqual(calls[0][2]["provider"], "kie")
+        self.assertEqual(calls[1][:3], ("POST", "https://t/api/ai/query", {"taskId": "row1"}))
+
+    def test_edit_sends_image_input(self):
+        calls = []
+        final = {"status": "success", "images": ["https://cdn/x.webp"]}
+        saymaker.generate("short hair", image_url="https://x/p.jpg", api_key="sk", poll_every=0, base_url="https://t", transport=fake(calls, final))
+        body = calls[0][2]
+        self.assertEqual(body["scene"], "image-to-image")
+        self.assertEqual(body["model"], "nano-banana-2-lite")
+        self.assertEqual(body["options"]["image_input"], ["https://x/p.jpg"])
+        self.assertEqual(body["options"]["size"], "auto")
+
+    def test_video_routes_by_model(self):
+        calls = []
+        final = {"status": "success", "videos": ["https://cdn/v.mp4"]}
+        url = saymaker.generate_video("a boat", api_key="sk", duration=6, poll_every=0, base_url="https://t", transport=fake(calls, final))
+        self.assertEqual(url, "https://cdn/v.mp4")
+        body = calls[0][2]
+        self.assertEqual((body["mediaType"], body["scene"], body["model"], body["provider"]), ("video", "text-to-video", "minimax-h3-fast", "vgenv"))
+        self.assertEqual(body["options"]["duration"], 6)
+
+    def test_failed_run(self):
+        with self.assertRaises(saymaker.RejectedError):
+            saymaker.generate("x", api_key="sk", poll_every=0, transport=fake([], {"status": "failed"}))
+
+
+if __name__ == "__main__":
+    unittest.main()