ogx_open_client 1.0.3.dev0__py3-none-any.whl

ogx_client/models/open_ai_attach_file_request.py

@@ -0,0 +1,164 @@
+# coding: utf-8
+
+# Copyright (c) The OGX Contributors.
+# All rights reserved.
+#
+# This source code is licensed under the terms described in the LICENSE file in
+# the root directory of this source tree.
+
+"""
+    OGX Specification - Stable & Experimental APIs
+
+    This is the specification of the OGX that provides                     a set of endpoints and their corresponding interfaces that are     tailored to                     best leverage Llama Models.      **🔗 COMBINED**: This specification includes both stable production-ready APIs     and experimental pre-release APIs. Use stable APIs for production deployments     and experimental APIs for testing new features.
+
+    The version of the OpenAPI document: v1
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, StrictStr
+from typing import Any, ClassVar, Dict, List, Optional
+from ogx_client.models.string_number_boolean import StringNumberBoolean
+from ogx_client.models.vector_store_chunking_strategy_auto_vector_store_chunking_strategy_static_vector_store_chunking_strategy_contextual import VectorStoreChunkingStrategyAutoVectorStoreChunkingStrategyStaticVectorStoreChunkingStrategyContextual
+from typing import Any, ClassVar
+from typing_extensions import Self
+
+class OpenAIAttachFileRequest(BaseModel):
+    """
+    Request body for attaching a file to a vector store.
+    """ # noqa: E501
+    file_id: StrictStr = Field(description="The ID of the file to attach.")
+    attributes: Optional[Dict[str, StringNumberBoolean]] = Field(default=None, description="Set of 16 key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format, and querying for objects via API or the dashboard. Keys are strings with a maximum length of 64 characters. Values are strings with a maximum length of 512 characters, booleans, or numbers.")
+    chunking_strategy: Optional[VectorStoreChunkingStrategyAutoVectorStoreChunkingStrategyStaticVectorStoreChunkingStrategyContextual] = None
+    __properties: ClassVar[list[str]] = ["file_id", "attributes", "chunking_strategy"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+
+    def __getattribute__(self, name):
+        """Override to automatically unwrap OneOf/AnyOf instances."""
+        value = super().__getattribute__(name)
+
+        # Unwrap OneOf/AnyOf wrappers directly
+        if hasattr(value, 'actual_instance') and value.actual_instance is not None:
+            return value.actual_instance
+
+        # If the value is a dict, unwrap any OneOf instances in its values
+        if isinstance(value, dict):
+            unwrapped = {}
+            for k, v in value.items():
+                # Check if this is a OneOf wrapper with actual_instance
+                if hasattr(v, 'actual_instance') and v.actual_instance is not None:
+                    unwrapped[k] = v.actual_instance
+                else:
+                    unwrapped[k] = v
+            return unwrapped
+
+        return value
+
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Self | None:
+        """Create an instance of OpenAIAttachFileRequest from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # override the default output from pydantic by calling `to_dict()` of each value in attributes (dict)
+        _field_dict = {}
+        if self.attributes:
+            for _key_attributes in self.attributes:
+                _val = self.attributes[_key_attributes]
+                if _val is None:
+                    _field_dict[_key_attributes] = None
+                elif hasattr(_val, 'to_dict'):
+                    _field_dict[_key_attributes] = _val.to_dict()
+                else:
+                    _field_dict[_key_attributes] = _val
+            _dict['attributes'] = _field_dict
+        # override the default output from pydantic by calling `to_dict()` of chunking_strategy
+        if self.chunking_strategy:
+            if hasattr(self.chunking_strategy, 'to_dict'):
+                _dict_value = self.chunking_strategy.to_dict()
+                # Only include if to_dict() returns a non-None value (handles oneOf wrappers with actual_instance=None)
+                if _dict_value is not None:
+                    _dict['chunking_strategy'] = _dict_value
+                elif 'chunking_strategy' in _dict:
+                    # Remove from dict if to_dict() returned None (oneOf wrapper with no actual instance)
+                    del _dict['chunking_strategy']
+            else:
+                _dict['chunking_strategy'] = self.chunking_strategy
+        # set to None if attributes (nullable) is None
+        # and model_fields_set contains the field
+        if self.attributes is None and "attributes" in self.model_fields_set:
+            _dict['attributes'] = None
+
+        # set to None if chunking_strategy (nullable) is None
+        # and model_fields_set contains the field
+        if self.chunking_strategy is None and "chunking_strategy" in self.model_fields_set:
+            _dict['chunking_strategy'] = None
+
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: dict[str, Any] | None) -> Self | None:
+        """Create an instance of OpenAIAttachFileRequest from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            k: v for k, v in {
+            "file_id": obj.get("file_id"),
+            "attributes": dict(
+                (_k, StringNumberBoolean.from_dict(_v))
+                for _k, _v in obj["attributes"].items()
+            )
+            if obj.get("attributes") is not None
+            else None,
+            "chunking_strategy": VectorStoreChunkingStrategyAutoVectorStoreChunkingStrategyStaticVectorStoreChunkingStrategyContextual.from_dict(obj["chunking_strategy"]) if obj.get("chunking_strategy") is not None else None,
+            }.items() if k in obj
+        })
+        return _obj
+
+

ogx_client/models/open_ai_chat_completion.py

@@ -0,0 +1,173 @@
+# coding: utf-8
+
+# Copyright (c) The OGX Contributors.
+# All rights reserved.
+#
+# This source code is licensed under the terms described in the LICENSE file in
+# the root directory of this source tree.
+
+"""
+    OGX Specification - Stable & Experimental APIs
+
+    This is the specification of the OGX that provides                     a set of endpoints and their corresponding interfaces that are     tailored to                     best leverage Llama Models.      **🔗 COMBINED**: This specification includes both stable production-ready APIs     and experimental pre-release APIs. Use stable APIs for production deployments     and experimental APIs for testing new features.
+
+    The version of the OpenAPI document: v1
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, StrictStr, field_validator
+from typing import Any, ClassVar, Dict, List, Optional
+from typing_extensions import Annotated
+from ogx_client.models.open_ai_chat_completion_usage import OpenAIChatCompletionUsage
+from ogx_client.models.open_ai_choice import OpenAIChoice
+from typing import Any, ClassVar
+from typing_extensions import Self
+
+class OpenAIChatCompletion(BaseModel):
+    """
+    Response from an OpenAI-compatible chat completion request.
+    """ # noqa: E501
+    id: StrictStr = Field(description="The ID of the chat completion.")
+    choices: Annotated[List[OpenAIChoice], Field(min_length=1)] = Field(description="List of choices.")
+    object: Optional[StrictStr] = Field(default=None, description="The object type.")
+    created: Annotated[int, Field(strict=True, ge=0)] = Field(description="The Unix timestamp in seconds when the chat completion was created.")
+    model: StrictStr = Field(description="The model that was used to generate the chat completion.")
+    service_tier: Optional[StrictStr] = None
+    system_fingerprint: Optional[StrictStr] = Field(default=None, description="System fingerprint for this completion.")
+    usage: Optional[OpenAIChatCompletionUsage] = Field(default=None, description="Token usage information for the completion.")
+    __properties: ClassVar[list[str]] = ["id", "choices", "object", "created", "model", "service_tier", "system_fingerprint", "usage"]
+
+    @field_validator('object')
+    def object_validate_enum(cls, value):
+        """Validates the enum"""
+        if value is None:
+            return value
+
+        if value not in set(['chat.completion']):
+            raise ValueError("must be one of enum values ('chat.completion')")
+        return value
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+
+    def __getattribute__(self, name):
+        """Override to automatically unwrap OneOf/AnyOf instances."""
+        value = super().__getattribute__(name)
+
+        # Unwrap OneOf/AnyOf wrappers directly
+        if hasattr(value, 'actual_instance') and value.actual_instance is not None:
+            return value.actual_instance
+
+        # If the value is a dict, unwrap any OneOf instances in its values
+        if isinstance(value, dict):
+            unwrapped = {}
+            for k, v in value.items():
+                # Check if this is a OneOf wrapper with actual_instance
+                if hasattr(v, 'actual_instance') and v.actual_instance is not None:
+                    unwrapped[k] = v.actual_instance
+                else:
+                    unwrapped[k] = v
+            return unwrapped
+
+        return value
+
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Self | None:
+        """Create an instance of OpenAIChatCompletion from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # override the default output from pydantic by calling `to_dict()` of each item in choices (list)
+        _items = []
+        if self.choices:
+            for _item_choices in self.choices:
+                if _item_choices:
+                    if hasattr(_item_choices, 'to_dict'):
+                        _items.append(_item_choices.to_dict())
+                    else:
+                        _items.append(_item_choices)
+            _dict['choices'] = _items
+        # override the default output from pydantic by calling `to_dict()` of usage
+        if self.usage:
+            if hasattr(self.usage, 'to_dict'):
+                _dict_value = self.usage.to_dict()
+                # Only include if to_dict() returns a non-None value (handles oneOf wrappers with actual_instance=None)
+                if _dict_value is not None:
+                    _dict['usage'] = _dict_value
+                elif 'usage' in _dict:
+                    # Remove from dict if to_dict() returned None (oneOf wrapper with no actual instance)
+                    del _dict['usage']
+            else:
+                _dict['usage'] = self.usage
+        # set to None if service_tier (nullable) is None
+        # and model_fields_set contains the field
+        if self.service_tier is None and "service_tier" in self.model_fields_set:
+            _dict['service_tier'] = None
+
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: dict[str, Any] | None) -> Self | None:
+        """Create an instance of OpenAIChatCompletion from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            k: v for k, v in {
+            "id": obj.get("id"),
+            "choices": [OpenAIChoice.from_dict(_item) for _item in obj["choices"]] if obj.get("choices") is not None else None,
+            "object": obj.get("object"),
+            "created": obj.get("created"),
+            "model": obj.get("model"),
+            "service_tier": obj.get("service_tier"),
+            "system_fingerprint": obj.get("system_fingerprint"),
+            "usage": OpenAIChatCompletionUsage.from_dict(obj["usage"]) if obj.get("usage") is not None else None,
+            }.items() if k in obj
+        })
+        return _obj
+
+

