porn-api 0.1.0__py3-none-any.whl

porn_api/__init__.py

@@ -0,0 +1,93 @@
+"""Spicy API (spicyapi.com) client: porn API for AI image, image-to-video and chat generation.
+
+Standard library only. Image generation and chat are OpenAI-compatible, so the OpenAI SDK with
+base_url="https://api.spicyapi.com/v1" also works; this client adds image edits by URL, video
+tasks with polling, the account balance and the model list with prices.
+"""
+
+import json
+import os
+import time
+import urllib.error
+import urllib.request
+
+__version__ = "0.1.0"
+__all__ = ["SpicyAPI", "SpicyAPIError"]
+
+
+class SpicyAPIError(Exception):
+    """status: 401 bad key, 402 balance, 400 params, 422 prompt blocked (never charged), 429 capacity."""
+
+    def __init__(self, message, status, type_="api_error", body=None):
+        super().__init__(message)
+        self.status, self.type, self.body = status, type_, body
+
+
+class SpicyAPI:
+    def __init__(self, api_key=None, base_url="https://api.spicyapi.com/v1", timeout=300, opener=None):
+        self.api_key = api_key or os.environ.get("SPICYAPI_KEY")
+        if not self.api_key:
+            raise ValueError("Spicy API key missing: pass api_key or set SPICYAPI_KEY (https://www.spicyapi.com/dashboard/api-keys)")
+        self.base_url, self.timeout = base_url.rstrip("/"), timeout
+        self._open = opener or urllib.request.urlopen
+
+    def request(self, method, path, body=None):
+        req = urllib.request.Request(
+            self.base_url + path,
+            data=None if body is None else json.dumps(body).encode(),
+            method=method,
+            headers={"Authorization": f"Bearer {self.api_key}", "Content-Type": "application/json", "User-Agent": f"porn-api-py/{__version__}"},
+        )
+        try:
+            with self._open(req, timeout=self.timeout) as res:
+                return json.loads(res.read() or b"{}")
+        except urllib.error.HTTPError as e:
+            raw = e.read()
+            try:
+                data = json.loads(raw)
+            except ValueError:
+                data = {"raw": raw.decode(errors="replace")}
+            err = data.get("error") if isinstance(data, dict) else None
+            err = err if isinstance(err, dict) else {}
+            raise SpicyAPIError(err.get("message") or f"HTTP {e.code}", e.code, err.get("type", "api_error"), data) from None
+
+    # Images
+    def generate_image(self, model, prompt, **params):
+        """Text to image. params: negative_prompt, size ("1024*1024"), n (1 to 4), seed. Returns {"data": [{"url"}], "cost_usd"}."""
+        return self.request("POST", "/images/generations", {"model": model, "prompt": prompt, **params})
+
+    def edit_image(self, model, prompt, image_urls, **params):
+        """Prompt-driven edit. image_urls must be images this account generated."""
+        return self.request("POST", "/images/edits", {"model": model, "prompt": prompt, "image_urls": list(image_urls), **params})
+
+    def list_images(self):
+        return self.request("GET", "/images")
+
+    # Video
+    def generate_video(self, model, prompt, **params):
+        """Starts a task. params: image_url, resolution ("720P"), duration (seconds), negative_prompt, audio, seed."""
+        return self.request("POST", "/videos/generations", {"model": model, "prompt": prompt, **params})
+
+    def get_video(self, task_id):
+        return self.request("GET", f"/videos/tasks/{task_id}")
+
+    def wait_for_video(self, task_id, interval=12, timeout=1200):
+        """Polls until the task succeeds (output.video_url) or fails (refunded)."""
+        deadline = time.monotonic() + timeout
+        while True:
+            task = self.get_video(task_id)
+            if task.get("status") in ("succeeded", "failed"):
+                return task
+            if time.monotonic() > deadline:
+                raise SpicyAPIError(f"Video task {task_id} still {task.get('status')} after {timeout}s", 408, "timeout", task)
+            time.sleep(interval)
+
+    # Chat (non-streaming; for streaming use the OpenAI SDK with this base_url), account, models
+    def chat(self, model, messages, **params):
+        return self.request("POST", "/chat/completions", {"model": model, "messages": messages, **params, "stream": False})
+
+    def account(self):
+        return self.request("GET", "/account")
+
+    def models(self):
+        return self.request("GET", "/models")

