lastshoot 0.1.0__tar.gz

lastshoot-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+node_modules/
+dist/
+*.tgz
+.venv/
+__pycache__/
+*.egg-info/
+.pytest_cache/
+.mypy_cache/
+coverage/
+.env

lastshoot-0.1.0/LICENSE

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

lastshoot-0.1.0/PKG-INFO

@@ -0,0 +1,193 @@
+Metadata-Version: 2.5
+Name: lastshoot
+Version: 0.1.0
+Summary: Official Python client for the LastShoot AI product-photography API
+Project-URL: Repository, https://github.com/lastshoot-com/lastshoot-sdks
+Project-URL: Issues, https://github.com/lastshoot-com/lastshoot-sdks/issues
+Project-URL: Homepage, https://www.lastshoot.com
+Project-URL: Documentation, https://www.lastshoot.com/docs/sdks/python
+Project-URL: API reference, https://api.lastshoot.com/docs
+Author: LastShoot
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,api,background removal,image generation,lastshoot,product photography,sdk,virtual try-on
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: httpx<1,>=0.24
+Provides-Extra: dev
+Requires-Dist: build; extra == 'dev'
+Requires-Dist: mypy>=1.8; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=7; extra == 'dev'
+Requires-Dist: respx>=0.21; extra == 'dev'
+Requires-Dist: twine; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# LastShoot Python SDK
+
+Official Python client for the [LastShoot](https://www.lastshoot.com) AI product-photography API:
+product-to-model, virtual try-on, background change and removal, edits, upscaling, branding,
+identity, video, speech and 3D.
+
+```bash
+pip install lastshoot
+```
+
+Requires Python 3.9+. One runtime dependency: `httpx`.
+
+## Quickstart
+
+Get an API key from the [dashboard](https://www.lastshoot.com/dashboard).
+
+```python
+from lastshoot import LastShoot
+
+ip = LastShoot("ip_live_xxxxxxxxxxxx")   # or LastShoot() with LASTSHOOT_API_KEY set
+
+# Generate
+result = ip.generate.image(prompt="fashion model, white studio background, editorial lighting")
+print(result.url)
+
+# Virtual try-on
+result = ip.identity.tryon(
+    person_image="https://cdn.example.com/model.jpg",
+    clothing_image="https://cdn.example.com/shirt.jpg",
+    gender="woman",
+    clothing_type="shirt",
+)
+print(result.url)
+```
+
+`result.url` is a temporary link (expires within 24 hours). Download and store the file.
+
+## Local files
+
+Every image parameter takes a public URL. Upload a local file first:
+
+```python
+uploaded = ip.upload.image("product.jpg")        # path, bytes, or a file opened with "rb"
+result = ip.background.change(
+    input_image=uploaded.url,
+    prompt="white marble table, soft daylight",
+    subject_description="glass perfume bottle",
+)
+```
+
+`ip.upload("product.jpg")` is shorthand for `ip.upload.image(...)`.
+
+## Jobs, progress and webhooks
+
+Every compute method submits a job and blocks until it finishes. Pass `wait=False` to get a
+`Job` back immediately, then wait when you are ready:
+
+```python
+job = ip.edit.image(input_image=url, prompt="make the dress emerald green", wait=False)
+print(job.job_id, job.status)          # e.g. "queued"
+
+result = job.wait(
+    poll_interval=2,                   # seconds between polls
+    timeout=600,                       # raise JobTimeoutError after this
+    on_progress=lambda s: print(s.status, s.progress),
+)
+print(result.url, result.mime_type, result.cost_usd)
+```
+
+Look up any job later with `ip.jobs.get("/edit/image/v1", job_id)` (returns a `JobStatus`) or
+`ip.jobs.wait("/edit/image/v1", job_id)`.
+
+Pass `callback_url=` to any compute method to have a `WebhookEvent` POSTed when the job
+finishes. `lastshoot.WebhookEvent` is a `TypedDict` of that payload.
+
+## Methods
+
+| Method | Endpoint |
+| --- | --- |
+| `ip.generate.image(prompt=...)` | `POST /generate/image/v1` |
+| `ip.generate.video(input_image=...)` | `POST /generate/video/v1` |
+| `ip.generate.speech(text=...)` | `POST /generate/speech/v1` |
+| `ip.generate.generate_3d(image_path=...)` | `POST /generate/3d/v1` |
+| `ip.edit.image(prompt=..., input_image=...)` | `POST /edit/image/v1` |
+| `ip.background.change(input_image=..., prompt=..., subject_description=...)` | `POST /background/change/image/v1` |
+| `ip.background.remove(input_image=...)` | `POST /background/remove/image/v1` |
+| `ip.upscale.image(input_image=...)` | `POST /upscale/image/v1` |
+| `ip.branding.logo(input_image=..., logo_url=...)` | `POST /branding/logo/image/v1` |
+| `ip.branding.template(input_image=...)` | `POST /branding/template/image/v1` |
+| `ip.identity.tryon(person_image=..., clothing_image=..., gender=..., clothing_type=...)` | `POST /creator/tryon/image/v1` |
+| `ip.identity.faceswap(target=..., source=...)` | `POST /identity/faceswap/image/v1` |
+| `ip.identity.lock(input_image=..., prompt=...)` | `POST /identity/lock/image/v1` |
+| `ip.identity.replace(input_image=..., prompt=...)` | `POST /identity/replace/image/v1` |
+| `ip.identity.instamodel(prompt=..., input_face=...)` | `POST /creator/instamodel/image/v1` |
+| `ip.identity.voice_clone(text=..., reference_voice_url=...)` | `POST /identity/voice/clone/v1` |
+| `ip.identity.create_profile / list_profiles / get_profile / update_profile / delete_profile` | `/profiles/v1` |
+| `ip.upload.image(file)` | `POST /upload/image/v1` |
+| `ip.jobs.get(endpoint, job_id)` / `ip.jobs.wait(endpoint, job_id)` | `GET <endpoint>/status/{job_id}` |
+
+All parameters are keyword arguments in snake_case, typed from the live
+[OpenAPI spec](https://api.lastshoot.com/docs). Options you leave out use the server default.
+Full parameter reference: [lastshoot.com/docs/sdks/python](https://www.lastshoot.com/docs/sdks/python).
+
+## Async
+
+```python
+import asyncio
+from lastshoot import AsyncLastShoot
+
+async def main():
+    async with AsyncLastShoot() as ip:
+        result = await ip.upscale.image(input_image="https://cdn.example.com/shoe.jpg", scale=2)
+        print(result.url)
+
+asyncio.run(main())
+```
+
+## Errors
+
+```python
+from lastshoot import (
+    LastShootError,            # base class
+    APIError,                  # any non-2xx response: .status_code .message .code .body
+    AuthenticationError,       # 401
+    InsufficientCreditsError,  # 402
+    PermissionDeniedError,     # 403
+    NotFoundError,             # 404
+    InvalidRequestError,       # 400 / 422
+    RateLimitError,            # 429 (.retry_after)
+    InternalServerError,       # 5xx
+    APIConnectionError, APITimeoutError,
+    JobFailedError,            # job ended failed/cancelled: .failure_reason_code .retryable .error
+    JobTimeoutError,           # wait() gave up; the job keeps running server-side
+)
+```
+
+Status polls (GET) retry automatically on 429, 5xx and network errors with exponential
+backoff (`max_retries=2` by default). Job submissions (POST) are never retried automatically,
+so a job is never billed twice.
+
+## Configuration
+
+```python
+LastShoot(
+    api_key=None,                      # default: LASTSHOOT_API_KEY env var
+    base_url="https://api.lastshoot.com",
+    timeout=60.0,                      # per HTTP request
+    max_retries=2,                     # GET retries
+    poll_interval=2.0,                 # default for wait()
+    wait_timeout=600.0,                # default for wait()
+)
+```
+
+## License
+
+MIT

lastshoot-0.1.0/README.md

@@ -0,0 +1,156 @@
+# LastShoot Python SDK
+
+Official Python client for the [LastShoot](https://www.lastshoot.com) AI product-photography API:
+product-to-model, virtual try-on, background change and removal, edits, upscaling, branding,
+identity, video, speech and 3D.
+
+```bash
+pip install lastshoot
+```
+
+Requires Python 3.9+. One runtime dependency: `httpx`.
+
+## Quickstart
+
+Get an API key from the [dashboard](https://www.lastshoot.com/dashboard).
+
+```python
+from lastshoot import LastShoot
+
+ip = LastShoot("ip_live_xxxxxxxxxxxx")   # or LastShoot() with LASTSHOOT_API_KEY set
+
+# Generate
+result = ip.generate.image(prompt="fashion model, white studio background, editorial lighting")
+print(result.url)
+
+# Virtual try-on
+result = ip.identity.tryon(
+    person_image="https://cdn.example.com/model.jpg",
+    clothing_image="https://cdn.example.com/shirt.jpg",
+    gender="woman",
+    clothing_type="shirt",
+)
+print(result.url)
+```
+
+`result.url` is a temporary link (expires within 24 hours). Download and store the file.
+
+## Local files
+
+Every image parameter takes a public URL. Upload a local file first:
+
+```python
+uploaded = ip.upload.image("product.jpg")        # path, bytes, or a file opened with "rb"
+result = ip.background.change(
+    input_image=uploaded.url,
+    prompt="white marble table, soft daylight",
+    subject_description="glass perfume bottle",
+)
+```
+
+`ip.upload("product.jpg")` is shorthand for `ip.upload.image(...)`.
+
+## Jobs, progress and webhooks
+
+Every compute method submits a job and blocks until it finishes. Pass `wait=False` to get a
+`Job` back immediately, then wait when you are ready:
+
+```python
+job = ip.edit.image(input_image=url, prompt="make the dress emerald green", wait=False)
+print(job.job_id, job.status)          # e.g. "queued"
+
+result = job.wait(
+    poll_interval=2,                   # seconds between polls
+    timeout=600,                       # raise JobTimeoutError after this
+    on_progress=lambda s: print(s.status, s.progress),
+)
+print(result.url, result.mime_type, result.cost_usd)
+```
+
+Look up any job later with `ip.jobs.get("/edit/image/v1", job_id)` (returns a `JobStatus`) or
+`ip.jobs.wait("/edit/image/v1", job_id)`.
+
+Pass `callback_url=` to any compute method to have a `WebhookEvent` POSTed when the job
+finishes. `lastshoot.WebhookEvent` is a `TypedDict` of that payload.
+
+## Methods
+
+| Method | Endpoint |
+| --- | --- |
+| `ip.generate.image(prompt=...)` | `POST /generate/image/v1` |
+| `ip.generate.video(input_image=...)` | `POST /generate/video/v1` |
+| `ip.generate.speech(text=...)` | `POST /generate/speech/v1` |
+| `ip.generate.generate_3d(image_path=...)` | `POST /generate/3d/v1` |
+| `ip.edit.image(prompt=..., input_image=...)` | `POST /edit/image/v1` |
+| `ip.background.change(input_image=..., prompt=..., subject_description=...)` | `POST /background/change/image/v1` |
+| `ip.background.remove(input_image=...)` | `POST /background/remove/image/v1` |
+| `ip.upscale.image(input_image=...)` | `POST /upscale/image/v1` |
+| `ip.branding.logo(input_image=..., logo_url=...)` | `POST /branding/logo/image/v1` |
+| `ip.branding.template(input_image=...)` | `POST /branding/template/image/v1` |
+| `ip.identity.tryon(person_image=..., clothing_image=..., gender=..., clothing_type=...)` | `POST /creator/tryon/image/v1` |
+| `ip.identity.faceswap(target=..., source=...)` | `POST /identity/faceswap/image/v1` |
+| `ip.identity.lock(input_image=..., prompt=...)` | `POST /identity/lock/image/v1` |
+| `ip.identity.replace(input_image=..., prompt=...)` | `POST /identity/replace/image/v1` |
+| `ip.identity.instamodel(prompt=..., input_face=...)` | `POST /creator/instamodel/image/v1` |
+| `ip.identity.voice_clone(text=..., reference_voice_url=...)` | `POST /identity/voice/clone/v1` |
+| `ip.identity.create_profile / list_profiles / get_profile / update_profile / delete_profile` | `/profiles/v1` |
+| `ip.upload.image(file)` | `POST /upload/image/v1` |
+| `ip.jobs.get(endpoint, job_id)` / `ip.jobs.wait(endpoint, job_id)` | `GET <endpoint>/status/{job_id}` |
+
+All parameters are keyword arguments in snake_case, typed from the live
+[OpenAPI spec](https://api.lastshoot.com/docs). Options you leave out use the server default.
+Full parameter reference: [lastshoot.com/docs/sdks/python](https://www.lastshoot.com/docs/sdks/python).
+
+## Async
+
+```python
+import asyncio
+from lastshoot import AsyncLastShoot
+
+async def main():
+    async with AsyncLastShoot() as ip:
+        result = await ip.upscale.image(input_image="https://cdn.example.com/shoe.jpg", scale=2)
+        print(result.url)
+
+asyncio.run(main())
+```
+
+## Errors
+
+```python
+from lastshoot import (
+    LastShootError,            # base class
+    APIError,                  # any non-2xx response: .status_code .message .code .body
+    AuthenticationError,       # 401
+    InsufficientCreditsError,  # 402
+    PermissionDeniedError,     # 403
+    NotFoundError,             # 404
+    InvalidRequestError,       # 400 / 422
+    RateLimitError,            # 429 (.retry_after)
+    InternalServerError,       # 5xx
+    APIConnectionError, APITimeoutError,
+    JobFailedError,            # job ended failed/cancelled: .failure_reason_code .retryable .error
+    JobTimeoutError,           # wait() gave up; the job keeps running server-side
+)
+```
+
+Status polls (GET) retry automatically on 429, 5xx and network errors with exponential
+backoff (`max_retries=2` by default). Job submissions (POST) are never retried automatically,
+so a job is never billed twice.
+
+## Configuration
+
+```python
+LastShoot(
+    api_key=None,                      # default: LASTSHOOT_API_KEY env var
+    base_url="https://api.lastshoot.com",
+    timeout=60.0,                      # per HTTP request
+    max_retries=2,                     # GET retries
+    poll_interval=2.0,                 # default for wait()
+    wait_timeout=600.0,                # default for wait()
+)
+```
+
+## License
+
+MIT

lastshoot-0.1.0/pyproject.toml

@@ -0,0 +1,56 @@
+[build-system]
+requires = ["hatchling>=1.21"]
+build-backend = "hatchling.build"
+
+[project]
+name = "lastshoot"
+version = "0.1.0"
+description = "Official Python client for the LastShoot AI product-photography API"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "LastShoot" }]
+keywords = ["lastshoot", "ai", "product photography", "virtual try-on", "background removal", "image generation", "api", "sdk"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Multimedia :: Graphics",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+  "Typing :: Typed",
+]
+dependencies = ["httpx>=0.24,<1"]
+
+[project.optional-dependencies]
+dev = ["pytest>=7", "pytest-asyncio>=0.23", "respx>=0.21", "mypy>=1.8", "build", "twine"]
+
+[project.urls]
+Repository = "https://github.com/lastshoot-com/lastshoot-sdks"
+Issues = "https://github.com/lastshoot-com/lastshoot-sdks/issues"
+Homepage = "https://www.lastshoot.com"
+Documentation = "https://www.lastshoot.com/docs/sdks/python"
+"API reference" = "https://api.lastshoot.com/docs"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/lastshoot"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/lastshoot", "tests", "README.md", "LICENSE", "pyproject.toml"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+
+[tool.mypy]
+strict = true
+python_version = "3.10"
+files = ["src/lastshoot"]

lastshoot-0.1.0/src/lastshoot/__init__.py

@@ -0,0 +1,63 @@
+"""Official Python client for the LastShoot API (https://www.lastshoot.com)."""
+
+from ._client import DEFAULT_BASE_URL, AsyncLastShoot, FileInput, LastShoot
+from ._endpoints import (
+    AdapterConfigSnapshot,
+    JobQueuedData,
+    JobStatusData,
+    Profile,
+    ProfileList,
+    UploadData,
+    WebhookEvent,
+)
+from ._exceptions import (
+    APIConnectionError,
+    APIError,
+    APITimeoutError,
+    AuthenticationError,
+    InsufficientCreditsError,
+    InternalServerError,
+    InvalidRequestError,
+    JobFailedError,
+    JobTimeoutError,
+    LastShootError,
+    NotFoundError,
+    PermissionDeniedError,
+    RateLimitError,
+)
+from ._models import AsyncJob, Job, JobStatus, ProgressCallback, Result, UploadResult
+from ._version import __version__
+
+__all__ = [
+    "__version__",
+    "DEFAULT_BASE_URL",
+    "LastShoot",
+    "AsyncLastShoot",
+    "FileInput",
+    "Job",
+    "AsyncJob",
+    "JobStatus",
+    "Result",
+    "UploadResult",
+    "ProgressCallback",
+    "AdapterConfigSnapshot",
+    "JobQueuedData",
+    "JobStatusData",
+    "Profile",
+    "ProfileList",
+    "UploadData",
+    "WebhookEvent",
+    "LastShootError",
+    "APIError",
+    "InvalidRequestError",
+    "AuthenticationError",
+    "InsufficientCreditsError",
+    "PermissionDeniedError",
+    "NotFoundError",
+    "RateLimitError",
+    "InternalServerError",
+    "APIConnectionError",
+    "APITimeoutError",
+    "JobFailedError",
+    "JobTimeoutError",
+]