runapi-luma 0.1.0__py3-none-any.whl

runapi/luma/__init__.py

@@ -0,0 +1,24 @@
+"""Luma client for RunAPI."""
+
+from runapi.core import (
+    AuthenticationError,
+    InsufficientCreditsError,
+    NotFoundError,
+    RateLimitError,
+    TaskFailedError,
+    TaskTimeoutError,
+    ValidationError,
+)
+
+from .client import LumaClient
+
+__all__ = [
+    "LumaClient",
+    "AuthenticationError",
+    "RateLimitError",
+    "InsufficientCreditsError",
+    "NotFoundError",
+    "ValidationError",
+    "TaskFailedError",
+    "TaskTimeoutError",
+]

runapi/luma/client.py

@@ -0,0 +1,28 @@
+"""Luma client."""
+
+from __future__ import annotations
+
+from typing import Any, Optional
+
+from runapi.core import ClientOptions, HttpClient, resolve_api_key
+
+from .resources.modify_video import ModifyVideo
+
+
+class LumaClient:
+    """Luma modify-video client.
+
+    Example::
+
+        client = LumaClient(api_key="sk-...")
+        result = client.modify_video.run(
+            model="...", prompt="Make it cinematic",
+            source_video_url="https://example.com/source.mp4",
+        )
+    """
+
+    def __init__(self, api_key: Optional[str] = None, **options: Any) -> None:
+        resolved_api_key = resolve_api_key(api_key)
+        client_options = ClientOptions(api_key=resolved_api_key, **options)
+        http = client_options.http_client or HttpClient(client_options)
+        self.modify_video = ModifyVideo(http)

runapi/luma/resources/__init__.py

@@ -0,0 +1,3 @@
+from .modify_video import ModifyVideo
+
+__all__ = ["ModifyVideo"]

runapi/luma/resources/modify_video.py

@@ -0,0 +1,39 @@
+"""Luma modify-video resource."""
+
+from __future__ import annotations
+
+from typing import Any, Dict
+
+from runapi.core import Resource, ValidationError
+
+from ..types import CompletedModifyVideoResponse, ModifyVideoResponse
+
+
+class ModifyVideo(Resource):
+    """Modify a source video with Luma."""
+
+    ENDPOINT = "/api/v1/luma/modify_video"
+
+    RESPONSE_CLASS = ModifyVideoResponse
+    COMPLETED_RESPONSE_CLASS = CompletedModifyVideoResponse
+
+    def run(self, **params: Any) -> Any:
+        """Create a task and poll until it completes."""
+        task = self.create(**params)
+        return self._poll_until_complete(lambda: self.get(task.id))
+
+    def create(self, **params: Any) -> Any:
+        """Create a modify-video task and return immediately with an ``id``."""
+        compacted = self._compact_params(params)
+        self._validate_params(compacted)
+        return self._request("post", self.ENDPOINT, body=compacted)
+
+    def get(self, id: str) -> Any:
+        """Fetch the current status of a modify-video task."""
+        return self._request("get", f"{self.ENDPOINT}/{id}")
+
+    def _validate_params(self, params: Dict[str, Any]) -> None:
+        if not params.get("prompt"):
+            raise ValidationError("prompt is required")
+        if not params.get("source_video_url"):
+            raise ValidationError("source_video_url is required")

runapi/luma/types.py

@@ -0,0 +1,30 @@
+"""Luma response models."""
+
+from __future__ import annotations
+
+from runapi.core import BaseModel, TaskResponse, optional, required
+
+
+class Video(BaseModel):
+    """A generated or source video reference."""
+
+    url = optional(str)
+
+
+class ModifyVideoResponse(TaskResponse):
+    """Response for a modify-video task."""
+
+    id = required(str)
+    status = optional(str, enum=lambda: TaskResponse.Status.ALL)
+    videos = optional([lambda: Video])
+    sources = optional([lambda: Video])
+    error = optional(str)
+
+
+class CompletedModifyVideoResponse(ModifyVideoResponse):
+    """Returned by ``modify_video.run()`` once polling observes completion.
+
+    ``videos`` is required so callers never have to null-check it on success.
+    """
+
+    videos = required([lambda: Video])

