runapi-runway-aleph 0.1.0__py3-none-any.whl

runapi/runway_aleph/__init__.py

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

runapi/runway_aleph/client.py

@@ -0,0 +1,29 @@
+"""Runway Aleph client."""
+
+from __future__ import annotations
+
+from typing import Any, Optional
+
+from runapi.core import ClientOptions, HttpClient, resolve_api_key
+
+from .resources.edit_video import EditVideo
+
+
+class RunwayAlephClient:
+    """Runway Aleph prompt-guided video editing client.
+
+    Example::
+
+        client = RunwayAlephClient(api_key="sk-...")
+        result = client.edit_video.run(
+            model="runway-aleph",
+            prompt="Transform the scene into a watercolor painting style",
+            source_video_url="https://cdn.runapi.ai/public/samples/video.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.edit_video = EditVideo(http)

runapi/runway_aleph/contract_gen.py

@@ -0,0 +1,21 @@
+CONTRACT = {
+    "edit-video": {
+        "models": ["runway-aleph"],
+        "fields_by_model": {
+            "runway-aleph": {
+                "aspect_ratio": {
+                    "enum": ["16:9", "9:16", "4:3", "3:4", "1:1", "21:9"]
+                },
+                "prompt": {
+                    "required": True
+                },
+                "seed": {
+                    "type": "integer"
+                },
+                "source_video_url": {
+                    "required": True
+                }
+            }
+        }
+    }
+}

runapi/runway_aleph/resources/__init__.py

@@ -0,0 +1,3 @@
+from .edit_video import EditVideo
+
+__all__ = ["EditVideo"]

runapi/runway_aleph/resources/edit_video.py

@@ -0,0 +1,39 @@
+"""Runway Aleph edit-video resource."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from runapi.core import Resource
+
+from ..contract_gen import CONTRACT
+from ..types import (
+    CompletedEditVideoResponse,
+    TaskCreateResponse,
+)
+
+
+class EditVideo(Resource):
+    """Prompt-guided video editing with Runway Aleph."""
+
+    ENDPOINT = "/api/v1/runway_aleph/edit_video"
+
+    RESPONSE_CLASS = TaskCreateResponse
+    COMPLETED_RESPONSE_CLASS = CompletedEditVideoResponse
+
+    MODEL = "runway-aleph"
+
+    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 an edit-video task and return immediately with an ``id``."""
+        compacted = self._compact_params(params)
+        self._validate_contract(CONTRACT["edit-video"], {**compacted, "model": self.MODEL})
+        return self._request("post", self.ENDPOINT, body=compacted)
+
+    def get(self, id: str) -> Any:
+        """Fetch the current status of an edit-video task."""
+        return self._request("get", f"{self.ENDPOINT}/{id}")

runapi/runway_aleph/types.py

@@ -0,0 +1,37 @@
+"""Runway Aleph enums and response models."""
+
+from __future__ import annotations
+
+from runapi.core import BaseModel, TaskResponse, optional, required
+
+
+class Video(BaseModel):
+    id = optional(str)
+    url = required(str)
+
+
+class Image(BaseModel):
+    url = required(str)
+
+
+class EditVideoResponse(TaskResponse):
+    """Runway Aleph video editing task status response."""
+
+    id = required(str)
+    status = optional(str, enum=lambda: TaskResponse.Status.ALL)
+    videos = optional([lambda: Video])
+    images = optional([lambda: Image])
+    error = optional(str)
+
+
+class TaskCreateResponse(EditVideoResponse):
+    """Runway Aleph task creation response with an id."""
+
+
+class CompletedEditVideoResponse(EditVideoResponse):
+    """Returned by ``edit_video.run()`` once polling observes completion.
+
+    ``videos`` is required so callers never have to null-check it on success.
+    """
+
+    videos = required([lambda: Video])

runapi_runway_aleph-0.1.0.dist-info/METADATA

@@ -0,0 +1,81 @@
+Metadata-Version: 2.4
+Name: runapi-runway-aleph
+Version: 0.1.0
+Summary: Runway Aleph prompt-guided video editing client for RunAPI
+Project-URL: Homepage, https://runapi.ai/models/runway-aleph
+Project-URL: Documentation, https://runapi.ai/docs#sdk-runway-aleph
+Author-email: RunAPI <contact@runapi.ai>
+License-Expression: Apache-2.0
+Keywords: ai,runapi,runway,runway-aleph,sdk,video
+Requires-Python: >=3.9
+Requires-Dist: runapi-core
+Description-Content-Type: text/markdown
+
+# Runway Aleph Python SDK for RunAPI
+
+The Runway Aleph Python SDK is the language-specific package for Runway Aleph on
+RunAPI. Use it for prompt-guided video editing when your application needs JSON
+request bodies, task status lookup, and consistent RunAPI errors in Python.
+
+For model details, use https://runapi.ai/models/runway-aleph; for API reference,
+use https://runapi.ai/docs#runway-aleph; for SDK docs, use
+https://runapi.ai/docs#sdk-runway-aleph.
+
+## Install
+
+```bash
+pip install runapi-runway-aleph
+```
+
+## Quick start
+
+```python
+from runapi.runway_aleph import RunwayAlephClient
+
+client = RunwayAlephClient()  # reads RUNAPI_API_KEY, or pass api_key="sk-..."
+
+task = client.edit_video.create(
+    model="runway-aleph",
+    prompt="Transform the scene into a watercolor painting style",
+    source_video_url="https://cdn.runapi.ai/public/samples/video.mp4",
+)
+status = client.edit_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.edit_video.run(
+    model="runway-aleph",
+    prompt="Transform the scene into a watercolor painting style",
+    source_video_url="https://cdn.runapi.ai/public/samples/video.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.runway_aleph` error
+classes when building video jobs, workers, or scripts. The available resource is
+`edit_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/runway-aleph
+- SDK docs: https://runapi.ai/docs#sdk-runway-aleph
+- Product docs: https://runapi.ai/docs#runway-aleph
+- Pricing and rate limits: https://runapi.ai/models/runway-aleph
+- Full catalog: https://runapi.ai/models
+
+## License
+
+Licensed under the Apache License, Version 2.0.

runapi_runway_aleph-0.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+runapi/runway_aleph/__init__.py,sha256=XBMwewKDb6uX-Q9CjfHdMCY3gkvcW9ymtP8f_fDypi8,476
+runapi/runway_aleph/client.py,sha256=fdRAy5kURdONFEnfpVlYk9oHyCr5NVFzHUEWAFkJFDo,930
+runapi/runway_aleph/contract_gen.py,sha256=29JMHJciIZxcu4GDjs2C6ttMXmSz4PwJqmZtH3hnHA4,547
+runapi/runway_aleph/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+runapi/runway_aleph/types.py,sha256=6oHjwqfMNiFBs2BNIQI2fvfeyZv1M-oY5ASsraWBM_w,928
+runapi/runway_aleph/resources/__init__.py,sha256=cI9Ydn4h0zTbPbW1BJoAI20vYcHdoJ8JB8wB7bmtIOs,59
+runapi/runway_aleph/resources/edit_video.py,sha256=r8snBWNiLtNu_1i85ycZU0csi8fSDbyXoJBb8HaHo-g,1210
+runapi_runway_aleph-0.1.0.dist-info/METADATA,sha256=6aMKKyJswKDKsSJQWBoI2asrcnPTezlg0aMfi57Q7Rc,2679
+runapi_runway_aleph-0.1.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+runapi_runway_aleph-0.1.0.dist-info/RECORD,,

runapi_runway_aleph-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