runapi-wan 0.1.0__tar.gz

runapi_wan-0.1.0/PKG-INFO

@@ -0,0 +1,75 @@
+Metadata-Version: 2.4
+Name: runapi-wan
+Version: 0.1.0
+Summary: Wan video and text-to-image client for RunAPI
+Project-URL: Homepage, https://runapi.ai/models/wan
+Project-URL: Documentation, https://runapi.ai/docs#sdk-wan
+Author-email: RunAPI <contact@runapi.ai>
+License-Expression: Apache-2.0
+Keywords: ai,image-to-video,runapi,sdk,text-to-image,text-to-video,wan
+Requires-Python: >=3.9
+Requires-Dist: runapi-core
+Description-Content-Type: text/markdown
+
+# Wan Video API Python SDK for RunAPI
+
+The wan video api Python SDK is the language-specific package for Wan on RunAPI. Use this wan video api package for text-to-video, image-to-video, animation, and video editing flows when your application needs JSON request bodies, task status lookup, and consistent RunAPI errors in Python.
+
+This wan video api README is the Python package guide inside the public `wan-sdk` repository. For the repository overview, start at `../README.md`; for model details, use https://runapi.ai/models/wan; for API reference, use https://runapi.ai/docs#wan; for SDK docs, use https://runapi.ai/docs#sdk-wan.
+
+## Install
+
+```bash
+pip install runapi-wan
+```
+
+## Quick start
+
+```python
+from runapi.wan import WanClient
+
+client = WanClient()  # reads RUNAPI_API_KEY, or pass api_key="sk-..."
+
+task = client.text_to_video.create(
+    model="wan-2.6-text-to-video",
+    prompt="A scenic mountain landscape with flowing rivers",
+)
+status = client.text_to_video.get(task.id)
+
+image = client.text_to_image.create(
+    model="wan-2.7-image",
+    prompt="A neon city street after rain, cinematic",
+)
+```
+
+Use `create` to submit a task and return quickly, `get` to fetch the latest task state, and `run` when a script should create and poll until completion:
+
+```python
+result = client.text_to_video.run(
+    model="wan-2.6-text-to-video",
+    prompt="A serene mountain lake at dawn",
+)
+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 images, videos, audio, or other files 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.wan` error classes when building media jobs or scripts. The available resources are `text_to_video`, `image_to_video`, `speech_to_video`, `animate`, `text_to_image`, and `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/wan
+- SDK docs: https://runapi.ai/docs#sdk-wan
+- Product docs: https://runapi.ai/docs#wan
+- Pricing and rate limits: https://runapi.ai/models/wan/2.2-a14b-text-to-video-turbo
+- Provider comparison: https://runapi.ai/providers/alibaba
+- Full catalog: https://runapi.ai/models
+- Repository: https://github.com/runapi-ai/wan-sdk
+
+## License
+
+Licensed under the Apache License, Version 2.0.

runapi_wan-0.1.0/README.md

@@ -0,0 +1,62 @@
+# Wan Video API Python SDK for RunAPI
+
+The wan video api Python SDK is the language-specific package for Wan on RunAPI. Use this wan video api package for text-to-video, image-to-video, animation, and video editing flows when your application needs JSON request bodies, task status lookup, and consistent RunAPI errors in Python.
+
+This wan video api README is the Python package guide inside the public `wan-sdk` repository. For the repository overview, start at `../README.md`; for model details, use https://runapi.ai/models/wan; for API reference, use https://runapi.ai/docs#wan; for SDK docs, use https://runapi.ai/docs#sdk-wan.
+
+## Install
+
+```bash
+pip install runapi-wan
+```
+
+## Quick start
+
+```python
+from runapi.wan import WanClient
+
+client = WanClient()  # reads RUNAPI_API_KEY, or pass api_key="sk-..."
+
+task = client.text_to_video.create(
+    model="wan-2.6-text-to-video",
+    prompt="A scenic mountain landscape with flowing rivers",
+)
+status = client.text_to_video.get(task.id)
+
+image = client.text_to_image.create(
+    model="wan-2.7-image",
+    prompt="A neon city street after rain, cinematic",
+)
+```
+
+Use `create` to submit a task and return quickly, `get` to fetch the latest task state, and `run` when a script should create and poll until completion:
+
+```python
+result = client.text_to_video.run(
+    model="wan-2.6-text-to-video",
+    prompt="A serene mountain lake at dawn",
+)
+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 images, videos, audio, or other files 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.wan` error classes when building media jobs or scripts. The available resources are `text_to_video`, `image_to_video`, `speech_to_video`, `animate`, `text_to_image`, and `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/wan
+- SDK docs: https://runapi.ai/docs#sdk-wan
+- Product docs: https://runapi.ai/docs#wan
+- Pricing and rate limits: https://runapi.ai/models/wan/2.2-a14b-text-to-video-turbo
+- Provider comparison: https://runapi.ai/providers/alibaba
+- Full catalog: https://runapi.ai/models
+- Repository: https://github.com/runapi-ai/wan-sdk
+
+## License
+
+Licensed under the Apache License, Version 2.0.