runapi_luma-0.1.0.dist-info/METADATA

@@ -0,0 +1,80 @@
+Metadata-Version: 2.4
+Name: runapi-luma
+Version: 0.1.0
+Summary: Luma modify-video client for RunAPI
+Project-URL: Homepage, https://runapi.ai/models/luma
+Project-URL: Documentation, https://runapi.ai/docs#sdk-luma
+Author-email: RunAPI <contact@runapi.ai>
+License-Expression: Apache-2.0
+Keywords: ai,luma,modify-video,runapi,sdk,video
+Requires-Python: >=3.9
+Requires-Dist: runapi-core
+Description-Content-Type: text/markdown
+
+# Luma Python SDK for RunAPI
+
+The Luma Python SDK is the language-specific package for Luma on RunAPI. Use it
+for video modification flows when your application needs JSON request bodies,
+task status lookup, and consistent RunAPI errors in Python.
+
+For model details, use https://runapi.ai/models/luma; for API reference, use
+https://runapi.ai/docs#luma; for SDK docs, use https://runapi.ai/docs#sdk-luma.
+
+## Install
+
+```bash
+pip install runapi-luma
+```
+
+## Quick start
+
+```python
+from runapi.luma import LumaClient
+
+client = LumaClient()  # reads RUNAPI_API_KEY, or pass api_key="sk-..."
+
+task = client.modify_video.create(
+    model="ray-2-modify-video",
+    prompt="Make it cinematic with warm golden tones",
+    source_video_url="https://example.com/source.mp4",
+)
+status = client.modify_video.get(task.id)
+```
+
+Use `create` to submit a task and return quickly, `get` to fetch the latest task
+state, and `run` to create and poll until completion:
+
+```python
+result = client.modify_video.run(
+    model="ray-2-modify-video",
+    prompt="Restyle as a hand-painted animation",
+    source_video_url="https://example.com/source.mp4",
+)
+print(result.videos[0].url)
+```
+
+In web request handlers, prefer `create` plus webhook or later `get` polling so a
+worker is not held open.
+
+RunAPI-generated file URLs are temporary. Download and store generated videos in
+your own durable storage within 7 days; do not treat returned URLs as long-term
+assets.
+
+## Language notes
+
+Pass parameters as keyword arguments and catch the `runapi.luma` error classes
+when building video jobs or scripts. The available resource is `modify_video`.
+Keep `RUNAPI_API_KEY` in the environment or your secret manager; never commit API
+keys or callback secrets.
+
+## Links
+
+- Model page: https://runapi.ai/models/luma
+- SDK docs: https://runapi.ai/docs#sdk-luma
+- Product docs: https://runapi.ai/docs#luma
+- Pricing and rate limits: https://runapi.ai/models/luma
+- Full catalog: https://runapi.ai/models
+
+## License
+
+Licensed under the Apache License, Version 2.0.

runapi_luma-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+runapi/luma/__init__.py,sha256=6x8qZwnaqVp7hzNM60PqbHZU3BblmSdwXA7Tz2w2N-8,454
+runapi/luma/client.py,sha256=jy67J69jzYSBoCD07DgxGRnlto1SFD0CRCexuhZ8Vbk,823
+runapi/luma/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+runapi/luma/types.py,sha256=H2m_mwutA4tK42tJ6Y3GWWosz1RBaUiD5Cmp4ww-AVI,776
+runapi/luma/resources/__init__.py,sha256=UZ1c3c-jx_4xvQORC5SJ-jhXmKi4pQN9RrK0_bKSjNs,65
+runapi/luma/resources/modify_video.py,sha256=YFG00ej5peIwbZOagLAEuC21V4mrUgamRuhslN8NI28,1360
+runapi_luma-0.1.0.dist-info/METADATA,sha256=-3T-jpM_lhZSQXN6c6n2yle_5cwTX6QseWnZ6pYl5yA,2458
+runapi_luma-0.1.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+runapi_luma-0.1.0.dist-info/RECORD,,

runapi_luma-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any