runwayml 3.4.0__py3-none-any.whl → 3.6.0__py3-none-any.whl

runwayml/__init__.py

@@ -36,7 +36,8 @@ from ._exceptions import (
     UnprocessableEntityError,
     APIResponseValidationError,
 )
-from ._base_client import DefaultHttpxClient, DefaultAsyncHttpxClient
+from .lib.polling import TaskFailedError, TaskTimeoutError
+from ._base_client import DefaultHttpxClient, DefaultAioHttpClient, DefaultAsyncHttpxClient
 from ._utils._logs import setup_logging as _setup_logging
 
 __all__ = [
@@ -78,6 +79,9 @@ __all__ = [
     "DEFAULT_CONNECTION_LIMITS",
     "DefaultHttpxClient",
     "DefaultAsyncHttpxClient",
+    "DefaultAioHttpClient",
+    "TaskFailedError",
+    "TaskTimeoutError",
 ]
 
 if not _t.TYPE_CHECKING:

runwayml/_base_client.py

@@ -1071,7 +1071,14 @@ class SyncAPIClient(BaseClient[httpx.Client, Stream[Any]]):
     ) -> ResponseT:
         origin = get_origin(cast_to) or cast_to
 
-        if inspect.isclass(origin) and issubclass(origin, BaseAPIResponse):
+        if (
+            inspect.isclass(origin)
+            and issubclass(origin, BaseAPIResponse)
+            # we only want to actually return the custom BaseAPIResponse class if we're
+            # returning the raw response, or if we're not streaming SSE, as if we're streaming
+            # SSE then `cast_to` doesn't actively reflect the type we need to parse into
+            and (not stream or bool(response.request.headers.get(RAW_RESPONSE_HEADER)))
+        ):
             if not issubclass(origin, APIResponse):
                 raise TypeError(f"API Response types must subclass {APIResponse}; Received {origin}")
 
@@ -1282,6 +1289,24 @@ class _DefaultAsyncHttpxClient(httpx.AsyncClient):
         super().__init__(**kwargs)
 
 
+try:
+    import httpx_aiohttp
+except ImportError:
+
+    class _DefaultAioHttpClient(httpx.AsyncClient):
+        def __init__(self, **_kwargs: Any) -> None:
+            raise RuntimeError("To use the aiohttp client you must have installed the package with the `aiohttp` extra")
+else:
+
+    class _DefaultAioHttpClient(httpx_aiohttp.HttpxAiohttpClient):  # type: ignore
+        def __init__(self, **kwargs: Any) -> None:
+            kwargs.setdefault("timeout", DEFAULT_TIMEOUT)
+            kwargs.setdefault("limits", DEFAULT_CONNECTION_LIMITS)
+            kwargs.setdefault("follow_redirects", True)
+
+            super().__init__(**kwargs)
+
+
 if TYPE_CHECKING:
     DefaultAsyncHttpxClient = httpx.AsyncClient
     """An alias to `httpx.AsyncClient` that provides the same defaults that this SDK
@@ -1290,8 +1315,12 @@ if TYPE_CHECKING:
     This is useful because overriding the `http_client` with your own instance of
     `httpx.AsyncClient` will result in httpx's defaults being used, not ours.
     """
+
+    DefaultAioHttpClient = httpx.AsyncClient
+    """An alias to `httpx.AsyncClient` that changes the default HTTP transport to `aiohttp`."""
 else:
     DefaultAsyncHttpxClient = _DefaultAsyncHttpxClient
+    DefaultAioHttpClient = _DefaultAioHttpClient
 
 
 class AsyncHttpxClientWrapper(DefaultAsyncHttpxClient):
@@ -1574,7 +1603,14 @@ class AsyncAPIClient(BaseClient[httpx.AsyncClient, AsyncStream[Any]]):
     ) -> ResponseT:
         origin = get_origin(cast_to) or cast_to
 
