volcengine-python-sdk 4.0.17__py2.py3-none-any.whl → 4.0.18__py2.py3-none-any.whl

volcenginesdkapig20221112/models/route_for_get_route_output.py

@@ -38,16 +38,15 @@ class RouteForGetRouteOutput(object):
         'custom_domains': 'list[CustomDomainForGetRouteOutput]',
         'domains': 'list[DomainForGetRouteOutput]',
         'enable': 'bool',
+        'fallback_setting': 'FallbackSettingForGetRouteOutput',
         'id': 'str',
         'match_rule': 'MatchRuleForGetRouteOutput',
         'name': 'str',
         'priority': 'int',
         'reason': 'str',
-        'resource_type': 'str',
         'service_id': 'str',
         'service_name': 'str',
         'status': 'str',
-        'tags': 'list[TagForGetRouteOutput]',
         'update_time': 'str',
         'upstream_list': 'list[UpstreamListForGetRouteOutput]'
     }
@@ -58,21 +57,20 @@ class RouteForGetRouteOutput(object):
         'custom_domains': 'CustomDomains',
         'domains': 'Domains',
         'enable': 'Enable',
+        'fallback_setting': 'FallbackSetting',
         'id': 'Id',
         'match_rule': 'MatchRule',
         'name': 'Name',
         'priority': 'Priority',
         'reason': 'Reason',
-        'resource_type': 'ResourceType',
         'service_id': 'ServiceId',
         'service_name': 'ServiceName',
         'status': 'Status',
-        'tags': 'Tags',
         'update_time': 'UpdateTime',
         'upstream_list': 'UpstreamList'
     }
 
-    def __init__(self, advanced_setting=None, create_time=None, custom_domains=None, domains=None, enable=None, id=None, match_rule=None, name=None, priority=None, reason=None, resource_type=None, service_id=None, service_name=None, status=None, tags=None, update_time=None, upstream_list=None, _configuration=None):  # noqa: E501
+    def __init__(self, advanced_setting=None, create_time=None, custom_domains=None, domains=None, enable=None, fallback_setting=None, id=None, match_rule=None, name=None, priority=None, reason=None, service_id=None, service_name=None, status=None, update_time=None, upstream_list=None, _configuration=None):  # noqa: E501
         """RouteForGetRouteOutput - a model defined in Swagger"""  # noqa: E501
         if _configuration is None:
             _configuration = Configuration()
@@ -83,16 +81,15 @@ class RouteForGetRouteOutput(object):
         self._custom_domains = None
         self._domains = None
         self._enable = None
+        self._fallback_setting = None
         self._id = None
         self._match_rule = None
         self._name = None
         self._priority = None
         self._reason = None
-        self._resource_type = None
         self._service_id = None
         self._service_name = None
         self._status = None
-        self._tags = None
         self._update_time = None
         self._upstream_list = None
         self.discriminator = None
@@ -107,6 +104,8 @@ class RouteForGetRouteOutput(object):
             self.domains = domains
         if enable is not None:
             self.enable = enable
+        if fallback_setting is not None:
+            self.fallback_setting = fallback_setting
         if id is not None:
             self.id = id
         if match_rule is not None:
@@ -117,16 +116,12 @@ class RouteForGetRouteOutput(object):
             self.priority = priority
         if reason is not None:
             self.reason = reason
-        if resource_type is not None:
-            self.resource_type = resource_type
         if service_id is not None:
             self.service_id = service_id
         if service_name is not None:
             self.service_name = service_name
         if status is not None:
             self.status = status
-        if tags is not None:
-            self.tags = tags
         if update_time is not None:
             self.update_time = update_time
         if upstream_list is not None:
@@ -237,6 +232,27 @@ class RouteForGetRouteOutput(object):
 
         self._enable = enable
 