porn_api-0.1.0.dist-info/METADATA

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: porn-api
+Version: 0.1.0
+Summary: Porn API client for AI image, image-to-video and chat generation. Official Spicy API (spicyapi.com) client, OpenAI-compatible, pay per generation. 18+.
+Author-email: Spicy API <support@spicyapi.com>
+License: MIT
+Project-URL: Homepage, https://www.spicyapi.com/porn-ai-api
+Project-URL: Documentation, https://www.spicyapi.com/docs
+Project-URL: Pricing, https://www.spicyapi.com/pricing
+Project-URL: Source, https://github.com/Wayfinity/porn-api
+Keywords: porn api,nsfw api,adult api,ai porn,nsfw image generation,nsfw video generation,image to video,uncensored,openai compatible,spicyapi.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Multimedia :: Video
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# porn-api: Python client for AI porn image and video generation
+
+Official Python client for [Spicy API](https://www.spicyapi.com) at **spicyapi.com**, a porn API in the generation sense: it creates original adult images, image-to-video clips and uncensored chat from a prompt. It is not a tube-site data API. One key, pay per generation, no subscription. 18+ only.
+
+Standard library only, Python 3.8+. (Spicy API at spicyapi.com is a different company from the similarly named spicyapi.ai.)
+
+```bash
+pip install porn-api
+```
+
+```python
+from porn_api import SpicyAPI
+
+spicy = SpicyAPI()  # reads SPICYAPI_KEY
+
+# Text to image: durable CDN URLs plus the exact cost
+img = spicy.generate_image("spicy-image-1", "a woman on a beach at golden hour, photorealistic", size="1024*1024")
+print(img["data"][0]["url"], img["cost_usd"])
+
+# Image to video: start a task, then wait for it
+task = spicy.generate_video("spicy-motion-2", "slow turn toward camera", image_url=img["data"][0]["url"], resolution="720P", duration=5)
+done = spicy.wait_for_video(task["id"])
+print(done["status"], done.get("output", {}).get("video_url"))
+
+print(spicy.account())  # balance
+print(spicy.models())   # models with prices and limits
+```
+
+## Keys and the sandbox
+
+Sign up at [spicyapi.com/auth](https://www.spicyapi.com/auth) and copy the key from Dashboard, API Keys. Tick **Sandbox** when creating a key to get one that returns sample output and bills nothing.
+
+## Prices
+
+Images from $0.06, video from $0.10 per second, chat from $0.575 per 1M tokens. What you are charged is exactly `cost_usd` in each response. Failed generations are refunded; blocked prompts are never charged. Full table: [spicyapi.com/pricing](https://www.spicyapi.com/pricing).
+
+## Already using the OpenAI SDK?
+
+```python
+from openai import OpenAI
+client = OpenAI(base_url="https://api.spicyapi.com/v1", api_key="sk-spicy-...")
+```
+
+Image generation and chat are drop-in, streaming included. This package adds image edits by URL, video tasks with polling, the balance and the priced model list.
+
+## Errors
+
+`SpicyAPIError` carries `status` and `type`: 401 bad key, 402 insufficient balance, 400 invalid parameters, 422 prompt blocked by moderation, 429 model at capacity.
+
+## Rules
+
+Adults only, no real people without consent, no minors in any form, and no uploads: inputs to edits and video must be images your account generated. Read the [acceptable use policy](https://www.spicyapi.com/acceptable-use). Products built on the API must age-verify their users.
+
+[Docs](https://www.spicyapi.com/docs) · [MCP server for AI agents](https://www.spicyapi.com/docs/mcp) · [Examples](https://github.com/Wayfinity/porn-api) · [JavaScript client](https://www.npmjs.com/package/spicyapi)
+
+MIT licensed.

porn_api-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+porn_api/__init__.py,sha256=Pb8WVRBU_8HjcYf494uwWll3QN5HQSDiFbDrJb4ADGk,4272
+porn_api-0.1.0.dist-info/licenses/LICENSE,sha256=xDCduYb-y-WIjnmetac30QyWMvgS0f9Fn8_Jwq_XtUQ,1066
+porn_api-0.1.0.dist-info/METADATA,sha256=XOUIAUzrXJk8DlUED4xckQ2K8Kz2gCRjzR8LIoEc454,3737
+porn_api-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+porn_api-0.1.0.dist-info/top_level.txt,sha256=N4erlskDGb7OAybmMbiPsSFv0Xyvd6oIRy4UxvThbpo,9
+porn_api-0.1.0.dist-info/RECORD,,

porn_api-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
+

porn_api-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 Spicy API
+
+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.

porn_api-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+porn_api