-        if inspect.isclass(origin) and issubclass(origin, BaseAPIResponse):
+        if (
+            inspect.isclass(origin)
+            and issubclass(origin, BaseAPIResponse)
+            # we only want to actually return the custom BaseAPIResponse class if we're
+            # returning the raw response, or if we're not streaming SSE, as if we're streaming
+            # SSE then `cast_to` doesn't actively reflect the type we need to parse into
+            and (not stream or bool(response.request.headers.get(RAW_RESPONSE_HEADER)))
+        ):
             if not issubclass(origin, AsyncAPIResponse):
                 raise TypeError(f"API Response types must subclass {AsyncAPIResponse}; Received {origin}")
 

runwayml/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "runwayml"
-__version__ = "3.4.0"  # x-release-please-version
+__version__ = "3.6.0"  # x-release-please-version

runwayml/lib/polling.py

@@ -0,0 +1,127 @@
+import time
+import random
+from typing import TYPE_CHECKING, Type, Union, TypeVar, cast
+from typing_extensions import ParamSpec
+
+import anyio
+
+from .._models import BaseModel
+from ..types.task_retrieve_response import TaskRetrieveResponse
+
+if TYPE_CHECKING:
+    from .._client import RunwayML, AsyncRunwayML
+
+P = ParamSpec("P")
+T = TypeVar("T")
+
+POLL_TIME = 6
+POLL_JITTER = 3
+
+
+class AwaitableTaskResponseMixin:
+    def wait_for_task_output(self, timeout: Union[float, None] = 60 * 10) -> TaskRetrieveResponse:  # type: ignore[empty-body]
+        """
+        When called, this will block until the task is complete.
+
+        If the task fails or is cancelled, a `TaskFailedError` will be raised.
+
+        Args:
+          timeout: The maximum amount of time to wait for the task to complete in seconds. If not
+              specified, the default timeout is 10 minutes. Will raise a `TaskTimeoutError` if the
+              task does not complete within the timeout.
+
+        Returns:
+          The task details, equivalent to calling `client.tasks.retrieve(task_id)`.
+        """
+        ...
+
+
+class NewTaskCreatedResponse(AwaitableTaskResponseMixin, BaseModel):
+    id: str
+
+
+class AwaitableTaskRetrieveResponse(AwaitableTaskResponseMixin, TaskRetrieveResponse):
+    pass
+
+
+class AsyncAwaitableTaskResponseMixin:
+    async def wait_for_task_output(self, timeout: Union[float, None] = 60 * 10) -> TaskRetrieveResponse:  # type: ignore[empty-body]
+        """
+        When called, this will wait until the task is complete.
+
+        If the task fails or is cancelled, a `TaskFailedError` will be raised.
+
+        Args:
+          timeout: The maximum amount of time to wait for the task to complete in seconds. If not
+              specified, the default timeout is 10 minutes. Will raise a `TaskTimeoutError` if the
+              task does not complete within the timeout. Setting this to `None` will wait
+              indefinitely (disabling the timeout).
+
+        Returns:
+          The task details, equivalent to awaiting `client.tasks.retrieve(task_id)`.
+        """
+        ...
+
+
+class AsyncNewTaskCreatedResponse(AsyncAwaitableTaskResponseMixin, BaseModel):
+    id: str
+
+
+class AsyncAwaitableTaskRetrieveResponse(AsyncAwaitableTaskResponseMixin, TaskRetrieveResponse):
+    pass
+
+
+def create_waitable_resource(base_class: Type[T], client: "RunwayML") -> Type[NewTaskCreatedResponse]:
+    class WithClient(base_class):  # type: ignore[valid-type,misc]
+        id: str
+
+        def wait_for_task_output(self, timeout: Union[float, None] = 60 * 10) -> TaskRetrieveResponse:
+            start_time = time.time()
+            while True:
+                time.sleep(POLL_TIME + random.random() * POLL_JITTER - POLL_JITTER / 2)
+                task_details = client.tasks.retrieve(self.id)
+                if task_details.status == "SUCCEEDED":
+                    return task_details
+                if task_details.status == "FAILED":
+                    raise TaskFailedError(task_details)
+                if timeout is not None and time.time() - start_time > timeout:
+                    raise TaskTimeoutError(task_details)
+
+    WithClient.__name__ = base_class.__name__
+    WithClient.__qualname__ = base_class.__qualname__
+
+    return cast(Type[NewTaskCreatedResponse], WithClient)
+
+
+def create_async_waitable_resource(base_class: Type[T], client: "AsyncRunwayML") -> Type[AsyncNewTaskCreatedResponse]:
+    class WithClient(base_class):  # type: ignore[valid-type,misc]
+        id: str
+
+        async def wait_for_task_output(self, timeout: Union[float, None] = 60 * 10) -> TaskRetrieveResponse:
+            start_time = anyio.current_time()
+            while True:
+                await anyio.sleep(POLL_TIME + random.random() * POLL_JITTER - POLL_JITTER / 2)
+                task_details = await client.tasks.retrieve(self.id)
+                if task_details.status == "SUCCEEDED":
+                    return task_details
+                if task_details.status == "FAILED" or task_details.status == "CANCELLED":
+                    raise TaskFailedError(task_details)
+                if timeout is not None and anyio.current_time() - start_time > timeout:
+                    raise TaskTimeoutError(task_details)
+
+    WithClient.__name__ = base_class.__name__
+    WithClient.__qualname__ = base_class.__qualname__
+
+    return cast(Type[AsyncNewTaskCreatedResponse], WithClient)
+
+
+class TaskFailedError(Exception):
+    def __init__(self, task_details: TaskRetrieveResponse):
+        self.task_details = task_details
+        super().__init__(f"Task failed")
+
+
+class TaskTimeoutError(Exception):
+    def __init__(self, task_details: TaskRetrieveResponse):
+        self.task_details = task_details
+        super().__init__(f"Task timed out")