+    @property
+    def fallback_setting(self):
+        """Gets the fallback_setting of this RouteForGetRouteOutput.  # noqa: E501
+
+
+        :return: The fallback_setting of this RouteForGetRouteOutput.  # noqa: E501
+        :rtype: FallbackSettingForGetRouteOutput
+        """
+        return self._fallback_setting
+
+    @fallback_setting.setter
+    def fallback_setting(self, fallback_setting):
+        """Sets the fallback_setting of this RouteForGetRouteOutput.
+
+
+        :param fallback_setting: The fallback_setting of this RouteForGetRouteOutput.  # noqa: E501
+        :type: FallbackSettingForGetRouteOutput
+        """
+
+        self._fallback_setting = fallback_setting
+
     @property
     def id(self):
         """Gets the id of this RouteForGetRouteOutput.  # noqa: E501
@@ -342,27 +358,6 @@ class RouteForGetRouteOutput(object):
 
         self._reason = reason
 
-    @property
-    def resource_type(self):
-        """Gets the resource_type of this RouteForGetRouteOutput.  # noqa: E501
-
-
-        :return: The resource_type of this RouteForGetRouteOutput.  # noqa: E501
-        :rtype: str
-        """
-        return self._resource_type
-
-    @resource_type.setter
-    def resource_type(self, resource_type):
-        """Sets the resource_type of this RouteForGetRouteOutput.
-
-
-        :param resource_type: The resource_type of this RouteForGetRouteOutput.  # noqa: E501
-        :type: str
-        """
-
-        self._resource_type = resource_type
-
     @property
     def service_id(self):
         """Gets the service_id of this RouteForGetRouteOutput.  # noqa: E501
@@ -426,27 +421,6 @@ class RouteForGetRouteOutput(object):
 
         self._status = status
 
-    @property
-    def tags(self):
-        """Gets the tags of this RouteForGetRouteOutput.  # noqa: E501
-
-
-        :return: The tags of this RouteForGetRouteOutput.  # noqa: E501
-        :rtype: list[TagForGetRouteOutput]
-        """
-        return self._tags
-
-    @tags.setter
-    def tags(self, tags):
-        """Sets the tags of this RouteForGetRouteOutput.
-
-
-        :param tags: The tags of this RouteForGetRouteOutput.  # noqa: E501
-        :type: list[TagForGetRouteOutput]
-        """
-
-        self._tags = tags
-
     @property
     def update_time(self):
         """Gets the update_time of this RouteForGetRouteOutput.  # noqa: E501

volcenginesdkapig20221112/models/update_route_request.py

@@ -35,6 +35,7 @@ class UpdateRouteRequest(object):
     swagger_types = {
         'advanced_setting': 'AdvancedSettingForUpdateRouteInput',
         'enable': 'bool',
+        'fallback_setting': 'FallbackSettingForUpdateRouteInput',
         'id': 'str',
         'match_rule': 'MatchRuleForUpdateRouteInput',
         'name': 'str',
@@ -45,6 +46,7 @@ class UpdateRouteRequest(object):
     attribute_map = {
         'advanced_setting': 'AdvancedSetting',
         'enable': 'Enable',
+        'fallback_setting': 'FallbackSetting',
         'id': 'Id',
         'match_rule': 'MatchRule',
         'name': 'Name',
@@ -52,7 +54,7 @@ class UpdateRouteRequest(object):
         'upstream_list': 'UpstreamList'
     }
 
-    def __init__(self, advanced_setting=None, enable=None, id=None, match_rule=None, name=None, priority=None, upstream_list=None, _configuration=None):  # noqa: E501
+    def __init__(self, advanced_setting=None, enable=None, fallback_setting=None, id=None, match_rule=None, name=None, priority=None, upstream_list=None, _configuration=None):  # noqa: E501
         """UpdateRouteRequest - a model defined in Swagger"""  # noqa: E501
         if _configuration is None:
             _configuration = Configuration()
@@ -60,6 +62,7 @@ class UpdateRouteRequest(object):
 
         self._advanced_setting = None
         self._enable = None
+        self._fallback_setting = None
         self._id = None
         self._match_rule = None
         self._name = None
@@ -71,6 +74,8 @@ class UpdateRouteRequest(object):
             self.advanced_setting = advanced_setting
         if enable is not None:
             self.enable = enable
+        if fallback_setting is not None:
+            self.fallback_setting = fallback_setting
         self.id = id
         if match_rule is not None:
             self.match_rule = match_rule
@@ -122,6 +127,27 @@ class UpdateRouteRequest(object):
 
         self._enable = enable
 
+    @property
+    def fallback_setting(self):
+        """Gets the fallback_setting of this UpdateRouteRequest.  # noqa: E501
+
+
+        :return: The fallback_setting of this UpdateRouteRequest.  # noqa: E501
+        :rtype: FallbackSettingForUpdateRouteInput
+        """
+        return self._fallback_setting
+
+    @fallback_setting.setter
+    def fallback_setting(self, fallback_setting):
+        """Sets the fallback_setting of this UpdateRouteRequest.
+
+
+        :param fallback_setting: The fallback_setting of this UpdateRouteRequest.  # noqa: E501
+        :type: FallbackSettingForUpdateRouteInput
+        """
+
+        self._fallback_setting = fallback_setting
+
     @property
     def id(self):
         """Gets the id of this UpdateRouteRequest.  # noqa: E501