runapi_wan-0.1.0/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "runapi-wan"
+version = "0.1.0"
+description = "Wan video and text-to-image client for RunAPI"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "Apache-2.0"
+authors = [{ name = "RunAPI", email = "contact@runapi.ai" }]
+keywords = ["runapi", "wan", "text-to-video", "image-to-video", "text-to-image", "ai", "sdk"]
+dependencies = ["runapi-core"]
+
+[project.urls]
+Homepage = "https://runapi.ai/models/wan"
+Documentation = "https://runapi.ai/docs#sdk-wan"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/runapi"]
+
+[tool.uv]
+package = true
+
+[tool.uv.sources]
+runapi-core = { workspace = true }
+
+[dependency-groups]
+dev = ["pytest>=8"]
+
+[tool.runapi]
+slug = "wan"

runapi_wan-0.1.0/src/runapi/wan/__init__.py

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

runapi_wan-0.1.0/src/runapi/wan/client.py

@@ -0,0 +1,38 @@
+"""Wan client."""
+
+from __future__ import annotations
+
+from typing import Any, Optional
+
+from runapi.core import ClientOptions, HttpClient, resolve_api_key
+
+from .resources.animate import Animate
+from .resources.edit_video import EditVideo
+from .resources.image_to_video import ImageToVideo
+from .resources.speech_to_video import SpeechToVideo
+from .resources.text_to_image import TextToImage
+from .resources.text_to_video import TextToVideo
+
+
+class WanClient:
+    """Wan video and text-to-image client.
+
+    Example::
+
+        client = WanClient(api_key="sk-...")
+        result = client.text_to_video.run(
+            model="wan-2.6-text-to-video",
+            prompt="A scenic mountain landscape with flowing rivers",
+        )
+    """
+
+    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.text_to_video = TextToVideo(http)
+        self.image_to_video = ImageToVideo(http)
+        self.speech_to_video = SpeechToVideo(http)
+        self.animate = Animate(http)
+        self.text_to_image = TextToImage(http)
+        self.edit_video = EditVideo(http)

runapi_wan-0.1.0/src/runapi/wan/contract_gen.py

