runapi-volcengine-lip-sync 0.1.1__py3-none-any.whl

runapi/volcengine_lip_sync/__init__.py

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

runapi/volcengine_lip_sync/client.py

@@ -0,0 +1,19 @@
+"""Volcengine Lip Sync client."""
+
+from __future__ import annotations
+
+from typing import Any, Optional
+
+from runapi.core import ClientOptions, HttpClient, resolve_api_key
+
+from .resources.lip_sync_video import LipSyncVideo
+
+
+class VolcengineLipSyncClient:
+    """Volcengine Lip Sync client."""
+
+    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.lip_sync_video = LipSyncVideo(http)

runapi/volcengine_lip_sync/contract_gen.py

@@ -0,0 +1,38 @@
+CONTRACT = {
+    "lip-sync-video": {
+        "models": ["volcengine-lip-sync"],
+        "fields_by_model": {
+            "volcengine-lip-sync": {
+                "mode": {
+                    "enum": ["lite", "basic"],
+                    "required": True
+                },
+                "source_audio_url": {
+                    "required": True
+                },
+                "source_video_url": {
+                    "required": True
+                },
+                "template_start_seconds": {
+                    "min": 0
+                }
+            }
+        },
+        "rules": [{
+            "when": {
+                "mode": "lite"
+            },
+            "forbidden": ["enable_scene_detection"]
+        }, {
+            "when": {
+                "mode": "basic"
+            },
+            "forbidden": ["align_audio", "align_audio_reverse", "template_start_seconds"]
+        }, {
+            "when": {
+                "align_audio_reverse": True
+            },
+            "required": ["align_audio"]
+        }]
+    }
+}

runapi/volcengine_lip_sync/py.typed

@@ -0,0 +1 @@
+

runapi/volcengine_lip_sync/resources/__init__.py

@@ -0,0 +1,3 @@
+from .lip_sync_video import LipSyncVideo
+
+__all__ = ["LipSyncVideo"]

runapi/volcengine_lip_sync/resources/lip_sync_video.py

@@ -0,0 +1,34 @@
+"""Volcengine Lip Sync video resource."""
+
+from __future__ import annotations
+
+from typing import Any, Optional
+
+from runapi.core import Resource, RequestOptions
+
+from ..contract_gen import CONTRACT
+from ..types import CompletedLipSyncVideoResponse, LipSyncVideoResponse
+
+
+class LipSyncVideo(Resource):
+    """Drive a source video's lip movement from an audio track."""
+
+    ENDPOINT = "/api/v1/volcengine_lip_sync/lip_sync_video"
+
+    RESPONSE_CLASS = LipSyncVideoResponse
+    COMPLETED_RESPONSE_CLASS = CompletedLipSyncVideoResponse
+
+    def run(self, options: Optional[RequestOptions] = None, **params: Any) -> Any:
+        """Create a task and poll until it completes."""
+        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 a lip-sync video task and return immediately with an ``id``."""
+        compacted = self._compact_params(params)
+        self._validate_contract(CONTRACT["lip-sync-video"], compacted)
+        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 a lip-sync video task."""
+        return self._request("get", f"{self.ENDPOINT}/{id}", options=options)

runapi/volcengine_lip_sync/types.py

@@ -0,0 +1,26 @@
+"""Volcengine Lip Sync response models."""
+
+from __future__ import annotations
+
+from runapi.core import BaseModel, TaskResponse, optional, required
+
+
+class Video(BaseModel):
+    """A generated video reference."""
+
+    url = optional(str)
+
+
+class LipSyncVideoResponse(TaskResponse):
+    """Response for a lip-sync video task."""
+
+    id = required(str)
+    status = optional(str, enum=lambda: TaskResponse.Status.ALL)
+    videos = optional([lambda: Video])
+    error = optional(str)
+
+
+class CompletedLipSyncVideoResponse(LipSyncVideoResponse):
+    """Returned by ``lip_sync_video.run()`` once polling observes completion."""
+
+    videos = required([lambda: Video])

