feat(api): api update

stainless-app[bot] · stainless-app[bot] · commit e8ba8cbf95ab · 2025-06-25T03:24:32.000Z
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
-configured_endpoints: 12
+configured_endpoints: 13
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/luma-ai-karanganesan%2Fluma_ai-3eb911b4125c57ada1096eaeb4cadab8ac71ac4f6e5cf178209ebd1a3d7f826a.yml
 openapi_spec_hash: 69a6757bf5c41f96ae0694e0b9c86491
-config_hash: 99ed0ad60bce60c5aaf6e6e25f40c622
+config_hash: 8017bd140eecc6eedb1d788d7b0edb3b
diff --git a/api.md b/api.md
@@ -39,6 +39,7 @@ Methods:
 Methods:
 
 - <code title="post /generations/video">client.generations.video.<a href="./src/lumaai/resources/generations/video.py">create</a>(\*\*<a href="src/lumaai/types/generations/video_create_params.py">params</a>) -> <a href="./src/lumaai/types/generation.py">Generation</a></code>
+- <code title="post /generations/video/modify">client.generations.video.<a href="./src/lumaai/resources/generations/video.py">modify</a>(\*\*<a href="src/lumaai/types/generations/video_modify_params.py">params</a>) -> <a href="./src/lumaai/types/generation.py">Generation</a></code>
 - <code title="post /generations/video/reframe">client.generations.video.<a href="./src/lumaai/resources/generations/video.py">reframe</a>(\*\*<a href="src/lumaai/types/generations/video_reframe_params.py">params</a>) -> <a href="./src/lumaai/types/generation.py">Generation</a></code>
 
 # Ping
diff --git a/src/lumaai/resources/generations/video.py b/src/lumaai/resources/generations/video.py
@@ -19,7 +19,7 @@
 )
 from ..._base_client import make_request_options
 from ...types.generation import Generation
-from ...types.generations import video_create_params, video_reframe_params
+from ...types.generations import video_create_params, video_modify_params, video_reframe_params
 
 __all__ = ["VideoResource", "AsyncVideoResource"]
 
@@ -119,6 +119,79 @@ def create(
             cast_to=Generation,
         )
 