ogx_client/models/open_ai_chat_completion_chunk.py

@@ -0,0 +1,173 @@
+# coding: utf-8
+
+# Copyright (c) The OGX Contributors.
+# All rights reserved.
+#
+# This source code is licensed under the terms described in the LICENSE file in
+# the root directory of this source tree.
+
+"""
+    OGX Specification - Stable & Experimental APIs
+
+    This is the specification of the OGX that provides                     a set of endpoints and their corresponding interfaces that are     tailored to                     best leverage Llama Models.      **🔗 COMBINED**: This specification includes both stable production-ready APIs     and experimental pre-release APIs. Use stable APIs for production deployments     and experimental APIs for testing new features.
+
+    The version of the OpenAPI document: v1
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, StrictStr, field_validator
+from typing import Any, ClassVar, Dict, List, Optional
+from typing_extensions import Annotated
+from ogx_client.models.open_ai_chat_completion_usage import OpenAIChatCompletionUsage
+from ogx_client.models.open_ai_chunk_choice import OpenAIChunkChoice
+from typing import Any, ClassVar
+from typing_extensions import Self
+
+class OpenAIChatCompletionChunk(BaseModel):
+    """
+    Chunk from a streaming response to an OpenAI-compatible chat completion request.
+    """ # noqa: E501
+    id: StrictStr = Field(description="The ID of the chat completion.")
+    choices: List[OpenAIChunkChoice] = Field(description="List of choices.")
+    object: Optional[StrictStr] = Field(default=None, description="The object type.")
+    created: Annotated[int, Field(strict=True, ge=0)] = Field(description="The Unix timestamp in seconds when the chat completion was created.")
+    model: StrictStr = Field(description="The model that was used to generate the chat completion.")
+    service_tier: Optional[StrictStr] = None
+    system_fingerprint: Optional[StrictStr] = Field(default=None, description="System fingerprint for this completion chunk.")
+    usage: Optional[OpenAIChatCompletionUsage] = Field(default=None, description="Token usage information (typically included in final chunk with stream_options).")
+    __properties: ClassVar[list[str]] = ["id", "choices", "object", "created", "model", "service_tier", "system_fingerprint", "usage"]
+
+    @field_validator('object')
+    def object_validate_enum(cls, value):
+        """Validates the enum"""
+        if value is None:
+            return value
+
+        if value not in set(['chat.completion.chunk']):
+            raise ValueError("must be one of enum values ('chat.completion.chunk')")
+        return value
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+
+    def __getattribute__(self, name):
+        """Override to automatically unwrap OneOf/AnyOf instances."""
+        value = super().__getattribute__(name)
+
+        # Unwrap OneOf/AnyOf wrappers directly
+        if hasattr(value, 'actual_instance') and value.actual_instance is not None:
+            return value.actual_instance
+
+        # If the value is a dict, unwrap any OneOf instances in its values
+        if isinstance(value, dict):
+            unwrapped = {}
+            for k, v in value.items():
+                # Check if this is a OneOf wrapper with actual_instance
+                if hasattr(v, 'actual_instance') and v.actual_instance is not None:
+                    unwrapped[k] = v.actual_instance
+                else:
+                    unwrapped[k] = v
+            return unwrapped
+
+        return value
+
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Self | None:
+        """Create an instance of OpenAIChatCompletionChunk from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # override the default output from pydantic by calling `to_dict()` of each item in choices (list)
+        _items = []
+        if self.choices:
+            for _item_choices in self.choices:
+                if _item_choices:
+                    if hasattr(_item_choices, 'to_dict'):
+                        _items.append(_item_choices.to_dict())
+                    else:
+                        _items.append(_item_choices)
+            _dict['choices'] = _items
+        # override the default output from pydantic by calling `to_dict()` of usage
+        if self.usage:
+            if hasattr(self.usage, 'to_dict'):
+                _dict_value = self.usage.to_dict()
+                # Only include if to_dict() returns a non-None value (handles oneOf wrappers with actual_instance=None)
+                if _dict_value is not None:
+                    _dict['usage'] = _dict_value
+                elif 'usage' in _dict:
+                    # Remove from dict if to_dict() returned None (oneOf wrapper with no actual instance)
+                    del _dict['usage']
+            else:
+                _dict['usage'] = self.usage
+        # set to None if service_tier (nullable) is None
+        # and model_fields_set contains the field
+        if self.service_tier is None and "service_tier" in self.model_fields_set:
+            _dict['service_tier'] = None
+
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: dict[str, Any] | None) -> Self | None:
+        """Create an instance of OpenAIChatCompletionChunk from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            k: v for k, v in {
+            "id": obj.get("id"),
+            "choices": [OpenAIChunkChoice.from_dict(_item) for _item in obj["choices"]] if obj.get("choices") is not None else None,
+            "object": obj.get("object"),
+            "created": obj.get("created"),
+            "model": obj.get("model"),
+            "service_tier": obj.get("service_tier"),
+            "system_fingerprint": obj.get("system_fingerprint"),
+            "usage": OpenAIChatCompletionUsage.from_dict(obj["usage"]) if obj.get("usage") is not None else None,
+            }.items() if k in obj
+        })
+        return _obj
+
+

ogx_client/models/open_ai_chat_completion_content_part_image_param.py

@@ -0,0 +1,144 @@
+# coding: utf-8
+
+# Copyright (c) The OGX Contributors.
+# All rights reserved.
+#
+# This source code is licensed under the terms described in the LICENSE file in
+# the root directory of this source tree.
+
+"""
+    OGX Specification - Stable & Experimental APIs
+
+    This is the specification of the OGX that provides                     a set of endpoints and their corresponding interfaces that are     tailored to                     best leverage Llama Models.      **🔗 COMBINED**: This specification includes both stable production-ready APIs     and experimental pre-release APIs. Use stable APIs for production deployments     and experimental APIs for testing new features.
+
+    The version of the OpenAPI document: v1
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, StrictStr, field_validator
+from typing import Any, ClassVar, Dict, List, Optional
+from ogx_client.models.open_ai_image_url import OpenAIImageURL
+from typing import Any, ClassVar
+from typing_extensions import Self
+
+class OpenAIChatCompletionContentPartImageParam(BaseModel):
+    """
+    Image content part for OpenAI-compatible chat completion messages.
+    """ # noqa: E501
+    type: Optional[StrictStr] = Field(default=None, description="Must be 'image_url' to identify this as image content.")
+    image_url: OpenAIImageURL = Field(description="Image URL specification and processing details.")
+    __properties: ClassVar[list[str]] = ["type", "image_url"]
+
+    @field_validator('type')
+    def type_validate_enum(cls, value):
+        """Validates the enum"""
+        if value is None:
+            return value
+
+        if value not in set(['image_url']):
+            raise ValueError("must be one of enum values ('image_url')")
+        return value
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+
+    def __getattribute__(self, name):
+        """Override to automatically unwrap OneOf/AnyOf instances."""
+        value = super().__getattribute__(name)
+
+        # Unwrap OneOf/AnyOf wrappers directly
+        if hasattr(value, 'actual_instance') and value.actual_instance is not None:
+            return value.actual_instance
+
+        # If the value is a dict, unwrap any OneOf instances in its values
+        if isinstance(value, dict):
+            unwrapped = {}
+            for k, v in value.items():
+                # Check if this is a OneOf wrapper with actual_instance
+                if hasattr(v, 'actual_instance') and v.actual_instance is not None:
+                    unwrapped[k] = v.actual_instance
+                else:
+                    unwrapped[k] = v
+            return unwrapped
+
+        return value
+
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Self | None:
+        """Create an instance of OpenAIChatCompletionContentPartImageParam from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # override the default output from pydantic by calling `to_dict()` of image_url
+        if self.image_url:
+            if hasattr(self.image_url, 'to_dict'):
+                _dict_value = self.image_url.to_dict()
+                # Only include if to_dict() returns a non-None value (handles oneOf wrappers with actual_instance=None)
+                if _dict_value is not None:
+                    _dict['image_url'] = _dict_value
+                elif 'image_url' in _dict:
+                    # Remove from dict if to_dict() returned None (oneOf wrapper with no actual instance)
+                    del _dict['image_url']
+            else:
+                _dict['image_url'] = self.image_url
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: dict[str, Any] | None) -> Self | None:
+        """Create an instance of OpenAIChatCompletionContentPartImageParam from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            k: v for k, v in {
+            "type": obj.get("type"),
+            "image_url": OpenAIImageURL.from_dict(obj["image_url"]) if obj.get("image_url") is not None else None,
+            }.items() if k in obj
+        })
+        return _obj
+
+