runwayml/resources/image_to_video.py

@@ -18,6 +18,12 @@ from .._response import (
     async_to_raw_response_wrapper,
     async_to_streamed_response_wrapper,
 )
+from ..lib.polling import (
+    NewTaskCreatedResponse,
+    AsyncNewTaskCreatedResponse,
+    create_waitable_resource,
+    create_async_waitable_resource,
+)
 from .._base_client import make_request_options
 from ..types.image_to_video_create_response import ImageToVideoCreateResponse
 
@@ -47,9 +53,10 @@ class ImageToVideoResource(SyncAPIResource):
     def create(
         self,
         *,
-        model: Literal["gen4_turbo", "gen3a_turbo"],
+        model: Literal["gen3a_turbo", "gen4_turbo"],
         prompt_image: Union[str, Iterable[image_to_video_create_params.PromptImagePromptImage]],
         ratio: Literal["1280:720", "720:1280", "1104:832", "832:1104", "960:960", "1584:672", "1280:768", "768:1280"],
+        content_moderation: image_to_video_create_params.ContentModeration | NotGiven = NOT_GIVEN,
         duration: Literal[5, 10] | NotGiven = NOT_GIVEN,
         prompt_text: str | NotGiven = NOT_GIVEN,
         seed: int | NotGiven = NOT_GIVEN,
@@ -59,7 +66,7 @@ class ImageToVideoResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> ImageToVideoCreateResponse:
+    ) -> NewTaskCreatedResponse:
         """
         This endpoint will start a new task to generate a video from an image prompt.
 
@@ -86,6 +93,8 @@ class ImageToVideoResource(SyncAPIResource):
               - `1280:768`
               - `768:1280`
 
+          content_moderation: Settings that affect the behavior of the content moderation system.
+
           duration: The number of seconds of duration for the output video.
 
           prompt_text: A non-empty string up to 1000 characters (measured in UTF-16 code units). This
@@ -110,6 +119,7 @@ class ImageToVideoResource(SyncAPIResource):
                     "model": model,
                     "prompt_image": prompt_image,
                     "ratio": ratio,
+                    "content_moderation": content_moderation,
                     "duration": duration,
                     "prompt_text": prompt_text,
                     "seed": seed,
@@ -119,7 +129,7 @@ class ImageToVideoResource(SyncAPIResource):
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=ImageToVideoCreateResponse,
+            cast_to=create_waitable_resource(ImageToVideoCreateResponse, self._client),
         )
 
 
@@ -146,9 +156,10 @@ class AsyncImageToVideoResource(AsyncAPIResource):
     async def create(
         self,
         *,
-        model: Literal["gen4_turbo", "gen3a_turbo"],
+        model: Literal["gen3a_turbo", "gen4_turbo"],
         prompt_image: Union[str, Iterable[image_to_video_create_params.PromptImagePromptImage]],
         ratio: Literal["1280:720", "720:1280", "1104:832", "832:1104", "960:960", "1584:672", "1280:768", "768:1280"],
+        content_moderation: image_to_video_create_params.ContentModeration | NotGiven = NOT_GIVEN,
         duration: Literal[5, 10] | NotGiven = NOT_GIVEN,
         prompt_text: str | NotGiven = NOT_GIVEN,
         seed: int | NotGiven = NOT_GIVEN,
@@ -158,7 +169,7 @@ class AsyncImageToVideoResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> ImageToVideoCreateResponse:
+    ) -> AsyncNewTaskCreatedResponse:
         """
         This endpoint will start a new task to generate a video from an image prompt.
 