+    def modify(
+        self,
+        *,
+        generation_type: Literal["modify_video"],
+        media: video_modify_params.Media,
+        mode: Literal[
+            "adhere_1",
+            "adhere_2",
+            "adhere_3",
+            "flex_1",
+            "flex_2",
+            "flex_3",
+            "reimagine_1",
+            "reimagine_2",
+            "reimagine_3",
+        ],
+        model: Literal["ray-2"],
+        callback_url: str | NotGiven = NOT_GIVEN,
+        first_frame: video_modify_params.FirstFrame | NotGiven = NOT_GIVEN,
+        prompt: str | 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,
+    ) -> Generation:
+        """
+        Modify a video with style transfer and prompt-based editing
+
+        Args:
+          media: The image entity object
+
+          mode: The mode of the modify video
+
+          model: The model used for the modify video
+
+          callback_url: The callback URL of the generation, a POST request with Generation object will
+              be sent to the callback URL when the generation is dreaming, completed, or
+              failed
+
+          first_frame: The image entity object
+
+          prompt: The prompt of the generation
+
+          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(
+            "/generations/video/modify",
+            body=maybe_transform(
+                {
+                    "generation_type": generation_type,
+                    "media": media,
+                    "mode": mode,
+                    "model": model,
+                    "callback_url": callback_url,
+                    "first_frame": first_frame,
+                    "prompt": prompt,
+                },
+                video_modify_params.VideoModifyParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=Generation,
+        )
+
     def reframe(
         self,
         *,
@@ -310,6 +383,79 @@ async def create(
             cast_to=Generation,
         )
 
+    async def modify(
+        self,
+        *,
+        generation_type: Literal["modify_video"],
+        media: video_modify_params.Media,
+        mode: Literal[
+            "adhere_1",
+            "adhere_2",
+            "adhere_3",
+            "flex_1",
+            "flex_2",
+            "flex_3",
+            "reimagine_1",
+            "reimagine_2",
+            "reimagine_3",
+        ],
+        model: Literal["ray-2"],
+        callback_url: str | NotGiven = NOT_GIVEN,
+        first_frame: video_modify_params.FirstFrame | NotGiven = NOT_GIVEN,
+        prompt: str | 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,
+    ) -> Generation:
+        """
+        Modify a video with style transfer and prompt-based editing
+
+        Args:
+          media: The image entity object
+
+          mode: The mode of the modify video
+
+          model: The model used for the modify video
+
+          callback_url: The callback URL of the generation, a POST request with Generation object will
+              be sent to the callback URL when the generation is dreaming, completed, or
+              failed
+
+          first_frame: The image entity object
+
+          prompt: The prompt of the generation
+
+          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(
+            "/generations/video/modify",
+            body=await async_maybe_transform(
+                {
+                    "generation_type": generation_type,
+                    "media": media,
+                    "mode": mode,
+                    "model": model,
+                    "callback_url": callback_url,
+                    "first_frame": first_frame,
+                    "prompt": prompt,
+                },
+                video_modify_params.VideoModifyParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=Generation,
+        )
+
     async def reframe(
         self,
         *,
@@ -413,6 +559,9 @@ def __init__(self, video: VideoResource) -> None:
         self.create = to_raw_response_wrapper(
             video.create,
         )
+        self.modify = to_raw_response_wrapper(
+            video.modify,
+        )
         self.reframe = to_raw_response_wrapper(
             video.reframe,
         )
@@ -425,6 +574,9 @@ def __init__(self, video: AsyncVideoResource) -> None:
         self.create = async_to_raw_response_wrapper(
             video.create,
         )
+        self.modify = async_to_raw_response_wrapper(
+            video.modify,
+        )
         self.reframe = async_to_raw_response_wrapper(
             video.reframe,
         )
@@ -437,6 +589,9 @@ def __init__(self, video: VideoResource) -> None:
         self.create = to_streamed_response_wrapper(
             video.create,
         )
+        self.modify = to_streamed_response_wrapper(
+            video.modify,
+        )
         self.reframe = to_streamed_response_wrapper(
             video.reframe,
         )
@@ -449,6 +604,9 @@ def __init__(self, video: AsyncVideoResource) -> None:
         self.create = async_to_streamed_response_wrapper(
             video.create,
         )
+        self.modify = async_to_streamed_response_wrapper(
+            video.modify,
+        )
         self.reframe = async_to_streamed_response_wrapper(
             video.reframe,
         )
diff --git a/src/lumaai/types/generations/__init__.py b/src/lumaai/types/generations/__init__.py
@@ -4,6 +4,7 @@
 
 from .image_create_params import ImageCreateParams as ImageCreateParams
 from .video_create_params import VideoCreateParams as VideoCreateParams
+from .video_modify_params import VideoModifyParams as VideoModifyParams
 from .image_reframe_params import ImageReframeParams as ImageReframeParams
 from .video_reframe_params import VideoReframeParams as VideoReframeParams
 from .concept_list_response import ConceptListResponse as ConceptListResponse
diff --git a/src/lumaai/types/generations/video_modify_params.py b/src/lumaai/types/generations/video_modify_params.py
@@ -0,0 +1,55 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["VideoModifyParams", "Media", "FirstFrame"]
+
+
+class VideoModifyParams(TypedDict, total=False):
+    generation_type: Required[Literal["modify_video"]]
+
+    media: Required[Media]
+    """The image entity object"""
+
+    mode: Required[
+        Literal[
+            "adhere_1",
+            "adhere_2",
+            "adhere_3",
+            "flex_1",
+            "flex_2",
+            "flex_3",
+            "reimagine_1",
+            "reimagine_2",
+            "reimagine_3",
+        ]
+    ]
+    """The mode of the modify video"""
+
+    model: Required[Literal["ray-2"]]
+    """The model used for the modify video"""
+
+    callback_url: str
+    """
+    The callback URL of the generation, a POST request with Generation object will
+    be sent to the callback URL when the generation is dreaming, completed, or
+    failed
+    """
+
+    first_frame: FirstFrame
+    """The image entity object"""
+
+    prompt: str
+    """The prompt of the generation"""
+
+
+class Media(TypedDict, total=False):
+    url: Required[str]
+    """The URL of the media"""
+
+
+class FirstFrame(TypedDict, total=False):
+    url: Required[str]
+    """The URL of the media"""
diff --git a/tests/api_resources/generations/test_video.py b/tests/api_resources/generations/test_video.py