@@ -0,0 +1,298 @@
+# Code generated by SdkContractGenerator. DO NOT EDIT.
+
+CONTRACT = {
+    "animate": {
+        "models": ["wan-2.2-animate-move", "wan-2.2-animate-replace"],
+        "fields_by_model": {
+            "wan-2.2-animate-move": {
+                "output_resolution": {
+                    "enum": ["480p", "580p", "720p"]
+                },
+                "reference_video_url": {
+                    "required": True
+                },
+                "source_image_url": {
+                    "required": True
+                }
+            },
+            "wan-2.2-animate-replace": {
+                "output_resolution": {
+                    "enum": ["480p", "580p", "720p"]
+                },
+                "reference_video_url": {
+                    "required": True
+                },
+                "source_image_url": {
+                    "required": True
+                }
+            }
+        }
+    },
+    "edit-video": {
+        "models": ["wan-2.6-edit-video", "wan-2.6-flash-edit-video", "wan-2.7-edit-video"],
+        "fields_by_model": {
+            "wan-2.6-edit-video": {
+                "duration_seconds": {
+                    "type": "integer"
+                },
+                "output_resolution": {
+                    "enum": ["720p", "1080p"]
+                },
+                "prompt": {
+                    "required": True
+                },
+                "seed": {
+                    "type": "integer"
+                },
+                "source_video_urls": {
+                    "required": True
+                }
+            },
+            "wan-2.6-flash-edit-video": {
+                "duration_seconds": {
+                    "type": "integer"
+                },
+                "prompt": {
+                    "required": True
+                },
+                "seed": {
+                    "type": "integer"
+                },
+                "source_video_urls": {
+                    "required": True
+                }
+            },
+            "wan-2.7-edit-video": {
+                "aspect_ratio": {
+                    "enum": ["16:9", "9:16", "1:1", "4:3", "3:4"]
+                },
+                "duration_seconds": {
+                    "type": "integer"
+                },
+                "output_resolution": {
+                    "enum": ["720p", "1080p"]
+                },
+                "seed": {
+                    "type": "integer"
+                },
+                "source_video_url": {
+                    "required": True
+                }
+            }
+        }
+    },
+    "image-to-video": {
+        "models": ["wan-2.2-a14b-image-to-video-turbo", "wan-2.5-image-to-video", "wan-2.6-flash-image-to-video", "wan-2.6-image-to-video", "wan-2.7-image-to-video"],
+        "fields_by_model": {
+            "wan-2.2-a14b-image-to-video-turbo": {
+                "duration_seconds": {
+                    "type": "integer"
+                },
+                "first_frame_image_url": {
+                    "required": True
+                },
+                "output_resolution": {
+                    "enum": ["480p", "720p"]
+                },
+                "seed": {
+                    "type": "integer"
+                }
+            },
+            "wan-2.5-image-to-video": {
+                "duration_seconds": {
+                    "required": True,
+                    "type": "integer"
+                },
+                "first_frame_image_url": {
+                    "required": True
+                },
+                "output_resolution": {
+                    "enum": ["720p", "1080p"]
+                },
+                "seed": {
+                    "type": "integer"
+                }
+            },
+            "wan-2.6-flash-image-to-video": {
+                "audio": {
+                    "required": True
+                },
+                "duration_seconds": {
+                    "type": "integer"
+                },
+                "first_frame_image_url": {
+                    "required": True
+                },
+                "output_resolution": {
+                    "enum": ["720p", "1080p"]
+                },
+                "prompt": {
+                    "required": True
+                },
+                "seed": {
+                    "type": "integer"
+                }
+            },
+            "wan-2.6-image-to-video": {
+                "duration_seconds": {
+                    "type": "integer"
+                },
+                "first_frame_image_url": {
+                    "required": True
+                },
+                "output_resolution": {
+                    "enum": ["720p", "1080p"]
+                },
+                "prompt": {
+                    "required": True
+                },
+                "seed": {
+                    "type": "integer"
+                }
+            },
+            "wan-2.7-image-to-video": {
+                "duration_seconds": {
+                    "type": "integer"
+                },
+                "output_resolution": {
+                    "enum": ["720p", "1080p"]
+                },
+                "prompt": {
+                    "required": True
+                },
+                "seed": {
+                    "type": "integer"
+                }
+            }
+        }
+    },
+    "speech-to-video": {
+        "models": ["wan-2.2-a14b-speech-to-video-turbo"],
+        "fields_by_model": {
+            "wan-2.2-a14b-speech-to-video-turbo": {
+                "frames_per_second": {
+                    "type": "integer"
+                },
+                "num_frames": {
+                    "type": "integer"
+                },
+                "num_inference_steps": {
+                    "type": "integer"
+                },
+                "output_resolution": {
+                    "enum": ["480p", "580p", "720p"]
+                },
+                "prompt": {
+                    "required": True
+                },
+                "seed": {
+                    "type": "integer"
+                },
+                "source_audio_url": {
+                    "required": True
+                },
+                "source_image_url": {
+                    "required": True
+                }
+            }
+        }
+    },
+    "text-to-image": {
+        "models": ["wan-2.7-image", "wan-2.7-image-pro"],
+        "fields_by_model": {
+            "wan-2.7-image": {
+                "aspect_ratio": {
+                    "enum": ["1:1", "16:9", "4:3", "21:9", "3:4", "9:16", "8:1", "1:8"]
+                },
+                "output_count": {
+                    "type": "integer"
+                },
+                "output_resolution": {
+                    "enum": ["1k", "2k", "4k"]
+                },
+                "seed": {
+                    "type": "integer"
+                }
+            },
+            "wan-2.7-image-pro": {
+                "aspect_ratio": {
+                    "enum": ["1:1", "16:9", "4:3", "21:9", "3:4", "9:16", "8:1", "1:8"]
+                },
+                "output_count": {
+                    "type": "integer"
+                },
+                "output_resolution": {
+                    "enum": ["1k", "2k", "4k"]
+                },
+                "seed": {
+                    "type": "integer"
+                }
+            }
+        }
+    },
+    "text-to-video": {
+        "models": ["wan-2.2-a14b-text-to-video-turbo", "wan-2.5-text-to-video", "wan-2.6-text-to-video", "wan-2.7-r2v", "wan-2.7-text-to-video"],
+        "fields_by_model": {
+            "wan-2.2-a14b-text-to-video-turbo": {
+                "duration_seconds": {
+                    "type": "integer"
+                },
+                "output_resolution": {
+                    "enum": ["480p", "580p", "720p"]
+                },
+                "seed": {
+                    "type": "integer"
+                }
+            },
+            "wan-2.5-text-to-video": {
+                "duration_seconds": {
+                    "type": "integer"
+                },
+                "output_resolution": {
+                    "enum": ["720p", "1080p"]
+                },
+                "seed": {
+                    "type": "integer"
+                }
+            },
+            "wan-2.6-text-to-video": {
+                "duration_seconds": {
+                    "type": "integer"
+                },
+                "output_resolution": {
+                    "enum": ["720p", "1080p"]
+                },
+                "seed": {
+                    "type": "integer"
+                }
+            },
+            "wan-2.7-r2v": {
+                "aspect_ratio": {
+                    "enum": ["16:9", "9:16", "1:1", "4:3", "3:4"]
+                },
+                "duration_seconds": {
+                    "min": 2,
+                    "max": 10,
+                    "type": "integer"
+                },
+                "output_resolution": {
+                    "enum": ["720p", "1080p"]
+                },
+                "seed": {
+                    "type": "integer"
+                }
+            },
+            "wan-2.7-text-to-video": {
+                "duration_seconds": {
+                    "type": "integer"
+                },
+                "output_resolution": {
+                    "enum": ["720p", "1080p"]
+                },
+                "seed": {
+                    "type": "integer"
+                }
+            }
+        }
+    }
+}