volcenginesdkarkruntime/resources/images/images.py

@@ -12,23 +12,106 @@
 
 from __future__ import annotations
 
+from typing import Optional
+from typing_extensions import Literal, overload
+
 import httpx
 
+from ..._types import NOT_GIVEN, NotGiven
 from ..._base_client import make_request_options
 from ..._utils._utils import apikey_required, async_apikey_required
 from ..._resource import SyncAPIResource, AsyncAPIResource
-from ...types.images import ImagesResponse
+from ...types.images import SequentialImageGenerationOptions, ImagesResponse
+from ...types.images.image_gen_stream_event import ImageGenStreamEvent
 from ..._types import Body, Query, Headers
+from ..._streaming import Stream
 
 
 class Images(SyncAPIResource):
+    @overload
+    def generate(
+        self,
+        *,
+        model: str,
+        prompt: str,
+        image: str | list[str] | None = None,
+        response_format: str | None = None,
+        size: str | None = None,
+        seed: int | None = None,
+        guidance_scale: float | None = None,
+        watermark: bool | None = None,
+        optimize_prompt: bool | None = None,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None = None,
+        sequential_image_generation: str | None = None,
+        sequential_image_generation_options: SequentialImageGenerationOptions | None = None,
+        stream: Optional[Literal[False]] | NotGiven = NOT_GIVEN,
+    ) -> ImagesResponse:
+        ...
+
+        """
+        ImageSequenceGeneration: 
+            Controls whether the multi-image feature is enforced
+            - Enum values:
+                - auto: Automatic mode; the model decides whether to return multiple images and how many based on the user's prompt
+                - disabled: Disables multi-image; the model generates only a single image
+        """
+
+    @overload
+    def generate(
+        self,
+        *,
+        model: str,
+        prompt: str,
+        image: str | list[str] | None = None,
+        response_format: str | None = None,
+        size: str | None = None,
+        seed: int | None = None,
+        guidance_scale: float | None = None,
+        watermark: bool | None = None,
+        optimize_prompt: bool | None = None,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None = None,
+        sequential_image_generation: str | None = None,
+        sequential_image_generation_options: SequentialImageGenerationOptions | None = None,
+        stream: Literal[True],
+    ) -> Stream[ImageGenStreamEvent]:
+        ...
+
+    @overload
+    def generate(
+        self,
+        *,
+        model: str,
+        prompt: str,
+        image: str | list[str] | None = None,
+        response_format: str | None = None,
+        size: str | None = None,
+        seed: int | None = None,
+        guidance_scale: float | None = None,
+        watermark: bool | None = None,
+        optimize_prompt: bool | None = None,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None = None,
+        sequential_image_generation: str | None = None,
+        sequential_image_generation_options: SequentialImageGenerationOptions | None = None,
+        stream: bool,
+    ) -> ImagesResponse | Stream[ImageGenStreamEvent]:
+        ...
+
     @apikey_required
     def generate(
         self,
         *,
         model: str,
         prompt: str,
-        image: str | None = None,
+        image: str | list[str] | None = None,
         response_format: str | None = None,
         size: str | None = None,
         seed: int | None = None,
@@ -39,6 +122,9 @@ class Images(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None = None,
+        sequential_image_generation: str | None = None,
+        sequential_image_generation_options: SequentialImageGenerationOptions | None = None,
+        stream: Optional[Literal[False]] | Literal[True] | NotGiven = NOT_GIVEN,
     ) -> ImagesResponse:
         resp = self._post(
             "/images/generations",
@@ -52,6 +138,12 @@ class Images(SyncAPIResource):
                 "guidance_scale": guidance_scale,
                 "watermark": watermark,
                 "optimize_prompt": optimize_prompt,
+                "sequential_image_generation": sequential_image_generation,
+                "sequential_image_generation_options": (
+                    sequential_image_generation_options.model_dump(mode="json")
+                    if sequential_image_generation_options is not None else None
+                ),
+                "stream": stream,
             },
             options=make_request_options(
                 extra_headers=extra_headers,
@@ -60,19 +152,90 @@ class Images(SyncAPIResource):
                 timeout=timeout,
             ),
             cast_to=ImagesResponse,
+            stream=stream or False,
+            stream_cls=Stream[ImageGenStreamEvent],
         )
 
         return resp
 
 
 class AsyncImages(AsyncAPIResource):
