gradient 3.2.0__tar.gz → 3.4.0__tar.gz

gradient-3.4.0/.release-please-manifest.json

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

{gradient-3.2.0 → gradient-3.4.0}/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 3.4.0 (2025-10-09)
+
+Full Changelog: [v3.3.0...v3.4.0](https://github.com/digitalocean/gradient-python/compare/v3.3.0...v3.4.0)
+
+### Features
+
+* **api:** manual updates ([bbd7ddc](https://github.com/digitalocean/gradient-python/commit/bbd7ddccfb3d98f39e61948365b92202b3cc9e33))
+
+## 3.3.0 (2025-10-07)
+
+Full Changelog: [v3.2.0...v3.3.0](https://github.com/digitalocean/gradient-python/compare/v3.2.0...v3.3.0)
+
+### Features
+
+* **api:** Images generations - openai ([e5a309e](https://github.com/digitalocean/gradient-python/commit/e5a309e46bf05846c580f425e6fa23f323138a4d))
+* **api:** update via SDK Studio ([c2bf693](https://github.com/digitalocean/gradient-python/commit/c2bf693d233830dafdfc2aa7f74e2ced2e8d81a0))
+
 ## 3.2.0 (2025-10-06)
 
 Full Changelog: [v3.1.0...v3.2.0](https://github.com/digitalocean/gradient-python/compare/v3.1.0...v3.2.0)

{gradient-3.2.0 → gradient-3.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: gradient
-Version: 3.2.0
+Version: 3.4.0
 Summary: The official Python library for the Gradient API
 Project-URL: Homepage, https://github.com/digitalocean/gradient-python
 Project-URL: Repository, https://github.com/digitalocean/gradient-python

{gradient-3.2.0 → gradient-3.4.0}/api.md

@@ -388,17 +388,15 @@ Methods:
 
 # Images
 
-## Generations
-
 Types:
 
 ```python
-from gradient.types.images import GenerationCreateResponse
+from gradient.types import ImageGenerateResponse
 ```
 
 Methods:
 
-- <code title="post /images/generations">client.images.generations.<a href="./src/gradient/resources/images/generations.py">create</a>(\*\*<a href="src/gradient/types/images/generation_create_params.py">params</a>) -> <a href="./src/gradient/types/images/generation_create_response.py">GenerationCreateResponse</a></code>
+- <code title="post /images/generations">client.images.<a href="./src/gradient/resources/images.py">generate</a>(\*\*<a href="src/gradient/types/image_generate_params.py">params</a>) -> <a href="./src/gradient/types/image_generate_response.py">ImageGenerateResponse</a></code>
 
 # GPUDroplets
 

{gradient-3.2.0 → gradient-3.4.0}/pyproject.toml

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

{gradient-3.2.0 → gradient-3.4.0}/src/gradient/_client.py

@@ -43,6 +43,7 @@ if TYPE_CHECKING:
         gpu_droplets,
         knowledge_bases,
     )
+    from .resources.images import ImagesResource, AsyncImagesResource
     from .resources.regions import RegionsResource, AsyncRegionsResource
     from .resources.chat.chat import ChatResource, AsyncChatResource
     from .resources.gpu_droplets import (
@@ -50,7 +51,6 @@ if TYPE_CHECKING:
         AsyncGPUDropletsResource,
     )
     from .resources.agents.agents import AgentsResource, AsyncAgentsResource
-    from .resources.images.images import ImagesResource, AsyncImagesResource
     from .resources.models.models import ModelsResource, AsyncModelsResource
     from .resources.databases.databases import DatabasesResource, AsyncDatabasesResource
     from .resources.inference.inference import InferenceResource, AsyncInferenceResource

{gradient-3.2.0 → gradient-3.4.0}/src/gradient/_version.py

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

{gradient-3.2.0 → gradient-3.4.0}/src/gradient/resources/gpu_droplets/floating_ips/floating_ips.py

@@ -79,9 +79,6 @@ class FloatingIPsResource(SyncAPIResource):
         - To create a new floating IP reserved to a region, send a POST request to
           `/v2/floating_ips` with the `region` attribute.
 
-        **Note**: In addition to the standard rate limiting, only 12 floating IPs may be
-        created per 60 seconds.
-
         Args:
           droplet_id: The ID of the Droplet that the floating IP will be assigned to.
 
@@ -118,9 +115,6 @@ class FloatingIPsResource(SyncAPIResource):
         - To create a new floating IP reserved to a region, send a POST request to
           `/v2/floating_ips` with the `region` attribute.
 
-        **Note**: In addition to the standard rate limiting, only 12 floating IPs may be
-        created per 60 seconds.
-
         Args:
           region: The slug identifier for the region the floating IP will be reserved to.
 
@@ -336,9 +330,6 @@ class AsyncFloatingIPsResource(AsyncAPIResource):
         - To create a new floating IP reserved to a region, send a POST request to
           `/v2/floating_ips` with the `region` attribute.
 
-        **Note**: In addition to the standard rate limiting, only 12 floating IPs may be
-        created per 60 seconds.
-
         Args:
           droplet_id: The ID of the Droplet that the floating IP will be assigned to.
 
@@ -375,9 +366,6 @@ class AsyncFloatingIPsResource(AsyncAPIResource):
         - To create a new floating IP reserved to a region, send a POST request to
           `/v2/floating_ips` with the `region` attribute.
 
-        **Note**: In addition to the standard rate limiting, only 12 floating IPs may be
-        created per 60 seconds.
-
         Args:
           region: The slug identifier for the region the floating IP will be reserved to.
 

gradient-3.2.0/src/gradient/resources/images/generations.py → gradient-3.4.0/src/gradient/resources/images.py

@@ -7,47 +7,47 @@ from typing_extensions import Literal, overload
 
 import httpx
 
-from ..._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
-from ..._utils import required_args, maybe_transform, async_maybe_transform
-from ..._compat import cached_property
-from ..._resource import SyncAPIResource, AsyncAPIResource
-from ..._response import (
+from ..types import image_generate_params
+from .._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
+from .._utils import required_args, 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 ..._streaming import Stream, AsyncStream
-from ..._base_client import make_request_options
-from ...types.images import generation_create_params
-from ...types.shared.image_gen_stream_event import ImageGenStreamEvent
-from ...types.images.generation_create_response import GenerationCreateResponse
+from .._streaming import Stream, AsyncStream
+from .._base_client import make_request_options
+from ..types.image_generate_response import ImageGenerateResponse
+from ..types.shared.image_gen_stream_event import ImageGenStreamEvent
 
-__all__ = ["GenerationsResource", "AsyncGenerationsResource"]
+__all__ = ["ImagesResource", "AsyncImagesResource"]
 
 
-class GenerationsResource(SyncAPIResource):
+class ImagesResource(SyncAPIResource):
     @cached_property
-    def with_raw_response(self) -> GenerationsResourceWithRawResponse:
+    def with_raw_response(self) -> ImagesResourceWithRawResponse:
         """
         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/digitalocean/gradient-python#accessing-raw-response-data-eg-headers
         """
-        return GenerationsResourceWithRawResponse(self)
+        return ImagesResourceWithRawResponse(self)
 
     @cached_property
-    def with_streaming_response(self) -> GenerationsResourceWithStreamingResponse:
+    def with_streaming_response(self) -> ImagesResourceWithStreamingResponse:
         """
         An alternative to `.with_raw_response` that doesn't eagerly read the response body.
 
         For more information, see https://www.github.com/digitalocean/gradient-python#with_streaming_response
         """
-        return GenerationsResourceWithStreamingResponse(self)
+        return ImagesResourceWithStreamingResponse(self)
 
     @overload
-    def create(
+    def generate(
         self,
         *,
         prompt: str,
@@ -68,7 +68,7 @@ class GenerationsResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> GenerationCreateResponse:
+    ) -> ImageGenerateResponse:
         """
         Creates a high-quality image from a text prompt using GPT-IMAGE-1, the latest
         image generation model with automatic prompt optimization and enhanced visual
@@ -126,7 +126,7 @@ class GenerationsResource(SyncAPIResource):
         ...
 
     @overload
-    def create(
+    def generate(
         self,
         *,
         prompt: str,
@@ -205,7 +205,7 @@ class GenerationsResource(SyncAPIResource):
         ...
 
     @overload
-    def create(
+    def generate(
         self,
         *,
         prompt: str,
@@ -226,7 +226,7 @@ class GenerationsResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> GenerationCreateResponse | Stream[ImageGenStreamEvent]:
+    ) -> ImageGenerateResponse | Stream[ImageGenStreamEvent]:
         """
         Creates a high-quality image from a text prompt using GPT-IMAGE-1, the latest
         image generation model with automatic prompt optimization and enhanced visual
@@ -284,7 +284,7 @@ class GenerationsResource(SyncAPIResource):
         ...
 
     @required_args(["prompt"], ["prompt", "stream"])
-    def create(
+    def generate(
         self,
         *,
         prompt: str,
@@ -305,7 +305,7 @@ class GenerationsResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> GenerationCreateResponse | Stream[ImageGenStreamEvent]:
+    ) -> ImageGenerateResponse | Stream[ImageGenStreamEvent]:
         if not self._client.model_access_key:
             raise TypeError(
                 "Could not resolve authentication method. Expected model_access_key to be set for chat completions."
@@ -335,41 +335,41 @@ class GenerationsResource(SyncAPIResource):
                     "stream": stream,
                     "user": user,
                 },
-                generation_create_params.GenerationCreateParamsStreaming
+                image_generate_params.ImageGenerateParamsStreaming
                 if stream
-                else generation_create_params.GenerationCreateParamsNonStreaming,
+                else image_generate_params.ImageGenerateParamsNonStreaming,
             ),
             options=make_request_options(
                 extra_headers=headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=GenerationCreateResponse,
+            cast_to=ImageGenerateResponse,
             stream=stream or False,
             stream_cls=Stream[ImageGenStreamEvent],
         )
 
 
-class AsyncGenerationsResource(AsyncAPIResource):
+class AsyncImagesResource(AsyncAPIResource):
     @cached_property
-    def with_raw_response(self) -> AsyncGenerationsResourceWithRawResponse:
+    def with_raw_response(self) -> AsyncImagesResourceWithRawResponse:
         """
         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/digitalocean/gradient-python#accessing-raw-response-data-eg-headers
         """
-        return AsyncGenerationsResourceWithRawResponse(self)
+        return AsyncImagesResourceWithRawResponse(self)
 
     @cached_property
-    def with_streaming_response(self) -> AsyncGenerationsResourceWithStreamingResponse:
+    def with_streaming_response(self) -> AsyncImagesResourceWithStreamingResponse:
         """
         An alternative to `.with_raw_response` that doesn't eagerly read the response body.
 
         For more information, see https://www.github.com/digitalocean/gradient-python#with_streaming_response
         """
-        return AsyncGenerationsResourceWithStreamingResponse(self)
+        return AsyncImagesResourceWithStreamingResponse(self)
 
     @overload
-    async def create(
+    async def generate(
         self,
         *,
         prompt: str,
@@ -390,7 +390,7 @@ class AsyncGenerationsResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> GenerationCreateResponse:
+    ) -> ImageGenerateResponse:
         """
         Creates a high-quality image from a text prompt using GPT-IMAGE-1, the latest
         image generation model with automatic prompt optimization and enhanced visual
@@ -448,7 +448,7 @@ class AsyncGenerationsResource(AsyncAPIResource):
         ...
 
     @overload
-    async def create(
+    async def generate(
         self,
         *,
         prompt: str,
@@ -527,7 +527,7 @@ class AsyncGenerationsResource(AsyncAPIResource):
         ...
 
     @overload
-    async def create(
+    async def generate(
         self,
         *,
         prompt: str,
@@ -548,7 +548,7 @@ class AsyncGenerationsResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> GenerationCreateResponse | AsyncStream[ImageGenStreamEvent]:
+    ) -> ImageGenerateResponse | AsyncStream[ImageGenStreamEvent]:
         """
         Creates a high-quality image from a text prompt using GPT-IMAGE-1, the latest
         image generation model with automatic prompt optimization and enhanced visual
@@ -606,7 +606,7 @@ class AsyncGenerationsResource(AsyncAPIResource):
         ...
 
     @required_args(["prompt"], ["prompt", "stream"])
-    async def create(
+    async def generate(
         self,
         *,
         prompt: str,
@@ -627,7 +627,7 @@ class AsyncGenerationsResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> GenerationCreateResponse | AsyncStream[ImageGenStreamEvent]:
+    ) -> ImageGenerateResponse | AsyncStream[ImageGenStreamEvent]:
         if not self._client.model_access_key:
             raise TypeError(
                 "Could not resolve authentication method. Expected model_access_key to be set for chat completions."
@@ -637,7 +637,6 @@ class AsyncGenerationsResource(AsyncAPIResource):
             "Authorization": f"Bearer {self._client.model_access_key}",
             **headers,
         }
-
         return await self._post(
             "/images/generations"
             if self._client._base_url_overridden
@@ -657,50 +656,50 @@ class AsyncGenerationsResource(AsyncAPIResource):
                     "stream": stream,
                     "user": user,
                 },
-                generation_create_params.GenerationCreateParamsStreaming
+                image_generate_params.ImageGenerateParamsStreaming
                 if stream
-                else generation_create_params.GenerationCreateParamsNonStreaming,
+                else image_generate_params.ImageGenerateParamsNonStreaming,
             ),
             options=make_request_options(
                 extra_headers=headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=GenerationCreateResponse,
+            cast_to=ImageGenerateResponse,
             stream=stream or False,
             stream_cls=AsyncStream[ImageGenStreamEvent],
         )
 
 
-class GenerationsResourceWithRawResponse:
-    def __init__(self, generations: GenerationsResource) -> None:
-        self._generations = generations
+class ImagesResourceWithRawResponse:
+    def __init__(self, images: ImagesResource) -> None:
+        self._images = images
 
-        self.create = to_raw_response_wrapper(
-            generations.create,
+        self.generate = to_raw_response_wrapper(
+            images.generate,
         )
 
 
-class AsyncGenerationsResourceWithRawResponse:
-    def __init__(self, generations: AsyncGenerationsResource) -> None:
-        self._generations = generations
+class AsyncImagesResourceWithRawResponse:
+    def __init__(self, images: AsyncImagesResource) -> None:
+        self._images = images
 
-        self.create = async_to_raw_response_wrapper(
-            generations.create,
+        self.generate = async_to_raw_response_wrapper(
+            images.generate,
         )
 
 
-class GenerationsResourceWithStreamingResponse:
-    def __init__(self, generations: GenerationsResource) -> None:
-        self._generations = generations
+class ImagesResourceWithStreamingResponse:
+    def __init__(self, images: ImagesResource) -> None:
+        self._images = images
 
-        self.create = to_streamed_response_wrapper(
-            generations.create,
+        self.generate = to_streamed_response_wrapper(
+            images.generate,
         )
 
 
-class AsyncGenerationsResourceWithStreamingResponse:
-    def __init__(self, generations: AsyncGenerationsResource) -> None:
-        self._generations = generations
+class AsyncImagesResourceWithStreamingResponse:
+    def __init__(self, images: AsyncImagesResource) -> None:
+        self._images = images
 
-        self.create = async_to_streamed_response_wrapper(
-            generations.create,
+        self.generate = async_to_streamed_response_wrapper(
+            images.generate,
         )

{gradient-3.2.0 → gradient-3.4.0}/src/gradient/types/__init__.py

@@ -68,10 +68,12 @@ from .agent_create_response import AgentCreateResponse as AgentCreateResponse
 from .agent_delete_response import AgentDeleteResponse as AgentDeleteResponse
 from .agent_update_response import AgentUpdateResponse as AgentUpdateResponse
 from .droplet_backup_policy import DropletBackupPolicy as DropletBackupPolicy
+from .image_generate_params import ImageGenerateParams as ImageGenerateParams
 from .api_agent_api_key_info import APIAgentAPIKeyInfo as APIAgentAPIKeyInfo
 from .agent_retrieve_response import AgentRetrieveResponse as AgentRetrieveResponse
 from .api_openai_api_key_info import APIOpenAIAPIKeyInfo as APIOpenAIAPIKeyInfo
 from .gpu_droplet_list_params import GPUDropletListParams as GPUDropletListParams
+from .image_generate_response import ImageGenerateResponse as ImageGenerateResponse
 from .api_deployment_visibility import APIDeploymentVisibility as APIDeploymentVisibility
 from .gpu_droplet_create_params import GPUDropletCreateParams as GPUDropletCreateParams
 from .gpu_droplet_list_response import GPUDropletListResponse as GPUDropletListResponse

{gradient-3.2.0 → gradient-3.4.0}/src/gradient/types/agents/chat/completion_create_response.py

@@ -67,7 +67,7 @@ class ChoiceMessage(BaseModel):
 
 
 class Choice(BaseModel):
-    finish_reason: Literal["stop", "length", "tool_calls"]
+    finish_reason: Literal["stop", "length", "tool_calls", "content_filter"]
     """The reason the model stopped generating tokens.
 
     This will be `stop` if the model hit a natural stop point or a provided stop

{gradient-3.2.0 → gradient-3.4.0}/src/gradient/types/chat/completion_create_response.py

@@ -67,7 +67,7 @@ class ChoiceMessage(BaseModel):
 
 
 class Choice(BaseModel):
-    finish_reason: Literal["stop", "length", "tool_calls"]
+    finish_reason: Literal["stop", "length", "tool_calls", "content_filter"]
     """The reason the model stopped generating tokens.
 
     This will be `stop` if the model hit a natural stop point or a provided stop

gradient-3.2.0/src/gradient/types/images/generation_create_params.py → gradient-3.4.0/src/gradient/types/image_generate_params.py

@@ -5,10 +5,10 @@ from __future__ import annotations
 from typing import Union, Optional
 from typing_extensions import Literal, Required, TypedDict
 
-__all__ = ["GenerationCreateParamsBase", "GenerationCreateParamsNonStreaming", "GenerationCreateParamsStreaming"]
+__all__ = ["ImageGenerateParamsBase", "ImageGenerateParamsNonStreaming", "ImageGenerateParamsStreaming"]
 
 
-class GenerationCreateParamsBase(TypedDict, total=False):
+class ImageGenerateParamsBase(TypedDict, total=False):
     prompt: Required[str]
     """A text description of the desired image(s).
 
@@ -77,7 +77,7 @@ class GenerationCreateParamsBase(TypedDict, total=False):
     """
 
 
-class GenerationCreateParamsNonStreaming(GenerationCreateParamsBase, total=False):
+class ImageGenerateParamsNonStreaming(ImageGenerateParamsBase, total=False):
     stream: Optional[Literal[False]]
     """
     If set to true, partial image data will be streamed as the image is being
@@ -87,7 +87,7 @@ class GenerationCreateParamsNonStreaming(GenerationCreateParamsBase, total=False
     """
 
 
-class GenerationCreateParamsStreaming(GenerationCreateParamsBase):
+class ImageGenerateParamsStreaming(ImageGenerateParamsBase):
     stream: Required[Literal[True]]
     """
     If set to true, partial image data will be streamed as the image is being
@@ -97,4 +97,4 @@ class GenerationCreateParamsStreaming(GenerationCreateParamsBase):
     """
 
 
-GenerationCreateParams = Union[GenerationCreateParamsNonStreaming, GenerationCreateParamsStreaming]
+ImageGenerateParams = Union[ImageGenerateParamsNonStreaming, ImageGenerateParamsStreaming]

gradient-3.2.0/src/gradient/types/images/generation_create_response.py → gradient-3.4.0/src/gradient/types/image_generate_response.py

@@ -2,9 +2,9 @@
 
 from typing import List, Optional
 
-from ..._models import BaseModel
+from .._models import BaseModel
 
-__all__ = ["GenerationCreateResponse", "Data", "Usage", "UsageInputTokensDetails"]
+__all__ = ["ImageGenerateResponse", "Data", "Usage", "UsageInputTokensDetails"]
 
 
 class Data(BaseModel):
@@ -40,7 +40,7 @@ class Usage(BaseModel):
     """Number of tokens in the generated output"""
 
 
-class GenerationCreateResponse(BaseModel):
+class ImageGenerateResponse(BaseModel):
     created: int
     """The Unix timestamp (in seconds) of when the images were created"""
 

{gradient-3.2.0 → gradient-3.4.0}/src/gradient/types/shared/chat_completion_chunk.py

@@ -71,7 +71,7 @@ class Choice(BaseModel):
     delta: ChoiceDelta
     """A chat completion delta generated by streamed model responses."""
 
-    finish_reason: Optional[Literal["stop", "length", "tool_calls"]] = None
+    finish_reason: Optional[Literal["stop", "length", "tool_calls", "content_filter"]] = None
     """The reason the model stopped generating tokens.
 
     This will be `stop` if the model hit a natural stop point or a provided stop