runwayml 3.0.6__tar.gz → 3.2.0__tar.gz

runwayml-3.2.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "3.2.0"
+}

{runwayml-3.0.6 → runwayml-3.2.0}/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 3.2.0 (2025-05-29)
+
+Full Changelog: [v3.1.0...v3.2.0](https://github.com/runwayml/sdk-python/compare/v3.1.0...v3.2.0)
+
+### Features
+
+* **api:** Add 720p t2i ratios ([b722686](https://github.com/runwayml/sdk-python/commit/b722686c0e4fa03768ce61380c77fe04c93cfc90))
+
+
+### Chores
+
+* **docs:** grammar improvements ([fbf2481](https://github.com/runwayml/sdk-python/commit/fbf2481cd6da85fb5ce2e6fea66cf8f1233a8e2e))
+
+## 3.1.0 (2025-05-16)
+
+Full Changelog: [v3.0.6...v3.1.0](https://github.com/runwayml/sdk-python/compare/v3.0.6...v3.1.0)
+
+### Features
+
+* **api:** Gen-4 Image (text-to-image) support ([8adcf96](https://github.com/runwayml/sdk-python/commit/8adcf96fa228c8694272175317587bf3c7b9e2fe))
+
+
+### Chores
+
+* **ci:** fix installation instructions ([a04350d](https://github.com/runwayml/sdk-python/commit/a04350dd31c9551695c1856a7f6d700d69960807))
+
 ## 3.0.6 (2025-05-15)
 
 Full Changelog: [v3.0.5...v3.0.6](https://github.com/runwayml/sdk-python/compare/v3.0.5...v3.0.6)

{runwayml-3.0.6 → runwayml-3.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: runwayml
-Version: 3.0.6
+Version: 3.2.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
@@ -114,6 +114,24 @@ Nested request parameters are [TypedDicts](https://docs.python.org/3/library/typ
 
 Typed requests and responses provide autocomplete and documentation within your editor. If you would like to see type errors in VS Code to help catch bugs earlier, set `python.analysis.typeCheckingMode` to `basic`.
 
+## Nested params
+
+Nested parameters are dictionaries, typed using `TypedDict`, for example:
+
+```python
+from runwayml import RunwayML
+
+client = RunwayML()
+
+text_to_image = client.text_to_image.create(
+    model="gen4_image",
+    prompt_text="promptText",
+    ratio="1920:1080",
+    content_moderation={"public_figure_threshold": "auto"},
+)
+print(text_to_image.content_moderation)
+```
+
 ## Handling errors
 
 When the library is unable to connect to the API (for example, due to network connection problems or a timeout), a subclass of `runwayml.APIConnectionError` is raised.

{runwayml-3.0.6 → runwayml-3.2.0}/README.md

@@ -83,6 +83,24 @@ Nested request parameters are [TypedDicts](https://docs.python.org/3/library/typ
 
 Typed requests and responses provide autocomplete and documentation within your editor. If you would like to see type errors in VS Code to help catch bugs earlier, set `python.analysis.typeCheckingMode` to `basic`.
 
+## Nested params
+
+Nested parameters are dictionaries, typed using `TypedDict`, for example:
+
+```python
+from runwayml import RunwayML
+
+client = RunwayML()
+
+text_to_image = client.text_to_image.create(
+    model="gen4_image",
+    prompt_text="promptText",
+    ratio="1920:1080",
+    content_moderation={"public_figure_threshold": "auto"},
+)
+print(text_to_image.content_moderation)
+```
+
 ## Handling errors
 
 When the library is unable to connect to the API (for example, due to network connection problems or a timeout), a subclass of `runwayml.APIConnectionError` is raised.

{runwayml-3.0.6 → runwayml-3.2.0}/SECURITY.md

@@ -16,11 +16,11 @@ before making any information public.
 ## Reporting Non-SDK Related Security Issues
 
 If you encounter security issues that are not directly related to SDKs but pertain to the services
-or products provided by RunwayML please follow the respective company's security reporting guidelines.
+or products provided by RunwayML, please follow the respective company's security reporting guidelines.
 
 ### RunwayML Terms and Policies
 
-Please contact dev-feedback@runwayml.com for any questions or concerns regarding security of our services.
+Please contact dev-feedback@runwayml.com for any questions or concerns regarding the security of our services.
 
 ---
 

{runwayml-3.0.6 → runwayml-3.2.0}/api.md

@@ -23,6 +23,18 @@ Methods:
 
 - <code title="post /v1/image_to_video">client.image_to_video.<a href="./src/runwayml/resources/image_to_video.py">create</a>(\*\*<a href="src/runwayml/types/image_to_video_create_params.py">params</a>) -> <a href="./src/runwayml/types/image_to_video_create_response.py">ImageToVideoCreateResponse</a></code>
 
+# TextToImage
+
+Types:
+
+```python
+from runwayml.types import TextToImageCreateResponse
+```
+
+Methods:
+
+- <code title="post /v1/text_to_image">client.text_to_image.<a href="./src/runwayml/resources/text_to_image.py">create</a>(\*\*<a href="src/runwayml/types/text_to_image_create_params.py">params</a>) -> <a href="./src/runwayml/types/text_to_image_create_response.py">TextToImageCreateResponse</a></code>
+
 # Organization
 
 Types:

{runwayml-3.0.6 → runwayml-3.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "runwayml"
-version = "3.0.6"
+version = "3.2.0"
 description = "The official Python library for the runwayml API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{runwayml-3.0.6 → runwayml-3.2.0}/src/runwayml/_client.py

@@ -21,7 +21,7 @@ from ._types import (
 )
 from ._utils import is_given, get_async_library
 from ._version import __version__
-from .resources import tasks, organization, image_to_video
+from .resources import tasks, organization, text_to_image, image_to_video
 from ._streaming import Stream as Stream, AsyncStream as AsyncStream
 from ._exceptions import RunwayMLError, APIStatusError
 from ._base_client import (
@@ -45,6 +45,7 @@ __all__ = [
 class RunwayML(SyncAPIClient):
     tasks: tasks.TasksResource
     image_to_video: image_to_video.ImageToVideoResource
+    text_to_image: text_to_image.TextToImageResource
     organization: organization.OrganizationResource
     with_raw_response: RunwayMLWithRawResponse
     with_streaming_response: RunwayMLWithStreamedResponse
@@ -111,6 +112,7 @@ class RunwayML(SyncAPIClient):
 
         self.tasks = tasks.TasksResource(self)
         self.image_to_video = image_to_video.ImageToVideoResource(self)
+        self.text_to_image = text_to_image.TextToImageResource(self)
         self.organization = organization.OrganizationResource(self)
         self.with_raw_response = RunwayMLWithRawResponse(self)
         self.with_streaming_response = RunwayMLWithStreamedResponse(self)
@@ -226,6 +228,7 @@ class RunwayML(SyncAPIClient):
 class AsyncRunwayML(AsyncAPIClient):
     tasks: tasks.AsyncTasksResource
     image_to_video: image_to_video.AsyncImageToVideoResource
+    text_to_image: text_to_image.AsyncTextToImageResource
     organization: organization.AsyncOrganizationResource
     with_raw_response: AsyncRunwayMLWithRawResponse
     with_streaming_response: AsyncRunwayMLWithStreamedResponse
@@ -292,6 +295,7 @@ class AsyncRunwayML(AsyncAPIClient):
 
         self.tasks = tasks.AsyncTasksResource(self)
         self.image_to_video = image_to_video.AsyncImageToVideoResource(self)
+        self.text_to_image = text_to_image.AsyncTextToImageResource(self)
         self.organization = organization.AsyncOrganizationResource(self)
         self.with_raw_response = AsyncRunwayMLWithRawResponse(self)
         self.with_streaming_response = AsyncRunwayMLWithStreamedResponse(self)
@@ -408,6 +412,7 @@ class RunwayMLWithRawResponse:
     def __init__(self, client: RunwayML) -> None:
         self.tasks = tasks.TasksResourceWithRawResponse(client.tasks)
         self.image_to_video = image_to_video.ImageToVideoResourceWithRawResponse(client.image_to_video)
+        self.text_to_image = text_to_image.TextToImageResourceWithRawResponse(client.text_to_image)
         self.organization = organization.OrganizationResourceWithRawResponse(client.organization)
 
 
@@ -415,6 +420,7 @@ class AsyncRunwayMLWithRawResponse:
     def __init__(self, client: AsyncRunwayML) -> None:
         self.tasks = tasks.AsyncTasksResourceWithRawResponse(client.tasks)
         self.image_to_video = image_to_video.AsyncImageToVideoResourceWithRawResponse(client.image_to_video)
+        self.text_to_image = text_to_image.AsyncTextToImageResourceWithRawResponse(client.text_to_image)
         self.organization = organization.AsyncOrganizationResourceWithRawResponse(client.organization)
 
 
@@ -422,6 +428,7 @@ class RunwayMLWithStreamedResponse:
     def __init__(self, client: RunwayML) -> None:
         self.tasks = tasks.TasksResourceWithStreamingResponse(client.tasks)
         self.image_to_video = image_to_video.ImageToVideoResourceWithStreamingResponse(client.image_to_video)
+        self.text_to_image = text_to_image.TextToImageResourceWithStreamingResponse(client.text_to_image)
         self.organization = organization.OrganizationResourceWithStreamingResponse(client.organization)
 
 
@@ -429,6 +436,7 @@ class AsyncRunwayMLWithStreamedResponse:
     def __init__(self, client: AsyncRunwayML) -> None:
         self.tasks = tasks.AsyncTasksResourceWithStreamingResponse(client.tasks)
         self.image_to_video = image_to_video.AsyncImageToVideoResourceWithStreamingResponse(client.image_to_video)
+        self.text_to_image = text_to_image.AsyncTextToImageResourceWithStreamingResponse(client.text_to_image)
         self.organization = organization.AsyncOrganizationResourceWithStreamingResponse(client.organization)
 
 

{runwayml-3.0.6 → runwayml-3.2.0}/src/runwayml/_version.py

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

{runwayml-3.0.6 → runwayml-3.2.0}/src/runwayml/resources/__init__.py

@@ -16,6 +16,14 @@ from .organization import (
     OrganizationResourceWithStreamingResponse,
     AsyncOrganizationResourceWithStreamingResponse,
 )
+from .text_to_image import (
+    TextToImageResource,
+    AsyncTextToImageResource,
+    TextToImageResourceWithRawResponse,
+    AsyncTextToImageResourceWithRawResponse,
+    TextToImageResourceWithStreamingResponse,
+    AsyncTextToImageResourceWithStreamingResponse,
+)
 from .image_to_video import (
     ImageToVideoResource,
     AsyncImageToVideoResource,
@@ -38,6 +46,12 @@ __all__ = [
     "AsyncImageToVideoResourceWithRawResponse",
     "ImageToVideoResourceWithStreamingResponse",
     "AsyncImageToVideoResourceWithStreamingResponse",
+    "TextToImageResource",
+    "AsyncTextToImageResource",
+    "TextToImageResourceWithRawResponse",
+    "AsyncTextToImageResourceWithRawResponse",
+    "TextToImageResourceWithStreamingResponse",
+    "AsyncTextToImageResourceWithStreamingResponse",
     "OrganizationResource",
     "AsyncOrganizationResource",
     "OrganizationResourceWithRawResponse",

{runwayml-3.0.6 → runwayml-3.2.0}/src/runwayml/resources/image_to_video.py

@@ -88,9 +88,8 @@ class ImageToVideoResource(SyncAPIResource):
 
           duration: The number of seconds of duration for the output video.
 
-          prompt_text: A non-empty string up to 1000 UTF-16 code points in length (that is,
-              `promptText.length === 1000` in JavaScript). This should describe in detail what
-              should appear in the output.
+          prompt_text: A non-empty string up to 1000 characters (measured in UTF-16 code units). This
+              should describe in detail what should appear in the output.
 
           seed: If unspecified, a random number is chosen. Varying the seed integer is a way to
               get different results for the same other request parameters. Using the same seed
@@ -188,9 +187,8 @@ class AsyncImageToVideoResource(AsyncAPIResource):
 
           duration: The number of seconds of duration for the output video.
 
-          prompt_text: A non-empty string up to 1000 UTF-16 code points in length (that is,
-              `promptText.length === 1000` in JavaScript). This should describe in detail what
-              should appear in the output.
+          prompt_text: A non-empty string up to 1000 characters (measured in UTF-16 code units). This
+              should describe in detail what should appear in the output.
 
           seed: If unspecified, a random number is chosen. Varying the seed integer is a way to
               get different results for the same other request parameters. Using the same seed

runwayml-3.2.0/src/runwayml/resources/text_to_image.py

@@ -0,0 +1,262 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Iterable
+from typing_extensions import Literal
+
+import httpx
+
+from ..types import text_to_image_create_params
+from .._types import NOT_GIVEN, Body, Query, Headers, NotGiven
+from .._utils import maybe_transform, async_maybe_transform
+from .._compat import cached_property
+from .._resource import SyncAPIResource, AsyncAPIResource
+from .._response import (
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+    async_to_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
+)
+from .._base_client import make_request_options
+from ..types.text_to_image_create_response import TextToImageCreateResponse
+
+__all__ = ["TextToImageResource", "AsyncTextToImageResource"]
+
+
+class TextToImageResource(SyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> TextToImageResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/runwayml/sdk-python#accessing-raw-response-data-eg-headers
+        """
+        return TextToImageResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> TextToImageResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/runwayml/sdk-python#with_streaming_response
+        """
+        return TextToImageResourceWithStreamingResponse(self)
+
+    def create(
+        self,
+        *,
+        model: Literal["gen4_image"],
+        prompt_text: str,
+        ratio: Literal[
+            "1920:1080",
+            "1080:1920",
+            "1024:1024",
+            "1360:768",
+            "1080:1080",
+            "1168:880",
+            "1440:1080",
+            "1080:1440",
+            "1808:768",
+            "2112:912",
+            "1280:720",
+            "720:1280",
+            "720:720",
+            "960:720",
+            "720:960",
+            "1680:720",
+        ],
+        content_moderation: text_to_image_create_params.ContentModeration | NotGiven = NOT_GIVEN,
+        reference_images: Iterable[text_to_image_create_params.ReferenceImage] | NotGiven = NOT_GIVEN,
+        seed: int | NotGiven = NOT_GIVEN,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> TextToImageCreateResponse:
+        """
+        This endpoint will start a new task to generate images from text.
+
+        Args:
+          model: The model variant to use.
+
+          prompt_text: A non-empty string up to 1000 characters (measured in UTF-16 code units). This
+              should describe in detail what should appear in the output.
+
+          ratio: The resolution of the output image(s).
+
+          content_moderation: Settings that affect the behavior of the content moderation system.
+
+          reference_images: An array of images to be used as references for the generated image output. Up
+              to three reference images can be provided.
+
+          seed: If unspecified, a random number is chosen. Varying the seed integer is a way to
+              get different results for the same other request parameters. Using the same seed
+              integer for an identical request will produce similar results.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return self._post(
+            "/v1/text_to_image",
+            body=maybe_transform(
+                {
+                    "model": model,
+                    "prompt_text": prompt_text,
+                    "ratio": ratio,
+                    "content_moderation": content_moderation,
+                    "reference_images": reference_images,
+                    "seed": seed,
+                },
+                text_to_image_create_params.TextToImageCreateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=TextToImageCreateResponse,
+        )
+
+
+class AsyncTextToImageResource(AsyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AsyncTextToImageResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/runwayml/sdk-python#accessing-raw-response-data-eg-headers
+        """
+        return AsyncTextToImageResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncTextToImageResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/runwayml/sdk-python#with_streaming_response
+        """
+        return AsyncTextToImageResourceWithStreamingResponse(self)
+
+    async def create(
+        self,
+        *,
+        model: Literal["gen4_image"],
+        prompt_text: str,
+        ratio: Literal[
+            "1920:1080",
+            "1080:1920",
+            "1024:1024",
+            "1360:768",
+            "1080:1080",
+            "1168:880",
+            "1440:1080",
+            "1080:1440",
+            "1808:768",
+            "2112:912",
+            "1280:720",
+            "720:1280",
+            "720:720",
+            "960:720",
+            "720:960",
+            "1680:720",
+        ],
+        content_moderation: text_to_image_create_params.ContentModeration | NotGiven = NOT_GIVEN,
+        reference_images: Iterable[text_to_image_create_params.ReferenceImage] | NotGiven = NOT_GIVEN,
+        seed: int | NotGiven = NOT_GIVEN,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> TextToImageCreateResponse:
+        """
+        This endpoint will start a new task to generate images from text.
+
+        Args:
+          model: The model variant to use.
+
+          prompt_text: A non-empty string up to 1000 characters (measured in UTF-16 code units). This
+              should describe in detail what should appear in the output.
+
+          ratio: The resolution of the output image(s).
+
+          content_moderation: Settings that affect the behavior of the content moderation system.
+
+          reference_images: An array of images to be used as references for the generated image output. Up
+              to three reference images can be provided.
+
+          seed: If unspecified, a random number is chosen. Varying the seed integer is a way to
+              get different results for the same other request parameters. Using the same seed
+              integer for an identical request will produce similar results.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return await self._post(
+            "/v1/text_to_image",
+            body=await async_maybe_transform(
+                {
+                    "model": model,
+                    "prompt_text": prompt_text,
+                    "ratio": ratio,
+                    "content_moderation": content_moderation,
+                    "reference_images": reference_images,
+                    "seed": seed,
+                },
+                text_to_image_create_params.TextToImageCreateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=TextToImageCreateResponse,
+        )
+
+
+class TextToImageResourceWithRawResponse:
+    def __init__(self, text_to_image: TextToImageResource) -> None:
+        self._text_to_image = text_to_image
+
+        self.create = to_raw_response_wrapper(
+            text_to_image.create,
+        )
+
+
+class AsyncTextToImageResourceWithRawResponse:
+    def __init__(self, text_to_image: AsyncTextToImageResource) -> None:
+        self._text_to_image = text_to_image
+
+        self.create = async_to_raw_response_wrapper(
+            text_to_image.create,
+        )
+
+
+class TextToImageResourceWithStreamingResponse:
+    def __init__(self, text_to_image: TextToImageResource) -> None:
+        self._text_to_image = text_to_image
+
+        self.create = to_streamed_response_wrapper(
+            text_to_image.create,
+        )
+
+
+class AsyncTextToImageResourceWithStreamingResponse:
+    def __init__(self, text_to_image: AsyncTextToImageResource) -> None:
+        self._text_to_image = text_to_image
+
+        self.create = async_to_streamed_response_wrapper(
+            text_to_image.create,
+        )

{runwayml-3.0.6 → runwayml-3.2.0}/src/runwayml/types/__init__.py

@@ -3,6 +3,8 @@
 from __future__ import annotations
 
 from .task_retrieve_response import TaskRetrieveResponse as TaskRetrieveResponse
+from .text_to_image_create_params import TextToImageCreateParams as TextToImageCreateParams
 from .image_to_video_create_params import ImageToVideoCreateParams as ImageToVideoCreateParams
+from .text_to_image_create_response import TextToImageCreateResponse as TextToImageCreateResponse
 from .image_to_video_create_response import ImageToVideoCreateResponse as ImageToVideoCreateResponse
 from .organization_retrieve_response import OrganizationRetrieveResponse as OrganizationRetrieveResponse

{runwayml-3.0.6 → runwayml-3.2.0}/src/runwayml/types/image_to_video_create_params.py

@@ -45,10 +45,9 @@ class ImageToVideoCreateParams(TypedDict, total=False):
     """The number of seconds of duration for the output video."""
 
     prompt_text: Annotated[str, PropertyInfo(alias="promptText")]
-    """
-    A non-empty string up to 1000 UTF-16 code points in length (that is,
-    `promptText.length === 1000` in JavaScript). This should describe in detail what
-    should appear in the output.
+    """A non-empty string up to 1000 characters (measured in UTF-16 code units).
+
+    This should describe in detail what should appear in the output.
     """
 
     seed: int

{runwayml-3.0.6 → runwayml-3.2.0}/src/runwayml/types/organization_retrieve_response.py

@@ -11,10 +11,12 @@ __all__ = [
     "Tier",
     "TierModels",
     "TierModelsGen3aTurbo",
+    "TierModelsGen4Image",
     "TierModelsGen4Turbo",
     "Usage",
     "UsageModels",
     "UsageModelsGen3aTurbo",
+    "UsageModelsGen4Image",
     "UsageModelsGen4Turbo",
 ]
 
@@ -27,6 +29,14 @@ class TierModelsGen3aTurbo(BaseModel):
     """The maximum number of generations that can be created each day for this model."""
 
 
+class TierModelsGen4Image(BaseModel):
+    max_concurrent_generations: int = FieldInfo(alias="maxConcurrentGenerations")
+    """The maximum number of generations that can be run concurrently for this model."""
+
+    max_daily_generations: int = FieldInfo(alias="maxDailyGenerations")
+    """The maximum number of generations that can be created each day for this model."""
+
+
 class TierModelsGen4Turbo(BaseModel):
     max_concurrent_generations: int = FieldInfo(alias="maxConcurrentGenerations")
     """The maximum number of generations that can be run concurrently for this model."""
@@ -39,6 +49,9 @@ class TierModels(BaseModel):
     gen3a_turbo: Optional[TierModelsGen3aTurbo] = None
     """Limits associated with the gen3a_turbo model."""
 
+    gen4_image: Optional[TierModelsGen4Image] = None
+    """Limits associated with the gen4_image model."""
+
     gen4_turbo: Optional[TierModelsGen4Turbo] = None
     """Limits associated with the gen4_turbo model."""
 
@@ -56,6 +69,11 @@ class UsageModelsGen3aTurbo(BaseModel):
     """The number of generations that have been run for this model in the past day."""
 
 
+class UsageModelsGen4Image(BaseModel):
+    daily_generations: int = FieldInfo(alias="dailyGenerations")
+    """The number of generations that have been run for this model in the past day."""
+
+
 class UsageModelsGen4Turbo(BaseModel):
     daily_generations: int = FieldInfo(alias="dailyGenerations")
     """The number of generations that have been run for this model in the past day."""
@@ -65,6 +83,9 @@ class UsageModels(BaseModel):
     gen3a_turbo: Optional[UsageModelsGen3aTurbo] = None
     """Usage data for the gen3a_turbo model."""
 
+    gen4_image: Optional[UsageModelsGen4Image] = None
+    """Usage data for the gen4_image model."""
+
     gen4_turbo: Optional[UsageModelsGen4Turbo] = None
     """Usage data for the gen4_turbo model."""
 

runwayml-3.2.0/src/runwayml/types/text_to_image_create_params.py

@@ -0,0 +1,85 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Iterable
+from typing_extensions import Literal, Required, Annotated, TypedDict
+
+from .._utils import PropertyInfo
+
+__all__ = ["TextToImageCreateParams", "ContentModeration", "ReferenceImage"]
+
+
+class TextToImageCreateParams(TypedDict, total=False):
+    model: Required[Literal["gen4_image"]]
+    """The model variant to use."""
+
+    prompt_text: Required[Annotated[str, PropertyInfo(alias="promptText")]]
+    """A non-empty string up to 1000 characters (measured in UTF-16 code units).
+
+    This should describe in detail what should appear in the output.
+    """
+
+    ratio: Required[
+        Literal[
+            "1920:1080",
+            "1080:1920",
+            "1024:1024",
+            "1360:768",
+            "1080:1080",
+            "1168:880",
+            "1440:1080",
+            "1080:1440",
+            "1808:768",
+            "2112:912",
+            "1280:720",
+            "720:1280",
+            "720:720",
+            "960:720",
+            "720:960",
+            "1680:720",
+        ]
+    ]
+    """The resolution of the output image(s)."""
+
+    content_moderation: Annotated[ContentModeration, PropertyInfo(alias="contentModeration")]
+    """Settings that affect the behavior of the content moderation system."""
+
+    reference_images: Annotated[Iterable[ReferenceImage], PropertyInfo(alias="referenceImages")]
+    """An array of images to be used as references for the generated image output.
+
+    Up to three reference images can be provided.
+    """
+
+    seed: int
+    """If unspecified, a random number is chosen.
+
+    Varying the seed integer is a way to get different results for the same other
+    request parameters. Using the same seed integer for an identical request will
+    produce similar results.
+    """
+
+
+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.
+    """
+
+
+class ReferenceImage(TypedDict, total=False):
+    uri: Required[str]
+    """
+    A HTTPS URL or data URI containing an encoded image to be used as reference for
+    the generated output image. See [our docs](/assets/inputs#images) on image
+    inputs for more information.
+    """
+
+    tag: str
+    """A name used to refer to the image reference, from 3 to 16 characters in length.
+
+    Tags must be alphanumeric (plus underscores) and start with a letter. You can
+    refer to the reference image's tag in the prompt text with at-mention syntax:
+    `@tag`. Tags are case-sensitive.
+    """

runwayml-3.2.0/src/runwayml/types/text_to_image_create_response.py

@@ -0,0 +1,10 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .._models import BaseModel
+
+__all__ = ["TextToImageCreateResponse"]
+
+
+class TextToImageCreateResponse(BaseModel):
+    id: str
+    """The ID of the newly created task."""

runwayml-3.2.0/tests/api_resources/test_text_to_image.py

@@ -0,0 +1,130 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+import os
+from typing import Any, cast
+
+import pytest
+
+from runwayml import RunwayML, AsyncRunwayML
+from tests.utils import assert_matches_type
+from runwayml.types import TextToImageCreateResponse
+
+base_url = os.environ.get("TEST_API_BASE_URL", "http://127.0.0.1:4010")
+
+
+class TestTextToImage:
+    parametrize = pytest.mark.parametrize("client", [False, True], indirect=True, ids=["loose", "strict"])
+
+    @parametrize
+    def test_method_create(self, client: RunwayML) -> None:
+        text_to_image = client.text_to_image.create(
+            model="gen4_image",
+            prompt_text="promptText",
+            ratio="1920:1080",
+        )
+        assert_matches_type(TextToImageCreateResponse, text_to_image, path=["response"])
+
+    @parametrize
+    def test_method_create_with_all_params(self, client: RunwayML) -> None:
+        text_to_image = client.text_to_image.create(
+            model="gen4_image",
+            prompt_text="promptText",
+            ratio="1920:1080",
+            content_moderation={"public_figure_threshold": "auto"},
+            reference_images=[
+                {
+                    "uri": "https://example.com",
+                    "tag": "tag",
+                }
+            ],
+            seed=0,
+        )
+        assert_matches_type(TextToImageCreateResponse, text_to_image, path=["response"])
+
+    @parametrize
+    def test_raw_response_create(self, client: RunwayML) -> None:
+        response = client.text_to_image.with_raw_response.create(
+            model="gen4_image",
+            prompt_text="promptText",
+            ratio="1920:1080",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        text_to_image = response.parse()
+        assert_matches_type(TextToImageCreateResponse, text_to_image, path=["response"])
+
+    @parametrize
+    def test_streaming_response_create(self, client: RunwayML) -> None:
+        with client.text_to_image.with_streaming_response.create(
+            model="gen4_image",
+            prompt_text="promptText",
+            ratio="1920:1080",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            text_to_image = response.parse()
+            assert_matches_type(TextToImageCreateResponse, text_to_image, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
+
+class TestAsyncTextToImage:
+    parametrize = pytest.mark.parametrize("async_client", [False, True], indirect=True, ids=["loose", "strict"])
+
+    @parametrize
+    async def test_method_create(self, async_client: AsyncRunwayML) -> None:
+        text_to_image = await async_client.text_to_image.create(
+            model="gen4_image",
+            prompt_text="promptText",
+            ratio="1920:1080",
+        )
+        assert_matches_type(TextToImageCreateResponse, text_to_image, path=["response"])
+
+    @parametrize
+    async def test_method_create_with_all_params(self, async_client: AsyncRunwayML) -> None:
+        text_to_image = await async_client.text_to_image.create(
+            model="gen4_image",
+            prompt_text="promptText",
+            ratio="1920:1080",
+            content_moderation={"public_figure_threshold": "auto"},
+            reference_images=[
+                {
+                    "uri": "https://example.com",
+                    "tag": "tag",
+                }
+            ],
+            seed=0,
+        )
+        assert_matches_type(TextToImageCreateResponse, text_to_image, path=["response"])
+
+    @parametrize
+    async def test_raw_response_create(self, async_client: AsyncRunwayML) -> None:
+        response = await async_client.text_to_image.with_raw_response.create(
+            model="gen4_image",
+            prompt_text="promptText",
+            ratio="1920:1080",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        text_to_image = await response.parse()
+        assert_matches_type(TextToImageCreateResponse, text_to_image, path=["response"])
+
+    @parametrize
+    async def test_streaming_response_create(self, async_client: AsyncRunwayML) -> None:
+        async with async_client.text_to_image.with_streaming_response.create(
+            model="gen4_image",
+            prompt_text="promptText",
+            ratio="1920:1080",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            text_to_image = await response.parse()
+            assert_matches_type(TextToImageCreateResponse, text_to_image, path=["response"])
+
+        assert cast(Any, response.is_closed) is True

runwayml-3.0.6/.release-please-manifest.json

@@ -1,3 +0,0 @@
-{
-  ".": "3.0.6"
-}