runapi-vidu 0.1.0__py3-none-any.whl

runapi/vidu/__init__.py

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

runapi/vidu/client.py

@@ -0,0 +1,20 @@
+"""Vidu client."""
+
+from __future__ import annotations
+
+from typing import Any, Optional
+
+from runapi.core import ProviderClient
+
+from .resources.image_to_video import ImageToVideo
+from .resources.reference_to_video import ReferenceToVideo
+
+
+class ViduClient(ProviderClient):
+    """Vidu image-to-video and reference-to-video client."""
+
+    def __init__(self, api_key: Optional[str] = None, **options: Any) -> None:
+        super().__init__(api_key, **options)
+        http = self._http
+        self.image_to_video = ImageToVideo(http)
+        self.reference_to_video = ReferenceToVideo(http)

runapi/vidu/resources/__init__.py

@@ -0,0 +1,4 @@
+from .image_to_video import ImageToVideo
+from .reference_to_video import ReferenceToVideo
+
+__all__ = ["ImageToVideo", "ReferenceToVideo"]

runapi/vidu/resources/image_to_video.py

@@ -0,0 +1,56 @@
+"""Vidu image-to-video resource."""
+
+from __future__ import annotations
+
+from typing import Any, Optional
+
+from runapi.core import Resource, RequestOptions
+
+from ..types import (
+    CompletedImageToVideoResponse,
+    ImageToVideoResponse,
+)
+
+
+class ImageToVideo(Resource):
+    """Generate videos from a first-frame image with Vidu models."""
+
+    ENDPOINT = "/api/v1/vidu/image_to_video"
+
+    RESPONSE_CLASS = ImageToVideoResponse
+    COMPLETED_RESPONSE_CLASS = CompletedImageToVideoResponse
+
+    def run(self, options: Optional[RequestOptions] = None, **params: Any) -> Any:
+        """Create an image-to-video task and poll until it completes.
+
+        Args:
+            **params: Image-to-video parameters (model, first_frame_image_url, ...).
+
+        Returns:
+            The completed task with videos.
+        """
+        task = self.create(options=options, **params)
+        return self._poll_until_complete(lambda: self.get(task.id, options=options))
+
+    def create(self, options: Optional[RequestOptions] = None, **params: Any) -> Any:
+        """Create an image-to-video task and return immediately with an ``id``.
+
+        Args:
+            **params: Image-to-video parameters (model, first_frame_image_url, ...).
+
+        Returns:
+            The task creation result with an id.
+        """
+        compacted = self._compact_params(params)
+        return self._request("post", self.ENDPOINT, body=compacted, options=options)
+
+    def get(self, id: str, options: Optional[RequestOptions] = None) -> Any:
+        """Fetch the current status of an image-to-video task.
+
+        Args:
+            id: The task id.
+
+        Returns:
+            The current task status.
+        """
+        return self._request("get", f"{self.ENDPOINT}/{id}", options=options)

runapi/vidu/resources/reference_to_video.py

@@ -0,0 +1,56 @@
+"""Vidu reference-to-video resource."""
+
+from __future__ import annotations
+
+from typing import Any, Optional
+
+from runapi.core import Resource, RequestOptions
+
+from ..types import (
+    CompletedReferenceToVideoResponse,
+    ReferenceToVideoResponse,
+)
+
+
+class ReferenceToVideo(Resource):
+    """Generate videos from a first-frame image with Vidu models."""
+
+    ENDPOINT = "/api/v1/vidu/reference_to_video"
+
+    RESPONSE_CLASS = ReferenceToVideoResponse
+    COMPLETED_RESPONSE_CLASS = CompletedReferenceToVideoResponse
+
+    def run(self, options: Optional[RequestOptions] = None, **params: Any) -> Any:
+        """Create an reference-to-video task and poll until it completes.
+
+        Args:
+            **params: Image-to-video parameters (model, reference_image_urls, ...).
+
+        Returns:
+            The completed task with videos.
+        """
+        task = self.create(options=options, **params)
+        return self._poll_until_complete(lambda: self.get(task.id, options=options))
+
+    def create(self, options: Optional[RequestOptions] = None, **params: Any) -> Any:
+        """Create an reference-to-video task and return immediately with an ``id``.
+
+        Args:
+            **params: Image-to-video parameters (model, reference_image_urls, ...).
+
+        Returns:
+            The task creation result with an id.
+        """
+        compacted = self._compact_params(params)
+        return self._request("post", self.ENDPOINT, body=compacted, options=options)
+
+    def get(self, id: str, options: Optional[RequestOptions] = None) -> Any:
+        """Fetch the current status of an reference-to-video task.
+
+        Args:
+            id: The task id.
+
+        Returns:
+            The current task status.
+        """
+        return self._request("get", f"{self.ENDPOINT}/{id}", options=options)

runapi/vidu/types.py

