runwayml 3.6.5__tar.gz → 3.7.1__tar.gz

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

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

{runwayml-3.6.5 → runwayml-3.7.1}/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 3.7.1 (2025-07-22)
+
+Full Changelog: [v3.7.0...v3.7.1](https://github.com/runwayml/sdk-python/compare/v3.7.0...v3.7.1)
+
+### Bug Fixes
+
+* **parsing:** ignore empty metadata ([33c5e49](https://github.com/runwayml/sdk-python/commit/33c5e498bb3903d63f7c9ef308a2e49db4dc5efd))
+
+## 3.7.0 (2025-07-19)
+
+Full Changelog: [v3.6.5...v3.7.0](https://github.com/runwayml/sdk-python/compare/v3.6.5...v3.7.0)
+
+### Features
+
+* **api:** Act Two, credit usage endpoints ([f1114e0](https://github.com/runwayml/sdk-python/commit/f1114e0be865f9e27e697dfcaeb5dc6c0be659ed))
+* **api:** Awaitability on new resources ([7612c78](https://github.com/runwayml/sdk-python/commit/7612c78ee6f64969138685312c4a3d539191beb9))
+* clean up environment call outs ([caa8eff](https://github.com/runwayml/sdk-python/commit/caa8eff7855430950fe4184c3db885e84a607d5f))
+
+
+### Chores
+
+* **client:** lint ([d745891](https://github.com/runwayml/sdk-python/commit/d74589104c8a15d5ab4e87b1f4de4ec915210a3e))
+
 ## 3.6.5 (2025-07-12)
 
 Full Changelog: [v3.6.4...v3.6.5](https://github.com/runwayml/sdk-python/compare/v3.6.4...v3.6.5)

{runwayml-3.6.5 → runwayml-3.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: runwayml
-Version: 3.6.5
+Version: 3.7.1
 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
@@ -124,7 +124,6 @@ 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
@@ -132,7 +131,7 @@ 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
+        api_key="My API Key",
         http_client=DefaultAioHttpClient(),
     ) as client:
         image_to_video = await client.image_to_video.create(

{runwayml-3.6.5 → runwayml-3.7.1}/README.md

@@ -89,7 +89,6 @@ 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
@@ -97,7 +96,7 @@ 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
+        api_key="My API Key",
         http_client=DefaultAioHttpClient(),
     ) as client:
         image_to_video = await client.image_to_video.create(

{runwayml-3.6.5 → runwayml-3.7.1}/api.md

@@ -47,14 +47,27 @@ Methods:
 
 - <code title="post /v1/video_upscale">client.video_upscale.<a href="./src/runwayml/resources/video_upscale.py">create</a>(\*\*<a href="src/runwayml/types/video_upscale_create_params.py">params</a>) -> <a href="./src/runwayml/types/video_upscale_create_response.py">VideoUpscaleCreateResponse</a></code>
 
+# CharacterPerformance
+
+Types:
+
+```python
+from runwayml.types import CharacterPerformanceCreateResponse
+```
+
+Methods:
+
+- <code title="post /v1/character_performance">client.character_performance.<a href="./src/runwayml/resources/character_performance.py">create</a>(\*\*<a href="src/runwayml/types/character_performance_create_params.py">params</a>) -> <a href="./src/runwayml/types/character_performance_create_response.py">CharacterPerformanceCreateResponse</a></code>
+
 # Organization
 
 Types:
 
 ```python
-from runwayml.types import OrganizationRetrieveResponse
+from runwayml.types import OrganizationRetrieveResponse, OrganizationRetrieveUsageResponse
 ```
 
 Methods:
 
 - <code title="get /v1/organization">client.organization.<a href="./src/runwayml/resources/organization.py">retrieve</a>() -> <a href="./src/runwayml/types/organization_retrieve_response.py">OrganizationRetrieveResponse</a></code>
+- <code title="post /v1/organization/usage">client.organization.<a href="./src/runwayml/resources/organization.py">retrieve_usage</a>(\*\*<a href="src/runwayml/types/organization_retrieve_usage_params.py">params</a>) -> <a href="./src/runwayml/types/organization_retrieve_usage_response.py">OrganizationRetrieveUsageResponse</a></code>

{runwayml-3.6.5 → runwayml-3.7.1}/examples/generate_image.py

@@ -10,7 +10,7 @@ image_task = client.text_to_image.create(
 try:
     output = image_task.wait_for_task_output()
 except TaskFailedError as e:
-    print('The image failed to generate.')
+    print("The image failed to generate.")
     print(e.task_details)
 else:
     print(output.output[0])  # type: ignore

{runwayml-3.6.5 → runwayml-3.7.1}/pyproject.toml

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

{runwayml-3.6.5 → runwayml-3.7.1}/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, text_to_image, video_upscale, image_to_video
+from .resources import tasks, organization, text_to_image, video_upscale, image_to_video, character_performance
 from ._streaming import Stream as Stream, AsyncStream as AsyncStream
 from ._exceptions import RunwayMLError, APIStatusError
 from ._base_client import (
@@ -47,6 +47,7 @@ class RunwayML(SyncAPIClient):
     image_to_video: image_to_video.ImageToVideoResource
     text_to_image: text_to_image.TextToImageResource
     video_upscale: video_upscale.VideoUpscaleResource
+    character_performance: character_performance.CharacterPerformanceResource
     organization: organization.OrganizationResource
     with_raw_response: RunwayMLWithRawResponse
     with_streaming_response: RunwayMLWithStreamedResponse
@@ -115,6 +116,7 @@ class RunwayML(SyncAPIClient):
         self.image_to_video = image_to_video.ImageToVideoResource(self)
         self.text_to_image = text_to_image.TextToImageResource(self)
         self.video_upscale = video_upscale.VideoUpscaleResource(self)
+        self.character_performance = character_performance.CharacterPerformanceResource(self)
         self.organization = organization.OrganizationResource(self)
         self.with_raw_response = RunwayMLWithRawResponse(self)
         self.with_streaming_response = RunwayMLWithStreamedResponse(self)
@@ -232,6 +234,7 @@ class AsyncRunwayML(AsyncAPIClient):
     image_to_video: image_to_video.AsyncImageToVideoResource
     text_to_image: text_to_image.AsyncTextToImageResource
     video_upscale: video_upscale.AsyncVideoUpscaleResource
+    character_performance: character_performance.AsyncCharacterPerformanceResource
     organization: organization.AsyncOrganizationResource
     with_raw_response: AsyncRunwayMLWithRawResponse
     with_streaming_response: AsyncRunwayMLWithStreamedResponse
@@ -300,6 +303,7 @@ class AsyncRunwayML(AsyncAPIClient):
         self.image_to_video = image_to_video.AsyncImageToVideoResource(self)
         self.text_to_image = text_to_image.AsyncTextToImageResource(self)
         self.video_upscale = video_upscale.AsyncVideoUpscaleResource(self)
+        self.character_performance = character_performance.AsyncCharacterPerformanceResource(self)
         self.organization = organization.AsyncOrganizationResource(self)
         self.with_raw_response = AsyncRunwayMLWithRawResponse(self)
         self.with_streaming_response = AsyncRunwayMLWithStreamedResponse(self)
@@ -418,6 +422,9 @@ class RunwayMLWithRawResponse:
         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.video_upscale = video_upscale.VideoUpscaleResourceWithRawResponse(client.video_upscale)
+        self.character_performance = character_performance.CharacterPerformanceResourceWithRawResponse(
+            client.character_performance
+        )
         self.organization = organization.OrganizationResourceWithRawResponse(client.organization)
 
 
@@ -427,6 +434,9 @@ class AsyncRunwayMLWithRawResponse:
         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.video_upscale = video_upscale.AsyncVideoUpscaleResourceWithRawResponse(client.video_upscale)
+        self.character_performance = character_performance.AsyncCharacterPerformanceResourceWithRawResponse(
+            client.character_performance
+        )
         self.organization = organization.AsyncOrganizationResourceWithRawResponse(client.organization)
 
 
@@ -436,6 +446,9 @@ class RunwayMLWithStreamedResponse:
         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.video_upscale = video_upscale.VideoUpscaleResourceWithStreamingResponse(client.video_upscale)
+        self.character_performance = character_performance.CharacterPerformanceResourceWithStreamingResponse(
+            client.character_performance
+        )
         self.organization = organization.OrganizationResourceWithStreamingResponse(client.organization)
 
 
@@ -445,6 +458,9 @@ class AsyncRunwayMLWithStreamedResponse:
         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.video_upscale = video_upscale.AsyncVideoUpscaleResourceWithStreamingResponse(client.video_upscale)
+        self.character_performance = character_performance.AsyncCharacterPerformanceResourceWithStreamingResponse(
+            client.character_performance
+        )
         self.organization = organization.AsyncOrganizationResourceWithStreamingResponse(client.organization)
 
 

{runwayml-3.6.5 → runwayml-3.7.1}/src/runwayml/_models.py

@@ -439,7 +439,7 @@ def construct_type(*, value: object, type_: object, metadata: Optional[List[Any]
         type_ = type_.__value__  # type: ignore[unreachable]
 
     # unwrap `Annotated[T, ...]` -> `T`
-    if metadata is not None:
+    if metadata is not None and len(metadata) > 0:
         meta: tuple[Any, ...] = tuple(metadata)
     elif is_annotated_type(type_):
         meta = get_args(type_)[1:]

{runwayml-3.6.5 → runwayml-3.7.1}/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.6.5"  # x-release-please-version
+__version__ = "3.7.1"  # x-release-please-version

{runwayml-3.6.5 → runwayml-3.7.1}/src/runwayml/resources/__init__.py

@@ -40,6 +40,14 @@ from .image_to_video import (
     ImageToVideoResourceWithStreamingResponse,
     AsyncImageToVideoResourceWithStreamingResponse,
 )
+from .character_performance import (
+    CharacterPerformanceResource,
+    AsyncCharacterPerformanceResource,
+    CharacterPerformanceResourceWithRawResponse,
+    AsyncCharacterPerformanceResourceWithRawResponse,
+    CharacterPerformanceResourceWithStreamingResponse,
+    AsyncCharacterPerformanceResourceWithStreamingResponse,
+)
 
 __all__ = [
     "TasksResource",
@@ -66,6 +74,12 @@ __all__ = [
     "AsyncVideoUpscaleResourceWithRawResponse",
     "VideoUpscaleResourceWithStreamingResponse",
     "AsyncVideoUpscaleResourceWithStreamingResponse",
+    "CharacterPerformanceResource",
+    "AsyncCharacterPerformanceResource",
+    "CharacterPerformanceResourceWithRawResponse",
+    "AsyncCharacterPerformanceResourceWithRawResponse",
+    "CharacterPerformanceResourceWithStreamingResponse",
+    "AsyncCharacterPerformanceResourceWithStreamingResponse",
     "OrganizationResource",
     "AsyncOrganizationResource",
     "OrganizationResourceWithRawResponse",

runwayml-3.7.1/src/runwayml/resources/character_performance.py

@@ -0,0 +1,251 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal
+
+import httpx
+
+from ..types import character_performance_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 ..lib.polling import (
+    NewTaskCreatedResponse,
+    AsyncNewTaskCreatedResponse,
+    create_waitable_resource,
+    create_async_waitable_resource,
+)
+from .._base_client import make_request_options
+from ..types.character_performance_create_response import CharacterPerformanceCreateResponse
+
+__all__ = ["CharacterPerformanceResource", "AsyncCharacterPerformanceResource"]
+
+
+class CharacterPerformanceResource(SyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> CharacterPerformanceResourceWithRawResponse:
+        """
+        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 CharacterPerformanceResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> CharacterPerformanceResourceWithStreamingResponse:
+        """
+        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 CharacterPerformanceResourceWithStreamingResponse(self)
+
+    def create(
+        self,
+        *,
+        character: character_performance_create_params.Character,
+        model: Literal["act_two"],
+        ratio: Literal["1280:720", "720:1280", "960:960", "1104:832", "832:1104", "1584:672"],
+        reference: character_performance_create_params.Reference,
+        body_control: bool | NotGiven = NOT_GIVEN,
+        content_moderation: character_performance_create_params.ContentModeration | NotGiven = NOT_GIVEN,
+        expression_intensity: int | 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,
+    ) -> NewTaskCreatedResponse:
+        """
+        This endpoint will start a new task to control a character's facial expressions
+        and body movements using a reference video.
+
+        Args:
+          character: The character to control. You can either provide a video or an image. A visually
+              recognizable face must be visible and stay within the frame.
+
+          model: The model variant to use.
+
+          ratio: The resolution of the output video.
+
+          body_control: A boolean indicating whether to enable body control. When enabled, non-facial
+              movements and gestures will be applied to the character in addition to facial
+              expressions.
+
+          content_moderation: Settings that affect the behavior of the content moderation system.
+
+          expression_intensity: An integer between 1 and 5 (inclusive). A larger value increases the intensity
+              of the character's expression.
+
+          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/character_performance",
+            body=maybe_transform(
+                {
+                    "character": character,
+                    "model": model,
+                    "ratio": ratio,
+                    "reference": reference,
+                    "body_control": body_control,
+                    "content_moderation": content_moderation,
+                    "expression_intensity": expression_intensity,
+                    "seed": seed,
+                },
+                character_performance_create_params.CharacterPerformanceCreateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=create_waitable_resource(CharacterPerformanceCreateResponse, self._client),
+        )
+
+
+class AsyncCharacterPerformanceResource(AsyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AsyncCharacterPerformanceResourceWithRawResponse:
+        """
+        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 AsyncCharacterPerformanceResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncCharacterPerformanceResourceWithStreamingResponse:
+        """
+        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 AsyncCharacterPerformanceResourceWithStreamingResponse(self)
+
+    async def create(
+        self,
+        *,
+        character: character_performance_create_params.Character,
+        model: Literal["act_two"],
+        ratio: Literal["1280:720", "720:1280", "960:960", "1104:832", "832:1104", "1584:672"],
+        reference: character_performance_create_params.Reference,
+        body_control: bool | NotGiven = NOT_GIVEN,
+        content_moderation: character_performance_create_params.ContentModeration | NotGiven = NOT_GIVEN,
+        expression_intensity: int | 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,
+    ) -> AsyncNewTaskCreatedResponse:
+        """
+        This endpoint will start a new task to control a character's facial expressions
+        and body movements using a reference video.
+
+        Args:
+          character: The character to control. You can either provide a video or an image. A visually
+              recognizable face must be visible and stay within the frame.
+
+          model: The model variant to use.
+
+          ratio: The resolution of the output video.
+
+          body_control: A boolean indicating whether to enable body control. When enabled, non-facial
+              movements and gestures will be applied to the character in addition to facial
+              expressions.
+
+          content_moderation: Settings that affect the behavior of the content moderation system.
+
+          expression_intensity: An integer between 1 and 5 (inclusive). A larger value increases the intensity
+              of the character's expression.
+
+          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/character_performance",
+            body=await async_maybe_transform(
+                {
+                    "character": character,
+                    "model": model,
+                    "ratio": ratio,
+                    "reference": reference,
+                    "body_control": body_control,
+                    "content_moderation": content_moderation,
+                    "expression_intensity": expression_intensity,
+                    "seed": seed,
+                },
+                character_performance_create_params.CharacterPerformanceCreateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=create_async_waitable_resource(CharacterPerformanceCreateResponse, self._client),
+        )
+
+
+class CharacterPerformanceResourceWithRawResponse:
+    def __init__(self, character_performance: CharacterPerformanceResource) -> None:
+        self._character_performance = character_performance
+
+        self.create = to_raw_response_wrapper(
+            character_performance.create,
+        )
+
+
+class AsyncCharacterPerformanceResourceWithRawResponse:
+    def __init__(self, character_performance: AsyncCharacterPerformanceResource) -> None:
+        self._character_performance = character_performance
+
+        self.create = async_to_raw_response_wrapper(
+            character_performance.create,
+        )
+
+
+class CharacterPerformanceResourceWithStreamingResponse:
+    def __init__(self, character_performance: CharacterPerformanceResource) -> None:
+        self._character_performance = character_performance
+
+        self.create = to_streamed_response_wrapper(
+            character_performance.create,
+        )
+
+
+class AsyncCharacterPerformanceResourceWithStreamingResponse:
+    def __init__(self, character_performance: AsyncCharacterPerformanceResource) -> None:
+        self._character_performance = character_performance
+
+        self.create = async_to_streamed_response_wrapper(
+            character_performance.create,
+        )

{runwayml-3.6.5 → runwayml-3.7.1}/src/runwayml/resources/organization.py

@@ -2,9 +2,14 @@
 
 from __future__ import annotations
 
+from typing import Union
+from datetime import date
+
 import httpx
 
+from ..types import organization_retrieve_usage_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 (
@@ -15,6 +20,7 @@ from .._response import (
 )
 from .._base_client import make_request_options
 from ..types.organization_retrieve_response import OrganizationRetrieveResponse
+from ..types.organization_retrieve_usage_response import OrganizationRetrieveUsageResponse
 
 __all__ = ["OrganizationResource", "AsyncOrganizationResource"]
 
@@ -61,6 +67,55 @@ class OrganizationResource(SyncAPIResource):
             cast_to=OrganizationRetrieveResponse,
         )
 
+    def retrieve_usage(
+        self,
+        *,
+        before_date: Union[str, date] | NotGiven = NOT_GIVEN,
+        start_date: Union[str, date] | 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,
+    ) -> OrganizationRetrieveUsageResponse:
+        """
+        Fetch credit usage data broken down by model and day for the organization
+        associated with the API key used to make the request. Up to 90 days of data can
+        be queried at a time.
+
+        Args:
+          before_date: The end date of the usage data in ISO-8601 format (YYYY-MM-DD), not inclusive.
+              If unspecified, it will default to thirty days after the start date. Must be
+              less than or equal to 90 days after the start date. All dates are in UTC.
+
+          start_date: The start date of the usage data in ISO-8601 format (YYYY-MM-DD). If
+              unspecified, it will default to 30 days before the current date. All dates are
+              in UTC.
+
+          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/organization/usage",
+            body=maybe_transform(
+                {
+                    "before_date": before_date,
+                    "start_date": start_date,
+                },
+                organization_retrieve_usage_params.OrganizationRetrieveUsageParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=OrganizationRetrieveUsageResponse,
+        )
+
 
 class AsyncOrganizationResource(AsyncAPIResource):
     @cached_property
@@ -104,6 +159,55 @@ class AsyncOrganizationResource(AsyncAPIResource):
             cast_to=OrganizationRetrieveResponse,
         )
 
+    async def retrieve_usage(
+        self,
+        *,
+        before_date: Union[str, date] | NotGiven = NOT_GIVEN,
+        start_date: Union[str, date] | 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,
+    ) -> OrganizationRetrieveUsageResponse:
+        """
+        Fetch credit usage data broken down by model and day for the organization
+        associated with the API key used to make the request. Up to 90 days of data can
+        be queried at a time.
+
+        Args:
+          before_date: The end date of the usage data in ISO-8601 format (YYYY-MM-DD), not inclusive.
+              If unspecified, it will default to thirty days after the start date. Must be
+              less than or equal to 90 days after the start date. All dates are in UTC.
+
+          start_date: The start date of the usage data in ISO-8601 format (YYYY-MM-DD). If
+              unspecified, it will default to 30 days before the current date. All dates are
+              in UTC.
+
+          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/organization/usage",
+            body=await async_maybe_transform(
+                {
+                    "before_date": before_date,
+                    "start_date": start_date,
+                },
+                organization_retrieve_usage_params.OrganizationRetrieveUsageParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=OrganizationRetrieveUsageResponse,
+        )
+
 
 class OrganizationResourceWithRawResponse:
     def __init__(self, organization: OrganizationResource) -> None:
@@ -112,6 +216,9 @@ class OrganizationResourceWithRawResponse:
         self.retrieve = to_raw_response_wrapper(
             organization.retrieve,
         )
+        self.retrieve_usage = to_raw_response_wrapper(
+            organization.retrieve_usage,
+        )
 
 
 class AsyncOrganizationResourceWithRawResponse:
@@ -121,6 +228,9 @@ class AsyncOrganizationResourceWithRawResponse:
         self.retrieve = async_to_raw_response_wrapper(
             organization.retrieve,
         )
+        self.retrieve_usage = async_to_raw_response_wrapper(
+            organization.retrieve_usage,
+        )
 
 
 class OrganizationResourceWithStreamingResponse:
@@ -130,6 +240,9 @@ class OrganizationResourceWithStreamingResponse:
         self.retrieve = to_streamed_response_wrapper(
             organization.retrieve,
         )
+        self.retrieve_usage = to_streamed_response_wrapper(
+            organization.retrieve_usage,
+        )
 
 
 class AsyncOrganizationResourceWithStreamingResponse:
@@ -139,3 +252,6 @@ class AsyncOrganizationResourceWithStreamingResponse:
         self.retrieve = async_to_streamed_response_wrapper(
             organization.retrieve,
         )
+        self.retrieve_usage = async_to_streamed_response_wrapper(
+            organization.retrieve_usage,
+        )