@@ -185,6 +196,8 @@ class AsyncImageToVideoResource(AsyncAPIResource):
               - `1280:768`
               - `768:1280`
 
+          content_moderation: Settings that affect the behavior of the content moderation system.
+
           duration: The number of seconds of duration for the output video.
 
           prompt_text: A non-empty string up to 1000 characters (measured in UTF-16 code units). This
@@ -209,6 +222,7 @@ class AsyncImageToVideoResource(AsyncAPIResource):
                     "model": model,
                     "prompt_image": prompt_image,
                     "ratio": ratio,
+                    "content_moderation": content_moderation,
                     "duration": duration,
                     "prompt_text": prompt_text,
                     "seed": seed,
@@ -218,7 +232,7 @@ class AsyncImageToVideoResource(AsyncAPIResource):
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=ImageToVideoCreateResponse,
+            cast_to=create_async_waitable_resource(ImageToVideoCreateResponse, self._client),
         )
 
 

runwayml/resources/tasks.py

@@ -2,6 +2,8 @@
 
 from __future__ import annotations
 
+from typing import cast
+
 import httpx
 
 from .._types import NOT_GIVEN, Body, Query, Headers, NoneType, NotGiven
@@ -13,6 +15,12 @@ from .._response import (
     async_to_raw_response_wrapper,
     async_to_streamed_response_wrapper,
 )
+from ..lib.polling import (
+    AwaitableTaskRetrieveResponse,
+    AsyncAwaitableTaskRetrieveResponse,
+    create_waitable_resource,
+    create_async_waitable_resource,
+)
 from .._base_client import make_request_options
 from ..types.task_retrieve_response import TaskRetrieveResponse
 
@@ -49,7 +57,7 @@ class TasksResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> TaskRetrieveResponse:
+    ) -> AwaitableTaskRetrieveResponse:
         """Return details about a task.
 
         Consumers of this API should not expect updates
@@ -71,7 +79,9 @@ class TasksResource(SyncAPIResource):
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=TaskRetrieveResponse,
+            cast_to=cast(
+                type[AwaitableTaskRetrieveResponse], create_waitable_resource(TaskRetrieveResponse, self._client)
+            ),
         )
 
     def delete(
@@ -144,7 +154,7 @@ class AsyncTasksResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> TaskRetrieveResponse:
+    ) -> AsyncAwaitableTaskRetrieveResponse:
         """Return details about a task.
 
         Consumers of this API should not expect updates