runapi_volcengine_lip_sync-0.1.1.dist-info/METADATA

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: runapi-volcengine-lip-sync
+Version: 0.1.1
+Summary: RunAPI Volcengine Lip Sync SDK for audio-driven video-to-video lip sync workflows in JavaScript, Python, Ruby, Go, Java, and PHP
+Project-URL: Homepage, https://runapi.ai/models/volcengine-lip-sync
+Project-URL: Documentation, https://runapi.ai/docs#sdk-volcengine-lip-sync
+Project-URL: Source, https://github.com/runapi-ai/volcengine-lip-sync-sdk
+Project-URL: Issues, https://github.com/runapi-ai/volcengine-lip-sync-sdk/issues
+Author-email: RunAPI <contact@runapi.ai>
+License-Expression: Apache-2.0
+Keywords: api,golang,gradle,java,lip-sync,lip-sync-api,maven,python,ruby,runapi,runapi-ai,sdk,typescript,video-api,video-generation,volcengine
+Requires-Python: >=3.9
+Requires-Dist: runapi-core>=0.1.4
+Description-Content-Type: text/markdown
+
+# Volcengine Lip Sync API Python SDK for RunAPI
+
+The Volcengine Lip Sync Python SDK submits lip-sync video tasks and retrieves task results through RunAPI.
+
+## Install
+
+```bash
+pip install runapi-volcengine-lip-sync
+```
+
+## Quick start
+
+```python
+from runapi.volcengine_lip_sync import VolcengineLipSyncClient
+
+client = VolcengineLipSyncClient()
+task = client.lip_sync_video.create(
+    model="volcengine-lip-sync",
+    mode="lite",
+    source_video_url="https://cdn.runapi.ai/public/samples/volcengine-lip-sync-source.mp4",
+    source_audio_url="https://cdn.runapi.ai/public/samples/volcengine-lip-sync-voice-adam.mp3",
+)
+status = client.lip_sync_video.get(task.id)
+```
+
+Use `create`, `get`, and `run` for async workflows. Keep `RUNAPI_API_KEY` in the environment or your secret manager.
+
+## Links
+
+- Model page: https://runapi.ai/models/volcengine-lip-sync
+- SDK docs: https://runapi.ai/docs#sdk-volcengine-lip-sync
+- Product docs: https://runapi.ai/docs#volcengine-lip-sync
+- Pricing and rate limits: https://runapi.ai/models/volcengine-lip-sync
+- Repository: https://github.com/runapi-ai/volcengine-lip-sync-sdk
+
+## License
+
+Licensed under the Apache License, Version 2.0.

runapi_volcengine_lip_sync-0.1.1.dist-info/RECORD

@@ -0,0 +1,10 @@
+runapi/volcengine_lip_sync/__init__.py,sha256=F9nQqtgsqICSt85wVE7VqNTky1epL3o5Z0RZASl7_WY,495
+runapi/volcengine_lip_sync/client.py,sha256=0dmgwQYDpbC86hcXSizoPQkaj3mKEzIxt-HOyFTd5co,624
+runapi/volcengine_lip_sync/contract_gen.py,sha256=YlBcZuNJ8OPlJxu3nOJJv8-bdow9wYungPluaw9ZCoM,1044
+runapi/volcengine_lip_sync/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+runapi/volcengine_lip_sync/types.py,sha256=8cFV2P_zyVnOpn2ey-pBgA31PliAn8ZO7Qq9DBHjoyc,664
+runapi/volcengine_lip_sync/resources/__init__.py,sha256=uNLVAjqWg190qZb4eQmfTbXGiRLAfiSGrscRUBjTQ-E,69
+runapi/volcengine_lip_sync/resources/lip_sync_video.py,sha256=alqbqt0tEU8-RaG6sNKmko1aQDUA9wnD1m9Lj-k7ZJc,1410
+runapi_volcengine_lip_sync-0.1.1.dist-info/METADATA,sha256=LPZQGUheNcvOVcWxHOlJ6I2Ce5N2xDuOY95bTmP6V3U,1996
+runapi_volcengine_lip_sync-0.1.1.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+runapi_volcengine_lip_sync-0.1.1.dist-info/RECORD,,

runapi_volcengine_lip_sync-0.1.1.dist-info/WHEEL

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