runapi_wan-0.1.0/src/runapi/wan/resources/__init__.py

@@ -0,0 +1,15 @@
+from .animate import Animate
+from .edit_video import EditVideo
+from .image_to_video import ImageToVideo
+from .speech_to_video import SpeechToVideo
+from .text_to_image import TextToImage
+from .text_to_video import TextToVideo
+
+__all__ = [
+    "TextToVideo",
+    "ImageToVideo",
+    "SpeechToVideo",
+    "Animate",
+    "TextToImage",
+    "EditVideo",
+]

runapi_wan-0.1.0/src/runapi/wan/resources/animate.py

@@ -0,0 +1,58 @@
+"""Wan animate resource."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from runapi.core import Resource
+
+from ..contract_gen import CONTRACT
+from ..types import (
+    CompletedVideoTaskResponse,
+    VideoTaskResponse,
+)
+
+
+class Animate(Resource):
+    """Animation operations (animate-move, animate-replace) with Wan models."""
+
+    ENDPOINT = "/api/v1/wan/animate"
+
+    RESPONSE_CLASS = VideoTaskResponse
+    COMPLETED_RESPONSE_CLASS = CompletedVideoTaskResponse
+
+    def run(self, **params: Any) -> Any:
+        """Transfer motion and poll until it completes.
+
+        Args:
+            **params: animation parameters (model, ...).
+
+        Returns:
+            The completed (narrowed) animation response.
+        """
+        task = self.create(**params)
+        return self._poll_until_complete(lambda: self.get(task.id))
+
+    def create(self, **params: Any) -> Any:
+        """Create a animation task and return immediately with an id.
+
+        Args:
+            **params: animation parameters (model, ...).
+
+        Returns:
+            The task creation result with an id.
+        """
+        compacted = self._compact_params(params)
+        self._validate_contract(CONTRACT["animate"], compacted)
+        return self._request("post", self.ENDPOINT, body=compacted)
+
+    def get(self, id: str) -> Any:
+        """Fetch the current status of a animation task.
+
+        Args:
+            id: The task id returned by ``create``.
+
+        Returns:
+            The current task status.
+        """
+        return self._request("get", f"{self.ENDPOINT}/{id}")

runapi_wan-0.1.0/src/runapi/wan/resources/edit_video.py

@@ -0,0 +1,58 @@
+"""Wan edit-video resource."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from runapi.core import Resource
+
+from ..contract_gen import CONTRACT
+from ..types import (
+    CompletedVideoTaskResponse,
+    VideoTaskResponse,
+)
+
+
+class EditVideo(Resource):
+    """Edit videos with Wan models."""
+
+    ENDPOINT = "/api/v1/wan/edit_video"
+
+    RESPONSE_CLASS = VideoTaskResponse
+    COMPLETED_RESPONSE_CLASS = CompletedVideoTaskResponse
+
+    def run(self, **params: Any) -> Any:
+        """Edit a video and poll until it completes.
+
+        Args:
+            **params: video edit parameters (model, ...).
+
+        Returns:
+            The completed (narrowed) video edit response.
+        """
+        task = self.create(**params)
+        return self._poll_until_complete(lambda: self.get(task.id))
+
+    def create(self, **params: Any) -> Any:
+        """Create a video edit task and return immediately with an id.
+
+        Args:
+            **params: video edit parameters (model, ...).
+
+        Returns:
+            The task creation result with an id.
+        """
+        compacted = self._compact_params(params)
+        self._validate_contract(CONTRACT["edit-video"], compacted)
+        return self._request("post", self.ENDPOINT, body=compacted)
+
+    def get(self, id: str) -> Any:
+        """Fetch the current status of a video edit task.
+
+        Args:
+            id: The task id returned by ``create``.
+
+        Returns:
+            The current task status.
+        """
+        return self._request("get", f"{self.ENDPOINT}/{id}")