@@ -0,0 +1,32 @@
+"""Vidu model lists, enums, and response models."""
+
+from __future__ import annotations
+
+from runapi.core import BaseModel, TaskResponse, optional, required
+
+
+
+class MediaUrl(BaseModel):
+    url = optional(str)
+
+
+class VideoResponse(TaskResponse):
+    """Response for a video generation task."""
+
+    id = required(str)
+    status = optional(str, enum=lambda: TaskResponse.Status.ALL)
+    videos = optional([lambda: MediaUrl])
+    error = optional(str)
+
+
+class CompletedVideoResponse(VideoResponse):
+    """Narrowed response from ``run()`` once polling observes completion."""
+
+    videos = required([lambda: MediaUrl])
+
+
+ImageToVideoResponse = VideoResponse
+CompletedImageToVideoResponse = CompletedVideoResponse
+
+ReferenceToVideoResponse = VideoResponse
+CompletedReferenceToVideoResponse = CompletedVideoResponse

runapi_vidu-0.1.0.dist-info/METADATA

@@ -0,0 +1,47 @@
+Metadata-Version: 2.5
+Name: runapi-vidu
+Version: 0.1.0
+Summary: RunAPI Vidu SDK for image-to-video and reference-to-video workflows in JavaScript, Python, Ruby, Go, Java, and PHP
+Project-URL: Homepage, https://runapi.ai/models/vidu
+Project-URL: Documentation, https://runapi.ai/docs/resources/sdks
+Project-URL: Source, https://github.com/runapi-ai/vidu-sdk
+Project-URL: Issues, https://github.com/runapi-ai/vidu-sdk/issues
+Project-URL: Changelog, https://github.com/runapi-ai/vidu-sdk/blob/main/CHANGELOG.md
+Project-URL: Release Notes, https://github.com/runapi-ai/vidu-sdk/releases/tag/python%2Fv0.1.0
+Author-email: RunAPI <contact@runapi.ai>
+License-Expression: Apache-2.0
+Keywords: api,golang,gradle,java,maven,python,reference-to-video,ruby,runapi,runapi-ai,sdk,typescript,video-api,video-generation,vidu,vidu-ai-api
+Requires-Python: >=3.9
+Requires-Dist: runapi-core~=0.10.1
+Description-Content-Type: text/markdown
+
+# Vidu Python SDK for RunAPI
+
+Create image-to-video or reference-to-video tasks, retrieve their status, or use `run` to poll until completion. Validation runs on the RunAPI server.
+
+## Install
+
+```sh
+pip install runapi-vidu
+```
+
+## Quick start
+
+Set `RUNAPI_API_KEY` in your environment. Replace the example image URL with a publicly accessible reference image.
+
+```python
+from runapi.vidu import ViduClient
+
+client = ViduClient()  # reads RUNAPI_API_KEY
+result = client.reference_to_video.run(
+    model="vidu-q4-reference-to-video",
+    prompt="Animate the referenced scene with a slow camera pan",
+    reference_image_urls=["https://cdn.runapi.ai/public/samples/image.jpg"],
+    audio=False,
+)
+print(result.videos[0].url)
+```
+
+Use `create` to submit without waiting and `get` to retrieve the task by ID. Reference generation requires a prompt and 1–15 image URLs; it also accepts up to 3 MP3 reference audio URLs. Images must be JPG/JPEG/PNG/WEBP, at most 50 MB each; MP3 references must be 3–12 seconds and at most 50 MB each. Remote file properties are checked during provider processing, so a task can fail asynchronously.
+
+See the [API reference](https://runapi.ai/docs/api/vidu/reference-to-video) and [SDK guide](https://runapi.ai/docs/resources/sdks). For current pricing, use the canonical model pages: [image-to-video](https://runapi.ai/models/vidu/q4-image-to-video) and [reference-to-video](https://runapi.ai/models/vidu/q4-reference-to-video).

runapi_vidu-0.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+runapi/vidu/__init__.py,sha256=nb39DbBe2CeY9kLb3THjSnPHkCZr9WnUclvWsDTHc2U,454
+runapi/vidu/client.py,sha256=4OjUvf4JU0c3UCfRMjoOIBqYcbYPjdsQZ3QvhoagvUE,594
+runapi/vidu/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+runapi/vidu/types.py,sha256=A6lmqGaZQFSSOvNdZvjp-SZxyU-_eqXXQ-q1muB2TIA,815
+runapi/vidu/resources/__init__.py,sha256=bW0Lk86IIQ__Wy9l0ormFmaNpNnEIClhQr5XQxwzCnY,138
+runapi/vidu/resources/image_to_video.py,sha256=LreBWlVCRRd9j4XGhW8KlOyUmvROk4exSESFPzRvZwc,1770
+runapi/vidu/resources/reference_to_video.py,sha256=MMWeJHilcricEz-pQkdVfx8a5EjdDYyhPHM6wHurgCE,1808
+runapi_vidu-0.1.0.dist-info/METADATA,sha256=kOcg-GgeLBXf5Udxf2LA-MuOYOzkRmTYPXpVeTQVUgk,2382
+runapi_vidu-0.1.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+runapi_vidu-0.1.0.dist-info/RECORD,,

runapi_vidu-0.1.0.dist-info/WHEEL

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