refactor: AITags to singular AITag schema with array items pattern

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 48
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/imagekit-inc%2Fimagekit-7c4c23556be689ded6bcafd05e1645b82239521c9c841c0f7e76336e2eefcffa.yml
-openapi_spec_hash: eca5b039a0066c6536296248c3a80854
-config_hash: f914ebc9670f6e7c7751660caa4e5556
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/imagekit-inc%2Fimagekit-70c42eda2bee929830b2537f758400a58dded1f1ef5686a286e2469c35a041a0.yml
+openapi_spec_hash: cdaeed824e91657b45092765cf55eb42
+config_hash: e3c2679d25f6235381dfb11962fbf3d9

src/imagekitio/types/beta/v2/file_upload_response.py

@@ -12,6 +12,11 @@
 
 
 class AITag(BaseModel):
+    """AI-generated tag associated with an image.
+
+    These tags can be added using the `google-auto-tagging` or `aws-auto-tagging` extensions.
+    """
+
     confidence: Optional[float] = None
     """Confidence score of the tag."""
 
@@ -121,11 +126,7 @@ class FileUploadResponse(BaseModel):
     """Object containing details of a successful upload."""
 
     ai_tags: Optional[List[AITag]] = FieldInfo(alias="AITags", default=None)
-    """Array of `AITags` associated with the image.
-
-    If no `AITags` are set, it will be null. These tags can be added using the
-    `google-auto-tagging` or `aws-auto-tagging` extensions.
-    """
+    """An array of tags assigned to the uploaded file by auto tagging."""
 
     audio_codec: Optional[str] = FieldInfo(alias="audioCodec", default=None)
     """The audio codec used in the video (only for video)."""

src/imagekitio/types/file.py

@@ -12,6 +12,11 @@
 
 
 class AITag(BaseModel):
+    """AI-generated tag associated with an image.
+
+    These tags can be added using the `google-auto-tagging` or `aws-auto-tagging` extensions.
+    """
+
     confidence: Optional[float] = None
     """Confidence score of the tag."""
 
@@ -93,10 +98,9 @@ class File(BaseModel):
     """Object containing details of a file or file version."""
 
     ai_tags: Optional[List[AITag]] = FieldInfo(alias="AITags", default=None)
-    """Array of `AITags` associated with the image.
+    """Array of AI-generated tags associated with the image.
 
-    If no `AITags` are set, it will be null. These tags can be added using the
-    `google-auto-tagging` or `aws-auto-tagging` extensions.
+    If no AITags are set, it will be null.
     """
 
     audio_codec: Optional[str] = FieldInfo(alias="audioCodec", default=None)
@@ -115,13 +119,7 @@ class File(BaseModel):
     """An string with custom coordinates of the file."""
 
     custom_metadata: Optional[Dict[str, object]] = FieldInfo(alias="customMetadata", default=None)
-    """A key-value data associated with the asset.
-
-    Use `responseField` in API request to get `customMetadata` in the upload API
-    response. Before setting any custom metadata on an asset, you have to create the
-    field using custom metadata fields API. Send `customMetadata` in
-    `responseFields` in API request to get the value of this field.
-    """
+    """An object with custom metadata for the file."""
 
     description: Optional[str] = None
     """Optional text to describe the contents of the file.
@@ -135,9 +133,7 @@ class File(BaseModel):
     embedded_metadata: Optional[Dict[str, object]] = FieldInfo(alias="embeddedMetadata", default=None)
     """Consolidated embedded metadata associated with the file.
 
-    It includes exif, iptc, and xmp data. Send `embeddedMetadata` in
-    `responseFields` in API request to get embeddedMetadata in the upload API
-    response.
+    It includes exif, iptc, and xmp data.
     """
 
     file_id: Optional[str] = FieldInfo(alias="fileId", default=None)
@@ -213,7 +209,7 @@ class File(BaseModel):
     """URL of the file."""
 
     version_info: Optional[VersionInfo] = FieldInfo(alias="versionInfo", default=None)
-    """An object containing the file or file version's `id` (versionId) and `name`."""
+    """An object with details of the file version."""
 
     video_codec: Optional[str] = FieldInfo(alias="videoCodec", default=None)
     """The video codec used in the video (only for video)."""

src/imagekitio/types/file_upload_response.py

@@ -12,6 +12,11 @@
 
 
 class AITag(BaseModel):
+    """AI-generated tag associated with an image.
+
+    These tags can be added using the `google-auto-tagging` or `aws-auto-tagging` extensions.
+    """
+
     confidence: Optional[float] = None
     """Confidence score of the tag."""
 
@@ -121,11 +126,7 @@ class FileUploadResponse(BaseModel):
     """Object containing details of a successful upload."""
 
     ai_tags: Optional[List[AITag]] = FieldInfo(alias="AITags", default=None)
-    """Array of `AITags` associated with the image.
-
-    If no `AITags` are set, it will be null. These tags can be added using the
-    `google-auto-tagging` or `aws-auto-tagging` extensions.
-    """
+    """An array of tags assigned to the uploaded file by auto tagging."""
 
     audio_codec: Optional[str] = FieldInfo(alias="audioCodec", default=None)
     """The audio codec used in the video (only for video)."""

src/imagekitio/types/upload_pre_transform_success_event.py

@@ -22,6 +22,11 @@
 
 
 class UploadPreTransformSuccessEventDataAITag(BaseModel):
+    """AI-generated tag associated with an image.
+
+    These tags can be added using the `google-auto-tagging` or `aws-auto-tagging` extensions.
+    """
+
     confidence: Optional[float] = None
     """Confidence score of the tag."""
 
@@ -131,11 +136,7 @@ class UploadPreTransformSuccessEventData(BaseModel):
     """Object containing details of a successful upload."""
 
     ai_tags: Optional[List[UploadPreTransformSuccessEventDataAITag]] = FieldInfo(alias="AITags", default=None)
-    """Array of `AITags` associated with the image.
-
-    If no `AITags` are set, it will be null. These tags can be added using the
-    `google-auto-tagging` or `aws-auto-tagging` extensions.
-    """
+    """An array of tags assigned to the uploaded file by auto tagging."""
 
     audio_codec: Optional[str] = FieldInfo(alias="audioCodec", default=None)
     """The audio codec used in the video (only for video)."""