runapi_wan-0.1.0/src/runapi/wan/resources/image_to_video.py

@@ -0,0 +1,58 @@
+"""Wan image-to-video resource."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from runapi.core import Resource
+
+from ..contract_gen import CONTRACT
+from ..types import (
+    CompletedVideoTaskResponse,
+    VideoTaskResponse,
+)
+
+
+class ImageToVideo(Resource):
+    """Generate videos from a source image with Wan models."""
+
+    ENDPOINT = "/api/v1/wan/image_to_video"
+
+    RESPONSE_CLASS = VideoTaskResponse
+    COMPLETED_RESPONSE_CLASS = CompletedVideoTaskResponse
+
+    def run(self, **params: Any) -> Any:
+        """Generate a video from an image and poll until it completes.
+
+        Args:
+            **params: image-to-video parameters (model, ...).
+
+        Returns:
+            The completed (narrowed) image-to-video response.
+        """
+        task = self.create(**params)
+        return self._poll_until_complete(lambda: self.get(task.id))
+
+    def create(self, **params: Any) -> Any:
+        """Create an image-to-video task and return immediately with an id.
+
+        Args:
+            **params: image-to-video parameters (model, ...).
+
+        Returns:
+            The task creation result with an id.
+        """
+        compacted = self._compact_params(params)
+        self._validate_contract(CONTRACT["image-to-video"], compacted)
+        return self._request("post", self.ENDPOINT, body=compacted)
+
+    def get(self, id: str) -> Any:
+        """Fetch the current status of an image-to-video task.
+
+        Args:
+            id: The task id returned by ``create``.
+
+        Returns:
+            The current task status.
+        """
+        return self._request("get", f"{self.ENDPOINT}/{id}")

runapi_wan-0.1.0/src/runapi/wan/resources/speech_to_video.py

@@ -0,0 +1,58 @@
+"""Wan speech-to-video resource."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from runapi.core import Resource
+
+from ..contract_gen import CONTRACT
+from ..types import (
+    CompletedVideoTaskResponse,
+    VideoTaskResponse,
+)
+
+
+class SpeechToVideo(Resource):
+    """Generate speech-driven talking-head videos with Wan models."""
+
+    ENDPOINT = "/api/v1/wan/speech_to_video"
+
+    RESPONSE_CLASS = VideoTaskResponse
+    COMPLETED_RESPONSE_CLASS = CompletedVideoTaskResponse
+
+    def run(self, **params: Any) -> Any:
+        """Generate a lip-synced video and poll until it completes.
+
+        Args:
+            **params: speech-to-video parameters (model, ...).
+
+        Returns:
+            The completed (narrowed) speech-to-video response.
+        """
+        task = self.create(**params)
+        return self._poll_until_complete(lambda: self.get(task.id))
+
+    def create(self, **params: Any) -> Any:
+        """Create a speech-to-video task and return immediately with an id.
+
+        Args:
+            **params: speech-to-video parameters (model, ...).
+
+        Returns:
+            The task creation result with an id.
+        """
+        compacted = self._compact_params(params)
+        self._validate_contract(CONTRACT["speech-to-video"], compacted)
+        return self._request("post", self.ENDPOINT, body=compacted)
+
+    def get(self, id: str) -> Any:
+        """Fetch the current status of a speech-to-video task.
+
+        Args:
+            id: The task id returned by ``create``.
+
+        Returns:
+            The current task status.
+        """
+        return self._request("get", f"{self.ENDPOINT}/{id}")