+    @overload
+    async def generate(
+            self,
+            *,
+            model: str,
+            prompt: str,
+            image: str | list[str] | None = None,
+            response_format: str | None = None,
+            size: str | None = None,
+            seed: int | None = None,
+            guidance_scale: float | None = None,
+            watermark: bool | None = None,
+            optimize_prompt: bool | None = None,
+            extra_headers: Headers | None = None,
+            extra_query: Query | None = None,
+            extra_body: Body | None = None,
+            timeout: float | httpx.Timeout | None = None,
+            sequential_image_generation: str | None = None,
+            sequential_image_generation_options: SequentialImageGenerationOptions | None = None,
+            stream: Optional[Literal[False]] | NotGiven = NOT_GIVEN,
+    ) -> ImagesResponse:
+        ...
+
+    @overload
+    async def generate(
+            self,
+            *,
+            model: str,
+            prompt: str,
+            image: str | list[str] | None = None,
+            response_format: str | None = None,
+            size: str | None = None,
+            seed: int | None = None,
+            guidance_scale: float | None = None,
+            watermark: bool | None = None,
+            optimize_prompt: bool | None = None,
+            extra_headers: Headers | None = None,
+            extra_query: Query | None = None,
+            extra_body: Body | None = None,
+            timeout: float | httpx.Timeout | None = None,
+            sequential_image_generation: str | None = None,
+            sequential_image_generation_options: SequentialImageGenerationOptions | None = None,
+            stream: Literal[True],
+    ) -> Stream[ImageGenStreamEvent]:
+        ...
+
+    @overload
+    async def generate(
+            self,
+            *,
+            model: str,
+            prompt: str,
+            image: str | list[str] | None = None,
+            response_format: str | None = None,
+            size: str | None = None,
+            seed: int | None = None,
+            guidance_scale: float | None = None,
+            watermark: bool | None = None,
+            optimize_prompt: bool | None = None,
+            extra_headers: Headers | None = None,
+            extra_query: Query | None = None,
+            extra_body: Body | None = None,
+            timeout: float | httpx.Timeout | None = None,
+            sequential_image_generation: str | None = None,
+            sequential_image_generation_options: SequentialImageGenerationOptions | None = None,
+            stream: bool,
+    ) -> ImagesResponse | Stream[ImageGenStreamEvent]:
+        ...
+
     @async_apikey_required
     async def generate(
         self,
         *,
         model: str,
         prompt: str,
-        image: str | None = None,
+        image: str | list[str] | None = None,
         response_format: str | None = None,
         size: str | None = None,
         seed: int | None = None,
@@ -83,7 +246,10 @@ class AsyncImages(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None = None,
-    ) -> ImagesResponse:
+        sequential_image_generation: str | None = None,
+        sequential_image_generation_options: SequentialImageGenerationOptions | None = None,
+        stream: Optional[Literal[False]] | Literal[True] | NotGiven = NOT_GIVEN,
+    ) -> ImagesResponse | Stream[ImageGenStreamEvent]:
         return await self._post(
             "/images/generations",
             body={
@@ -96,6 +262,12 @@ class AsyncImages(AsyncAPIResource):
                 "guidance_scale": guidance_scale,
                 "watermark": watermark,
                 "optimize_prompt": optimize_prompt,
+                "sequential_image_generation": sequential_image_generation,
+                "sequential_image_generation_options": (
+                    sequential_image_generation_options.model_dump(mode="json")
+                    if sequential_image_generation_options is not None else None
+                ),
+                "stream": stream,
             },
             options=make_request_options(
                 extra_headers=extra_headers,
@@ -104,4 +276,6 @@ class AsyncImages(AsyncAPIResource):
                 timeout=timeout,
             ),
             cast_to=ImagesResponse,
+            stream=stream or False,
+            stream_cls=Stream[ImageGenStreamEvent],
         )

volcenginesdkarkruntime/types/images/__init__.py

@@ -10,6 +10,7 @@
 #
 # This modified file is released under the same license.
 
-from .images import ImagesResponse
+from .images import SequentialImageGenerationOptions, ImagesResponse
 
-__all__ = ["ImagesResponse"]
+
+__all__ = ["SequentialImageGenerationOptions", "ImagesResponse"]

volcenginesdkarkruntime/types/images/image_gen_completed_event.py