@@ -166,7 +176,10 @@ class AsyncTasksResource(AsyncAPIResource):
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=TaskRetrieveResponse,
+            cast_to=cast(
+                type[AsyncAwaitableTaskRetrieveResponse],
+                create_async_waitable_resource(TaskRetrieveResponse, self._client),
+            ),
         )
 
     async def delete(

runwayml/resources/text_to_image.py

@@ -18,6 +18,12 @@ from .._response import (
     async_to_raw_response_wrapper,
     async_to_streamed_response_wrapper,
 )
+from ..lib.polling import (
+    NewTaskCreatedResponse,
+    AsyncNewTaskCreatedResponse,
+    create_waitable_resource,
+    create_async_waitable_resource,
+)
 from .._base_client import make_request_options
 from ..types.text_to_image_create_response import TextToImageCreateResponse
 
@@ -76,7 +82,7 @@ class TextToImageResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> TextToImageCreateResponse:
+    ) -> NewTaskCreatedResponse:
         """
         This endpoint will start a new task to generate images from text.
 
@@ -121,7 +127,7 @@ class TextToImageResource(SyncAPIResource):
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=TextToImageCreateResponse,
+            cast_to=create_waitable_resource(TextToImageCreateResponse, self._client),
         )
 
 
@@ -177,7 +183,7 @@ class AsyncTextToImageResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> TextToImageCreateResponse:
+    ) -> AsyncNewTaskCreatedResponse:
         """
         This endpoint will start a new task to generate images from text.
 
@@ -222,7 +228,7 @@ class AsyncTextToImageResource(AsyncAPIResource):
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=TextToImageCreateResponse,
+            cast_to=create_async_waitable_resource(TextToImageCreateResponse, self._client),
         )
 
 

runwayml/resources/video_upscale.py

@@ -17,6 +17,12 @@ from .._response import (
     async_to_raw_response_wrapper,
     async_to_streamed_response_wrapper,
 )
+from ..lib.polling import (
+    NewTaskCreatedResponse,
+    AsyncNewTaskCreatedResponse,
+    create_waitable_resource,
+    create_async_waitable_resource,
+)
 from .._base_client import make_request_options
 from ..types.video_upscale_create_response import VideoUpscaleCreateResponse
 
@@ -54,7 +60,7 @@ class VideoUpscaleResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> VideoUpscaleCreateResponse:
+    ) -> NewTaskCreatedResponse:
         """This endpoint will start a new task to upscale a video.
 
         Videos will be upscaled
@@ -87,7 +93,7 @@ class VideoUpscaleResource(SyncAPIResource):
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=VideoUpscaleCreateResponse,
+            cast_to=create_waitable_resource(VideoUpscaleCreateResponse, self._client),
         )
 
 
@@ -122,7 +128,7 @@ class AsyncVideoUpscaleResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> VideoUpscaleCreateResponse:
+    ) -> AsyncNewTaskCreatedResponse:
         """This endpoint will start a new task to upscale a video.
 
         Videos will be upscaled
@@ -155,7 +161,7 @@ class AsyncVideoUpscaleResource(AsyncAPIResource):
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=VideoUpscaleCreateResponse,
+            cast_to=create_async_waitable_resource(VideoUpscaleCreateResponse, self._client),
         )
 
 

runwayml/types/image_to_video_create_params.py

@@ -7,11 +7,11 @@ from typing_extensions import Literal, Required, Annotated, TypedDict
 
 from .._utils import PropertyInfo
 
-__all__ = ["ImageToVideoCreateParams", "PromptImagePromptImage"]
+__all__ = ["ImageToVideoCreateParams", "PromptImagePromptImage", "ContentModeration"]
 
 
 class ImageToVideoCreateParams(TypedDict, total=False):
-    model: Required[Literal["gen4_turbo", "gen3a_turbo"]]
+    model: Required[Literal["gen3a_turbo", "gen4_turbo"]]
     """The model variant to use."""
 
     prompt_image: Required[Annotated[Union[str, Iterable[PromptImagePromptImage]], PropertyInfo(alias="promptImage")]]