runapi_wan-0.1.0/src/runapi/wan/resources/text_to_image.py

@@ -0,0 +1,60 @@
+"""Wan text-to-image resource."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from runapi.core import Resource, ValidationError
+
+from ..contract_gen import CONTRACT
+from ..types import (
+    CompletedImageTaskResponse,
+    ImageTaskResponse,
+)
+
+
+class TextToImage(Resource):
+    """Generate images from text prompts with Wan models."""
+
+    ENDPOINT = "/api/v1/wan/text_to_image"
+
+    RESPONSE_CLASS = ImageTaskResponse
+    COMPLETED_RESPONSE_CLASS = CompletedImageTaskResponse
+
+    def run(self, **params: Any) -> Any:
+        """Generate an image and poll until it completes.
+
+        Args:
+            **params: text-to-image parameters (model, ...).
+
+        Returns:
+            The completed (narrowed) text-to-image response.
+        """
+        task = self.create(**params)
+        return self._poll_until_complete(lambda: self.get(task.id))
+
+    def create(self, **params: Any) -> Any:
+        """Create a text-to-image task and return immediately with an id.
+
+        Args:
+            **params: text-to-image parameters (model, ...).
+
+        Returns:
+            The task creation result with an id.
+        """
+        compacted = self._compact_params(params)
+        self._validate_contract(CONTRACT["text-to-image"], compacted)
+        if not compacted.get("prompt"):
+            raise ValidationError("prompt is required")
+        return self._request("post", self.ENDPOINT, body=compacted)
+
+    def get(self, id: str) -> Any:
+        """Fetch the current status of a text-to-image task.
+
+        Args:
+            id: The task id returned by ``create``.
+
+        Returns:
+            The current task status.
+        """
+        return self._request("get", f"{self.ENDPOINT}/{id}")

runapi_wan-0.1.0/src/runapi/wan/resources/text_to_video.py

@@ -0,0 +1,60 @@
+"""Wan text-to-video resource."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from runapi.core import Resource, ValidationError
+
+from ..contract_gen import CONTRACT
+from ..types import (
+    CompletedVideoTaskResponse,
+    VideoTaskResponse,
+)
+
+
+class TextToVideo(Resource):
+    """Generate videos from text prompts with Wan models."""
+
+    ENDPOINT = "/api/v1/wan/text_to_video"
+
+    RESPONSE_CLASS = VideoTaskResponse
+    COMPLETED_RESPONSE_CLASS = CompletedVideoTaskResponse
+
+    def run(self, **params: Any) -> Any:
+        """Generate a video and poll until it completes.
+
+        Args:
+            **params: text-to-video parameters (model, ...).
+
+        Returns:
+            The completed (narrowed) text-to-video response.
+        """
+        task = self.create(**params)
+        return self._poll_until_complete(lambda: self.get(task.id))
+
+    def create(self, **params: Any) -> Any:
+        """Create a text-to-video task and return immediately with an id.
+
+        Args:
+            **params: text-to-video parameters (model, ...).
+
+        Returns:
+            The task creation result with an id.
+        """
+        compacted = self._compact_params(params)
+        self._validate_contract(CONTRACT["text-to-video"], compacted)
+        if not compacted.get("prompt"):
+            raise ValidationError("prompt is required")
+        return self._request("post", self.ENDPOINT, body=compacted)
+
+    def get(self, id: str) -> Any:
+        """Fetch the current status of a text-to-video task.
+
+        Args:
+            id: The task id returned by ``create``.
+
+        Returns:
+            The current task status.
+        """
+        return self._request("get", f"{self.ENDPOINT}/{id}")

runapi_wan-0.1.0/src/runapi/wan/types.py