@@ -0,0 +1,51 @@
+
+# Copyright (c) [2025] [OpenAI]
+# Copyright (c) [2025] [ByteDance Ltd. and/or its affiliates.]
+# SPDX-License-Identifier: Apache-2.0
+#
+# This file has been modified by [ByteDance Ltd. and/or its affiliates.] on 2025.7
+#
+# Original file was released under Apache License Version 2.0, with the full license text
+# available at https://github.com/openai/openai-python/blob/main/LICENSE.
+#
+# This modified file is released under the same license.
+
+from typing import List
+
+from volcenginesdkarkruntime._models import BaseModel
+
+__all__ = ["ImageGenCompletedEvent"]
+
+
+class Usage(BaseModel):
+    generated_images: int
+    """The number of images generated."""
+    output_tokens: int
+    """The number of output tokens."""
+    total_tokens: int
+    """The total number of tokens."""
+
+
+class Error(BaseModel):
+    message: str
+    """The reason for failed image generation"""
+
+    code: str
+    """The error code for failed image generation"""
+
+
+class ImageGenCompletedEvent(BaseModel):
+    type: str
+    """The type of image generating event."""
+
+    model: str
+    """The model used to generated the images."""
+
+    error: Error
+    """The error body, if applicable."""
+
+    usage: Usage
+    """The usage information for the generation of images."""
+
+    created_at: int
+    """The Unix timestamp when the image was generated."""

volcenginesdkarkruntime/types/images/image_gen_generating_event.py

@@ -0,0 +1,53 @@
+
+# Copyright (c) [2025] [OpenAI]
+# Copyright (c) [2025] [ByteDance Ltd. and/or its affiliates.]
+# SPDX-License-Identifier: Apache-2.0
+#
+# This file has been modified by [ByteDance Ltd. and/or its affiliates.] on 2025.7
+#
+# Original file was released under Apache License Version 2.0, with the full license text
+# available at https://github.com/openai/openai-python/blob/main/LICENSE.
+#
+# This modified file is released under the same license.
+
+from typing_extensions import Literal
+
+from typing import List
+
+from volcenginesdkarkruntime._models import BaseModel
+
+__all__ = ["ImageGenGeneratingEvent"]
+
+
+class Error(BaseModel):
+    message: str
+    """The reason for failed image generation"""
+
+    code: str
+    """The error code for failed image generation"""
+
+
+class ImageGenGeneratingEvent(BaseModel):
+    type: str
+    """The type of image generating event."""
+
+    model: str
+    """The model used to generated the images."""
+
+    url: str
+    """The URL of the generated image, if any."""
+
+    b64_json: str
+    """The Base 64 encoded string of the generated image, if any."""
+
+    size: str
+    """The size of the generated image."""
+
+    error: Error
+    """The error body, if applicable."""
+
+    image_index: int
+    """The index of the image."""
+
+    created_at: int
+    """The Unix timestamp when the image was generated."""

volcenginesdkarkruntime/types/images/image_gen_stream_event.py

@@ -0,0 +1,24 @@
+
+# Copyright (c) [2025] [OpenAI]
+# Copyright (c) [2025] [ByteDance Ltd. and/or its affiliates.]
+# SPDX-License-Identifier: Apache-2.0
+#
+# This file has been modified by [ByteDance Ltd. and/or its affiliates.] on 2025.7
+#
+# Original file was released under Apache License Version 2.0, with the full license text
+# available at https://github.com/openai/openai-python/blob/main/LICENSE.
+#
+# This modified file is released under the same license.
+
+from typing import Union
+from typing_extensions import Annotated, TypeAlias
+
+from volcenginesdkarkruntime._utils import PropertyInfo
+from .image_gen_completed_event import ImageGenCompletedEvent
+from .image_gen_generating_event import ImageGenGeneratingEvent
+
+__all__ = ["ImageGenStreamEvent"]
+
+ImageGenStreamEvent: TypeAlias = Annotated[
+    Union[ImageGenGeneratingEvent, ImageGenCompletedEvent], PropertyInfo(discriminator="type")
+]

volcenginesdkarkruntime/types/images/images.py

@@ -10,13 +10,17 @@
 #
 # This modified file is released under the same license.
 
-from typing import List
+from typing import List, Optional
 
 from volcenginesdkarkruntime._models import BaseModel
 
-__all__ = ["ImagesResponse"]
+__all__ = ["SequentialImageGenerationOptions", "ImagesResponse"]
 
 
+class SequentialImageGenerationOptions(BaseModel):
+    max_images: Optional[int] = None
+    """ Maximum number of images to generate in this request; effective only when the multi-image feature is enabled """
+
 class Usage(BaseModel):
     generated_images: int
     """The number of images generated."""