@@ -41,6 +41,9 @@ class ImageToVideoCreateParams(TypedDict, total=False):
     - `768:1280`
     """
 
+    content_moderation: Annotated[ContentModeration, PropertyInfo(alias="contentModeration")]
+    """Settings that affect the behavior of the content moderation system."""
+
     duration: Literal[5, 10]
     """The number of seconds of duration for the output video."""
 
@@ -74,3 +77,11 @@ class PromptImagePromptImage(TypedDict, total=False):
 
     See [our docs](/assets/inputs#images) on image inputs for more information.
     """
+
+
+class ContentModeration(TypedDict, total=False):
+    public_figure_threshold: Annotated[Literal["auto", "low"], PropertyInfo(alias="publicFigureThreshold")]
+    """
+    When set to `low`, the content moderation system will be less strict about
+    preventing generations that include recognizable public figures.
+    """

{runwayml-3.4.0.dist-info → runwayml-3.6.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: runwayml
-Version: 3.4.0
+Version: 3.6.0
 Summary: The official Python library for the runwayml API
 Project-URL: Homepage, https://github.com/runwayml/sdk-python
 Project-URL: Repository, https://github.com/runwayml/sdk-python
@@ -27,11 +27,14 @@ Requires-Dist: httpx<1,>=0.23.0
 Requires-Dist: pydantic<3,>=1.9.0
 Requires-Dist: sniffio
 Requires-Dist: typing-extensions<5,>=4.10
+Provides-Extra: aiohttp
+Requires-Dist: aiohttp; extra == 'aiohttp'
+Requires-Dist: httpx-aiohttp>=0.1.6; extra == 'aiohttp'
 Description-Content-Type: text/markdown
 
 # RunwayML Python API library
 
-[![PyPI version](https://img.shields.io/pypi/v/runwayml.svg)](https://pypi.org/project/runwayml/)
+[![PyPI version](https://github.com/runwayml/sdk-python/tree/main/<https://img.shields.io/pypi/v/runwayml.svg?label=pypi%20(stable)>)](https://pypi.org/project/runwayml/)
 
 The RunwayML Python library provides convenient access to the RunwayML REST API from any Python 3.8+
 application. The library includes type definitions for all request params and response fields,
@@ -105,6 +108,43 @@ asyncio.run(main())
 
 Functionality between the synchronous and asynchronous clients is otherwise identical.
 
+### With aiohttp
+
+By default, the async client uses `httpx` for HTTP requests. However, for improved concurrency performance you may also use `aiohttp` as the HTTP backend.
+
+You can enable this by installing `aiohttp`:
+
+```sh
+# install from PyPI
+pip install runwayml[aiohttp]
+```
+
+Then you can enable it by instantiating the client with `http_client=DefaultAioHttpClient()`:
+
+```python
+import os
+import asyncio
+from runwayml import DefaultAioHttpClient
+from runwayml import AsyncRunwayML
+
+
+async def main() -> None:
+    async with AsyncRunwayML(
+        api_key=os.environ.get("RUNWAYML_API_SECRET"),  # This is the default and can be omitted
+        http_client=DefaultAioHttpClient(),
+    ) as client:
+        image_to_video = await client.image_to_video.create(
+            model="gen4_turbo",
+            prompt_image="https://example.com/assets/bunny.jpg",
+            ratio="1280:720",
+            prompt_text="The bunny is eating a carrot",
+        )
+        print(image_to_video.id)
+
+
+asyncio.run(main())
+```
+
 ## Using types
 
 Nested request parameters are [TypedDicts](https://docs.python.org/3/library/typing.html#typing.TypedDict). Responses are [Pydantic models](https://docs.pydantic.dev) which also provide helper methods for things like:
@@ -206,7 +246,7 @@ client.with_options(max_retries=5).image_to_video.create(
 ### Timeouts
 
 By default requests time out after 1 minute. You can configure this with a `timeout` option,
-which accepts a float or an [`httpx.Timeout`](https://www.python-httpx.org/advanced/#fine-tuning-the-configuration) object:
+which accepts a float or an [`httpx.Timeout`](https://www.python-httpx.org/advanced/timeouts/#fine-tuning-the-configuration) object:
 
 ```python
 from runwayml import RunwayML

{runwayml-3.4.0.dist-info → runwayml-3.6.0.dist-info}/RECORD

@@ -1,5 +1,5 @@
-runwayml/__init__.py,sha256=w7Il_Fc71HY9Ebs62Q5VLcsCQGraefXwcOmtzeg4r5I,2587
-runwayml/_base_client.py,sha256=C7nXQufaETXu-KXQeQtb6h6lEMCA-xWQUKWlIh9x0Ro,65094
+runwayml/__init__.py,sha256=tr-n2Y4sH_wBv8t2F_jk7ku_rLT2erU3j61ONZJWUVs,2743
+runwayml/_base_client.py,sha256=FH5ueSL8_ijbhXlcd6FG98sy_IMnFsAhVkBkCcv4ZjI,66717
 runwayml/_client.py,sha256=tEooz-jH6JGowMQwrTZE7CKcyqpILEHKfSFf7OevoIU,18513
 runwayml/_compat.py,sha256=VWemUKbj6DDkQ-O4baSpHVLJafotzeXmCQGJugfVTIw,6580
 runwayml/_constants.py,sha256=S14PFzyN9-I31wiV7SmIlL5Ga0MLHxdvegInGdXH7tM,462
@@ -11,7 +11,7 @@ runwayml/_resource.py,sha256=BF-j3xY5eRTKmuTxg8eDhLtLP4MLB1phDh_B6BKipKA,1112
 runwayml/_response.py,sha256=WxjSEXX-j01ZhlSxYyMCVSEKxo20pgy40RA7iyski8M,28800
 runwayml/_streaming.py,sha256=NSVuAgknVQWU1cgZEjQn01IdZKKynb5rOeYp5Lo-OEQ,10108
 runwayml/_types.py,sha256=YL6SdhLq5SHlT644GjzDwOJ_Slyr8QDRCoacOp4trhI,6199
-runwayml/_version.py,sha256=ewweQm0FzO6J6GFWJ5sAqxHCBDqFKEIYiPzmmxSjCF8,160
+runwayml/_version.py,sha256=cTRo7ZS2XlFsYQnDltFU4mR3P69yxWhnj5GXcoaXxfM,160
 runwayml/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 runwayml/_utils/__init__.py,sha256=PNZ_QJuzZEgyYXqkO1HVhGkj5IU9bglVUcw7H-Knjzw,2062
 runwayml/_utils/_logs.py,sha256=ZfS5W59hdqEBVV86lNrk28PhvUxtHOzs9JqiLhSu0pI,780
@@ -24,14 +24,15 @@ runwayml/_utils/_transform.py,sha256=n7kskEWz6o__aoNvhFoGVyDoalNe6mJwp-g7BWkdj88
 runwayml/_utils/_typing.py,sha256=D0DbbNu8GnYQTSICnTSHDGsYXj8TcAKyhejb0XcnjtY,4602
 runwayml/_utils/_utils.py,sha256=ts4CiiuNpFiGB6YMdkQRh2SZvYvsl7mAF-JWHCcLDf4,12312
 runwayml/lib/.keep,sha256=wuNrz-5SXo3jJaJOJgz4vFHM41YH_g20F5cRQo0vLes,224
+runwayml/lib/polling.py,sha256=4fF0gP-h4iR0jvxWifsqtR1iH9vRoKEgGykkaZNT9Ek,4743
 runwayml/resources/__init__.py,sha256=5XJIeBB9D2GqQU-9Ub5AuzRVgLYp1QdLr8Fjh6DCDxM,2643
-runwayml/resources/image_to_video.py,sha256=dS2yTuOx10xSUAhAZ0FmuAEDXqo-WLyWe41aVovR5yo,10120
+runwayml/resources/image_to_video.py,sha256=O6YbnD7QEE_YK5UeRDq8RzWwiuS5nTQSAkCl9RvZe74,10880
 runwayml/resources/organization.py,sha256=XBg5nhkycPU3rllRvf9aaeHuZNtzGDKHlLPrPqDCAsw,5419
-runwayml/resources/tasks.py,sha256=-VT3qetYcaqn4FskekxhN_fCTozMl1GqxGpGwxV8M60,9673
-runwayml/resources/text_to_image.py,sha256=E-Fbu2fL96QFbp_j_hz7fw9iQTQwlqjpzH32K4HwoRg,9958
-runwayml/resources/video_upscale.py,sha256=OWr-oCJ4ovhw6YLELsCwIvGLRnRKj9E3STB5ofMStbw,7451
+runwayml/resources/tasks.py,sha256=mjdBqB1G4u9v3xB_9yn6aIdvsDmawxSNcTENkMpKSms,10146
+runwayml/resources/text_to_image.py,sha256=OJ9oD1Fc5NBGqci6Ox_-M9lFvsYG31fSwSzsr0pwPak,10200
+runwayml/resources/video_upscale.py,sha256=8Mz_g5Swxmgp14jfcfexurUYpPi73q_iU-9D1jOddt0,7691
 runwayml/types/__init__.py,sha256=zXevA88F25dbdsjgpvdlKlvELiv9aamz1hS3xcLbe40,889
-runwayml/types/image_to_video_create_params.py,sha256=TgoNwKkz_PK_sFBeATqMFkXpBhdx8DSZTLA6hLbMhFM,2352
+runwayml/types/image_to_video_create_params.py,sha256=6M_xJRx0ws8nQ0a3k3jEICDm-WXJUG9j-j1UIxAAg-s,2869
 runwayml/types/image_to_video_create_response.py,sha256=WvZHbZxxJz8KerRNogzb1RYBrxa1x0iCPDi9-LCpHyE,345
 runwayml/types/organization_retrieve_response.py,sha256=_7vny0YNmNmREe8jp58ldJbXDdzNAGzDT8V0kK9pbsA,4385
 runwayml/types/task_retrieve_response.py,sha256=v8y2bLxsW6srzScW-B3Akv72q_PI_NQmduGrGRQMHds,2139
@@ -39,7 +40,7 @@ runwayml/types/text_to_image_create_params.py,sha256=I8Dr4UG6VnciQ87zN6qp03FKwlQ
 runwayml/types/text_to_image_create_response.py,sha256=koMzUg82dYFQPp77wln3UR1z8WO2sHCNMWGgoQ9Id8M,262
 runwayml/types/video_upscale_create_params.py,sha256=Ta3BNQy9aeTUBU5Ui-CMJtF32HeNRqbNpqjAAOKXyks,743
 runwayml/types/video_upscale_create_response.py,sha256=zf-79HbJa68dUHltBiZjVtnW_U6HUI-htmkTm5URBSU,264
-runwayml-3.4.0.dist-info/METADATA,sha256=KQJ79S4lKQj3iKWmYi4-V__ryR9P89f9oqA5QwHBXDM,13986
-runwayml-3.4.0.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
-runwayml-3.4.0.dist-info/licenses/LICENSE,sha256=baeFj6izBWIm6A5_7N3-WAsy_VYpDF05Dd4zS1zsfZI,11338
-runwayml-3.4.0.dist-info/RECORD,,
+runwayml-3.6.0.dist-info/METADATA,sha256=bR7BWijWXnNF3KexxAaHUaeUDjSgxAztRyUSEmFF19w,15209
+runwayml-3.6.0.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
+runwayml-3.6.0.dist-info/licenses/LICENSE,sha256=baeFj6izBWIm6A5_7N3-WAsy_VYpDF05Dd4zS1zsfZI,11338
+runwayml-3.6.0.dist-info/RECORD,,