@@ -0,0 +1,43 @@
+"""Wan model lists, enums, and response models."""
+
+from __future__ import annotations
+
+from runapi.core import BaseModel, TaskResponse, optional, required
+
+
+class Video(BaseModel):
+    url = optional(str)
+
+
+class Image(BaseModel):
+    url = optional(str)
+
+
+class VideoTaskResponse(TaskResponse):
+    """Wan video task status response."""
+
+    id = required(str)
+    status = optional(str, enum=lambda: TaskResponse.Status.ALL)
+    videos = optional([lambda: Video])
+    error = optional(str)
+
+
+class ImageTaskResponse(TaskResponse):
+    """Wan image task status response."""
+
+    id = required(str)
+    status = optional(str, enum=lambda: TaskResponse.Status.ALL)
+    images = optional([lambda: Image])
+    error = optional(str)
+
+
+class CompletedVideoTaskResponse(VideoTaskResponse):
+    """Narrowed response from ``run()`` once polling observes completion."""
+
+    videos = required([lambda: Video])
+
+
+class CompletedImageTaskResponse(ImageTaskResponse):
+    """Narrowed response from ``run()`` once polling observes completion."""
+
+    images = required([lambda: Image])

runapi_wan-0.1.0/tests/test_client.py

@@ -0,0 +1,199 @@
+import pytest
+
+from runapi.core import config
+from runapi.core.errors import AuthenticationError, ValidationError
+from runapi.wan import WanClient
+from runapi.wan.resources.animate import Animate
+from runapi.wan.resources.edit_video import EditVideo
+from runapi.wan.resources.image_to_video import ImageToVideo
+from runapi.wan.resources.speech_to_video import SpeechToVideo
+from runapi.wan.resources.text_to_image import TextToImage
+from runapi.wan.resources.text_to_video import TextToVideo
+from runapi.wan.types import (
+    CompletedVideoTaskResponse,
+    VideoTaskResponse,
+)
+
+
+class FakeHttp:
+    def __init__(self, *responses):
+        self._responses = list(responses)
+        self.calls = []
+
+    def request(self, method, path, body=None, options=None):
+        self.calls.append((method, path, body))
+        if self._responses:
+            return self._responses.pop(0)
+        return {"id": "task_1", "status": "pending"}
+
+
+@pytest.fixture(autouse=True)
+def reset_config(monkeypatch):
+    monkeypatch.delenv("RUNAPI_API_KEY", raising=False)
+    monkeypatch.setattr(config, "api_key", None)
+    yield
+
+
+# --- auth -----------------------------------------------------------------
+
+
+def test_accepts_api_key_parameter():
+    assert isinstance(WanClient(api_key="k", http_client=FakeHttp()), WanClient)
+
+
+def test_falls_back_to_global(monkeypatch):
+    monkeypatch.setattr(config, "api_key", "global-key")
+    assert isinstance(WanClient(http_client=FakeHttp()), WanClient)
+
+
+def test_falls_back_to_env(monkeypatch):
+    monkeypatch.setenv("RUNAPI_API_KEY", "env-key")
+    assert isinstance(WanClient(http_client=FakeHttp()), WanClient)
+
+
+def test_raises_without_api_key():
+    with pytest.raises(AuthenticationError, match="API key is required"):
+        WanClient()
+
+
+# --- injection / accessors ------------------------------------------------
+
+
+def test_uses_injected_http_client():
+    fake = FakeHttp()
+    client = WanClient(api_key="k", http_client=fake)
+    assert client.text_to_video._http is fake
+    assert client.image_to_video._http is fake
+    assert client.speech_to_video._http is fake
+    assert client.animate._http is fake
+    assert client.text_to_image._http is fake
+    assert client.edit_video._http is fake
+
+
+def test_exposes_resource_accessors():
+    client = WanClient(api_key="k", http_client=FakeHttp())
+    assert isinstance(client.text_to_video, TextToVideo)
+    assert isinstance(client.image_to_video, ImageToVideo)
+    assert isinstance(client.speech_to_video, SpeechToVideo)
+    assert isinstance(client.animate, Animate)
+    assert isinstance(client.text_to_image, TextToImage)
+    assert isinstance(client.edit_video, EditVideo)
+
+
+# --- request shapes -------------------------------------------------------
+
+
+def test_create_posts_compacted_body():
+    fake = FakeHttp({"id": "t1", "status": "pending"})
+    client = WanClient(api_key="k", http_client=fake)
+    result = client.text_to_video.create(
+        model="wan-2.6-text-to-video", prompt="hello world", seed=None
+    )
+    assert fake.calls == [
+        ("post", "/api/v1/wan/text_to_video", {"model": "wan-2.6-text-to-video", "prompt": "hello world"}),
+    ]
+    assert isinstance(result, VideoTaskResponse)
+
+
+def test_get_fetches_by_id():
+    fake = FakeHttp({"id": "t1", "status": "processing"})
+    client = WanClient(api_key="k", http_client=fake)
+    client.text_to_video.get("t1")
+    assert fake.calls == [("get", "/api/v1/wan/text_to_video/t1", None)]
+
+
+def test_image_to_video_posts_to_endpoint():
+    fake = FakeHttp({"id": "t1", "status": "pending"})
+    client = WanClient(api_key="k", http_client=fake)
+    client.image_to_video.create(
+        model="wan-2.6-image-to-video",
+        first_frame_image_url="https://x/a.png",
+        prompt="make it move",
+    )
+    assert fake.calls == [
+        (
+            "post",
+            "/api/v1/wan/image_to_video",
+            {"model": "wan-2.6-image-to-video", "first_frame_image_url": "https://x/a.png", "prompt": "make it move"},
+        ),
+    ]
+
+
+def test_text_to_image_uses_image_endpoint():
+    fake = FakeHttp({"id": "t1", "status": "pending"})
+    client = WanClient(api_key="k", http_client=fake)
+    client.text_to_image.create(model="wan-2.7-image", prompt="a cat")
+    assert fake.calls == [
+        ("post", "/api/v1/wan/text_to_image", {"model": "wan-2.7-image", "prompt": "a cat"}),
+    ]
+
+
+def test_run_narrows_completed_type():
+    fake = FakeHttp(
+        {"id": "t1", "status": "pending"},
+        {"id": "t1", "status": "completed", "videos": [{"url": "https://x/y.mp4"}]},
+    )
+    client = WanClient(api_key="k", http_client=fake)
+    result = client.text_to_video.run(model="wan-2.6-text-to-video", prompt="a serene lake")
+    assert isinstance(result, CompletedVideoTaskResponse)
+    assert result.videos[0].url == "https://x/y.mp4"
+
+
+# --- validation -----------------------------------------------------------
+
+
+def test_rejects_unknown_model():
+    client = WanClient(api_key="k", http_client=FakeHttp())
+    with pytest.raises(ValidationError, match="model must be one of"):
+        client.text_to_video.create(model="nope", prompt="hi there")
+
+
+def test_requires_prompt():
+    client = WanClient(api_key="k", http_client=FakeHttp())
+    with pytest.raises(ValidationError, match="prompt is required"):
+        client.text_to_video.create(model="wan-2.6-text-to-video")
+
+
+def test_animate_requires_source_and_reference():
+    client = WanClient(api_key="k", http_client=FakeHttp())
+    with pytest.raises(ValidationError, match="reference_video_url is required"):
+        client.animate.create(model="wan-2.2-animate-move")
+    with pytest.raises(ValidationError, match="source_image_url is required"):
+        client.animate.create(model="wan-2.2-animate-move", reference_video_url="https://x/v.mp4")
+
+
+def test_speech_to_video_requires_image_and_audio():
+    client = WanClient(api_key="k", http_client=FakeHttp())
+    with pytest.raises(ValidationError, match="source_audio_url is required"):
+        client.speech_to_video.create(
+            model="wan-2.2-a14b-speech-to-video-turbo", prompt="say hi"
+        )
+    with pytest.raises(ValidationError, match="source_image_url is required"):
+        client.speech_to_video.create(
+            model="wan-2.2-a14b-speech-to-video-turbo",
+            prompt="say hi",
+            source_audio_url="https://x/a.mp3",
+        )
+
+
+def test_edit_video_2_6_requires_prompt_and_source_urls():
+    client = WanClient(api_key="k", http_client=FakeHttp())
+    with pytest.raises(ValidationError, match="prompt is required"):
+        client.edit_video.create(model="wan-2.6-edit-video")
+    with pytest.raises(ValidationError, match="source_video_urls is required"):
+        client.edit_video.create(model="wan-2.6-edit-video", prompt="trim it")
+
+
+def test_edit_video_non_2_6_requires_single_source_url():
+    client = WanClient(api_key="k", http_client=FakeHttp())
+    with pytest.raises(ValidationError, match="source_video_url is required"):
+        client.edit_video.create(model="wan-2.7-edit-video")
+
+
+def test_edit_video_non_2_6_accepts_single_source_url():
+    fake = FakeHttp({"id": "t1", "status": "pending"})
+    client = WanClient(api_key="k", http_client=fake)
+    client.edit_video.create(model="wan-2.7-edit-video", source_video_url="https://x/v.mp4")
+    assert fake.calls == [
+        ("post", "/api/v1/wan/edit_video", {"model": "wan-2.7-edit-video", "source_video_url": "https://x/v.mp4"}),
+    ]