orq-ai-sdk 4.2.0rc28__py3-none-any.whl → 4.2.6__py3-none-any.whl

orq_ai_sdk/models/getonepromptop.py

@@ -1,6 +1,30 @@
 """Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
 
 from __future__ import annotations
+from .audiocontentpartschema import (
+    AudioContentPartSchema,
+    AudioContentPartSchemaTypedDict,
+)
+from .filecontentpartschema import FileContentPartSchema, FileContentPartSchemaTypedDict
+from .imagecontentpartschema import (
+    ImageContentPartSchema,
+    ImageContentPartSchemaTypedDict,
+)
+from .reasoningpartschema import ReasoningPartSchema, ReasoningPartSchemaTypedDict
+from .redactedreasoningpartschema import (
+    RedactedReasoningPartSchema,
+    RedactedReasoningPartSchemaTypedDict,
+)
+from .refusalpartschema import RefusalPartSchema, RefusalPartSchemaTypedDict
+from .textcontentpartschema import TextContentPartSchema, TextContentPartSchemaTypedDict
+from .thinkingconfigdisabledschema import (
+    ThinkingConfigDisabledSchema,
+    ThinkingConfigDisabledSchemaTypedDict,
+)
+from .thinkingconfigenabledschema import (
+    ThinkingConfigEnabledSchema,
+    ThinkingConfigEnabledSchemaTypedDict,
+)
 from orq_ai_sdk.types import (
     BaseModel,
     Nullable,
@@ -12,7 +36,13 @@ from orq_ai_sdk.utils import FieldMetadata, PathParamMetadata, get_discriminator
 import pydantic
 from pydantic import Discriminator, Tag, model_serializer
 from typing import Any, Dict, List, Literal, Optional, Union
-from typing_extensions import Annotated, NotRequired, TypeAliasType, TypedDict
+from typing_extensions import (
+    Annotated,
+    NotRequired,
+    TypeAliasType,
+    TypedDict,
+    deprecated,
+)
 
 
 class GetOnePromptRequestTypedDict(TypedDict):
@@ -38,6 +68,7 @@ GetOnePromptModelType = Literal[
     "tts",
     "stt",
     "rerank",
+    "ocr",
     "moderation",
     "vision",
 ]
@@ -78,39 +109,43 @@ GetOnePromptResponseFormat4 = Literal[
 ]
 
 
-GetOnePromptResponseFormatPromptsResponseType = Literal["text",]
+GetOnePromptResponseFormatPromptsResponse200ApplicationJSONResponseBodyType = Literal[
+    "text",
+]
 
 
 class GetOnePromptResponseFormat3TypedDict(TypedDict):
-    type: GetOnePromptResponseFormatPromptsResponseType
+    type: GetOnePromptResponseFormatPromptsResponse200ApplicationJSONResponseBodyType
 
 
 class GetOnePromptResponseFormat3(BaseModel):
-    type: GetOnePromptResponseFormatPromptsResponseType
+    type: GetOnePromptResponseFormatPromptsResponse200ApplicationJSONResponseBodyType
 
 
-GetOnePromptResponseFormatPromptsType = Literal["json_object",]
+GetOnePromptResponseFormatPromptsResponse200ApplicationJSONType = Literal[
+    "json_object",
+]
 
 
 class GetOnePromptResponseFormat2TypedDict(TypedDict):
-    type: GetOnePromptResponseFormatPromptsType
+    type: GetOnePromptResponseFormatPromptsResponse200ApplicationJSONType
 
 
 class GetOnePromptResponseFormat2(BaseModel):
-    type: GetOnePromptResponseFormatPromptsType
+    type: GetOnePromptResponseFormatPromptsResponse200ApplicationJSONType
 
 
-GetOnePromptResponseFormatType = Literal["json_schema",]
+GetOnePromptResponseFormatPromptsResponse200Type = Literal["json_schema",]
 
 
-class GetOnePromptResponseFormatJSONSchemaTypedDict(TypedDict):
+class GetOnePromptResponseFormatPromptsResponseJSONSchemaTypedDict(TypedDict):
     name: str
     schema_: Dict[str, Any]
     description: NotRequired[str]
     strict: NotRequired[bool]
 
 
-class GetOnePromptResponseFormatJSONSchema(BaseModel):
+class GetOnePromptResponseFormatPromptsResponseJSONSchema(BaseModel):
     name: str
 
     schema_: Annotated[Dict[str, Any], pydantic.Field(alias="schema")]
@@ -119,23 +154,55 @@ class GetOnePromptResponseFormatJSONSchema(BaseModel):
 
     strict: Optional[bool] = None
 
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["description", "strict"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m
+
 
 class GetOnePromptResponseFormat1TypedDict(TypedDict):
-    type: GetOnePromptResponseFormatType
-    json_schema: GetOnePromptResponseFormatJSONSchemaTypedDict
+    type: GetOnePromptResponseFormatPromptsResponse200Type
+    json_schema: GetOnePromptResponseFormatPromptsResponseJSONSchemaTypedDict
     display_name: NotRequired[str]
 
 
 class GetOnePromptResponseFormat1(BaseModel):
-    type: GetOnePromptResponseFormatType
+    type: GetOnePromptResponseFormatPromptsResponse200Type
 
-    json_schema: GetOnePromptResponseFormatJSONSchema
+    json_schema: GetOnePromptResponseFormatPromptsResponseJSONSchema
 
     display_name: Optional[str] = None
 
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["display_name"])
+        serialized = handler(self)
+        m = {}
 
-GetOnePromptResponseFormatTypedDict = TypeAliasType(
-    "GetOnePromptResponseFormatTypedDict",
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m
+
+
+GetOnePromptPromptsResponseFormatTypedDict = TypeAliasType(
+    "GetOnePromptPromptsResponseFormatTypedDict",
     Union[
         GetOnePromptResponseFormat2TypedDict,
         GetOnePromptResponseFormat3TypedDict,
@@ -155,8 +222,8 @@ Important: when using JSON mode, you must also instruct the model to produce JSO
 """
 
 
-GetOnePromptResponseFormat = TypeAliasType(
-    "GetOnePromptResponseFormat",
+GetOnePromptPromptsResponseFormat = TypeAliasType(
+    "GetOnePromptPromptsResponseFormat",
     Union[
         GetOnePromptResponseFormat2,
         GetOnePromptResponseFormat3,
@@ -190,7 +257,7 @@ GetOnePromptEncodingFormat = Literal[
 r"""The format to return the embeddings"""
 
 
-GetOnePromptReasoningEffort = Literal[
+GetOnePromptPromptsReasoningEffort = Literal[
     "none",
     "disable",
     "minimal",
@@ -243,7 +310,7 @@ class GetOnePromptModelParametersTypedDict(TypedDict):
     r"""Only supported on `image` models."""
     style: NotRequired[str]
     r"""Only supported on `image` models."""
-    response_format: NotRequired[Nullable[GetOnePromptResponseFormatTypedDict]]
+    response_format: NotRequired[Nullable[GetOnePromptPromptsResponseFormatTypedDict]]
     r"""An object specifying the format that the model must output.
 
     Setting to `{ \"type\": \"json_schema\", \"json_schema\": {...} }` enables Structured Outputs which ensures the model will match your supplied JSON schema
@@ -256,7 +323,7 @@ class GetOnePromptModelParametersTypedDict(TypedDict):
     r"""The version of photoReal to use. Must be v1 or v2. Only available for `leonardoai` provider"""
     encoding_format: NotRequired[GetOnePromptEncodingFormat]
     r"""The format to return the embeddings"""
-    reasoning_effort: NotRequired[GetOnePromptReasoningEffort]
+    reasoning_effort: NotRequired[GetOnePromptPromptsReasoningEffort]
     r"""Constrains effort on reasoning for reasoning models. Reducing reasoning effort can result in faster responses and fewer tokens used on reasoning in a response."""
     budget_tokens: NotRequired[float]
     r"""Gives the model enhanced reasoning capabilities for complex tasks. A value of 0 disables thinking. The minimum budget tokens for thinking are 1024. The Budget Tokens should never exceed the Max Tokens parameter. Only supported by `Anthropic`"""
@@ -312,7 +379,7 @@ class GetOnePromptModelParameters(BaseModel):
     r"""Only supported on `image` models."""
 
     response_format: Annotated[
-        OptionalNullable[GetOnePromptResponseFormat],
+        OptionalNullable[GetOnePromptPromptsResponseFormat],
         pydantic.Field(alias="responseFormat"),
     ] = UNSET
     r"""An object specifying the format that the model must output.
@@ -333,7 +400,8 @@ class GetOnePromptModelParameters(BaseModel):
     r"""The format to return the embeddings"""
 
     reasoning_effort: Annotated[
-        Optional[GetOnePromptReasoningEffort], pydantic.Field(alias="reasoningEffort")
+        Optional[GetOnePromptPromptsReasoningEffort],
+        pydantic.Field(alias="reasoningEffort"),
     ] = None
     r"""Constrains effort on reasoning for reasoning models. Reducing reasoning effort can result in faster responses and fewer tokens used on reasoning in a response."""
 
@@ -352,51 +420,48 @@ class GetOnePromptModelParameters(BaseModel):
 
     @model_serializer(mode="wrap")
     def serialize_model(self, handler):
-        optional_fields = [
-            "temperature",
-            "maxTokens",
-            "topK",
-            "topP",
-            "frequencyPenalty",
-            "presencePenalty",
-            "numImages",
-            "seed",
-            "format",
-            "dimensions",
-            "quality",
-            "style",
-            "responseFormat",
-            "photoRealVersion",
-            "encoding_format",
-            "reasoningEffort",
-            "budgetTokens",
-            "verbosity",
-            "thinkingLevel",
-        ]
-        nullable_fields = ["responseFormat"]
-        null_default_fields = []
-
+        optional_fields = set(
+            [
+                "temperature",
+                "maxTokens",
+                "topK",
+                "topP",
+                "frequencyPenalty",
+                "presencePenalty",
+                "numImages",
+                "seed",
+                "format",
+                "dimensions",
+                "quality",
+                "style",
+                "responseFormat",
+                "photoRealVersion",
+                "encoding_format",
+                "reasoningEffort",
+                "budgetTokens",
+                "verbosity",
+                "thinkingLevel",
+            ]
+        )
+        nullable_fields = set(["responseFormat"])
         serialized = handler(self)
-
         m = {}
 
         for n, f in type(self).model_fields.items():
             k = f.alias or n
             val = serialized.get(k)
-            serialized.pop(k, None)
-
-            optional_nullable = k in optional_fields and k in nullable_fields
-            is_set = (
-                self.__pydantic_fields_set__.intersection({n})
-                or k in null_default_fields
-            )  # pylint: disable=no-member
-
-            if val is not None and val != UNSET_SENTINEL:
-                m[k] = val
-            elif val != UNSET_SENTINEL and (
-                not k in optional_fields or (optional_nullable and is_set)
-            ):
-                m[k] = val
+            is_nullable_and_explicitly_set = (
+                k in nullable_fields
+                and (self.__pydantic_fields_set__.intersection({n}))  # pylint: disable=no-member
+            )
+
+            if val != UNSET_SENTINEL:
+                if (
+                    val is not None
+                    or k not in optional_fields
+                    or is_nullable_and_explicitly_set
+                ):
+                    m[k] = val
 
         return m
 
@@ -472,6 +537,22 @@ class GetOnePrompt2File(BaseModel):
     filename: Optional[str] = None
     r"""The name of the file, used when passing the file to the model as a string."""
 
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["file_data", "uri", "mimeType", "filename"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m
+
 
 class GetOnePrompt23TypedDict(TypedDict):
     type: GetOnePrompt2PromptsResponseType
@@ -508,6 +589,22 @@ class GetOnePrompt2ImageURL(BaseModel):
     detail: Optional[str] = None
     r"""Specifies the detail level of the image. Currently only supported with OpenAI models"""
 
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["id", "detail"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m
+
 
 class GetOnePrompt22TypedDict(TypedDict):
     r"""The image part of the prompt message. Only supported with vision models."""
@@ -570,7 +667,7 @@ GetOnePromptContent = TypeAliasType(
 r"""The contents of the user message. Either the text content of the message or an array of content parts with a defined type, each can be of type `text` or `image_url` when passing in images. You can pass multiple images by adding multiple `image_url` content parts. Can be null for tool messages in certain scenarios."""
 
 
-GetOnePromptPromptsType = Literal["function",]
+GetOnePromptPromptsResponseType = Literal["function",]
 
 
 class GetOnePromptFunctionTypedDict(TypedDict):
@@ -587,14 +684,14 @@ class GetOnePromptFunction(BaseModel):
 
 
 class GetOnePromptToolCallsTypedDict(TypedDict):
-    type: GetOnePromptPromptsType
+    type: GetOnePromptPromptsResponseType
     function: GetOnePromptFunctionTypedDict
     id: NotRequired[str]
     index: NotRequired[float]
 
 
 class GetOnePromptToolCalls(BaseModel):
-    type: GetOnePromptPromptsType
+    type: GetOnePromptPromptsResponseType
 
     function: GetOnePromptFunction
 
@@ -602,6 +699,22 @@ class GetOnePromptToolCalls(BaseModel):
 
     index: Optional[float] = None
 
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["id", "index"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m
+
 
 class GetOnePromptMessagesTypedDict(TypedDict):
     role: GetOnePromptRole
@@ -625,61 +738,62 @@ class GetOnePromptMessages(BaseModel):
 
     @model_serializer(mode="wrap")
     def serialize_model(self, handler):
-        optional_fields = ["tool_calls", "tool_call_id"]
-        nullable_fields = ["content", "tool_call_id"]
-        null_default_fields = []
-
+        optional_fields = set(["tool_calls", "tool_call_id"])
+        nullable_fields = set(["content", "tool_call_id"])
         serialized = handler(self)
-
         m = {}
 
         for n, f in type(self).model_fields.items():
             k = f.alias or n
             val = serialized.get(k)
-            serialized.pop(k, None)
-
-            optional_nullable = k in optional_fields and k in nullable_fields
-            is_set = (
-                self.__pydantic_fields_set__.intersection({n})
-                or k in null_default_fields
-            )  # pylint: disable=no-member
-
-            if val is not None and val != UNSET_SENTINEL:
-                m[k] = val
-            elif val != UNSET_SENTINEL and (
-                not k in optional_fields or (optional_nullable and is_set)
-            ):
-                m[k] = val
+            is_nullable_and_explicitly_set = (
+                k in nullable_fields
+                and (self.__pydantic_fields_set__.intersection({n}))  # pylint: disable=no-member
+            )
+
+            if val != UNSET_SENTINEL:
+                if (
+                    val is not None
+                    or k not in optional_fields
+                    or is_nullable_and_explicitly_set
+                ):
+                    m[k] = val
 
         return m
 
 
+@deprecated(
+    "warning: ** DEPRECATED ** - This will be removed in a future release, please migrate away from it as soon as possible."
+)
 class GetOnePromptPromptConfigTypedDict(TypedDict):
-    r"""A list of messages compatible with the openAI schema"""
+    r"""[DEPRECATED] Use the `prompt` property instead. A list of messages compatible with the openAI schema."""
 
     messages: List[GetOnePromptMessagesTypedDict]
     stream: NotRequired[bool]
-    model: NotRequired[str]
+    model: NotRequired[Nullable[str]]
     model_db_id: NotRequired[Nullable[str]]
     r"""The id of the resource"""
     model_type: NotRequired[Nullable[GetOnePromptModelType]]
     r"""The modality of the model"""
     model_parameters: NotRequired[GetOnePromptModelParametersTypedDict]
     r"""Model Parameters: Not all parameters apply to every model"""
-    provider: NotRequired[GetOnePromptProvider]
+    provider: NotRequired[Nullable[GetOnePromptProvider]]
     integration_id: NotRequired[Nullable[str]]
     r"""The ID of the integration to use"""
     version: NotRequired[str]
 
 
+@deprecated(
+    "warning: ** DEPRECATED ** - This will be removed in a future release, please migrate away from it as soon as possible."
+)
 class GetOnePromptPromptConfig(BaseModel):
-    r"""A list of messages compatible with the openAI schema"""
+    r"""[DEPRECATED] Use the `prompt` property instead. A list of messages compatible with the openAI schema."""
 
     messages: List[GetOnePromptMessages]
 
     stream: Optional[bool] = None
 
-    model: Optional[str] = None
+    model: OptionalNullable[str] = UNSET
 
     model_db_id: OptionalNullable[str] = UNSET
     r"""The id of the resource"""
@@ -690,7 +804,7 @@ class GetOnePromptPromptConfig(BaseModel):
     model_parameters: Optional[GetOnePromptModelParameters] = None
     r"""Model Parameters: Not all parameters apply to every model"""
 
-    provider: Optional[GetOnePromptProvider] = None
+    provider: OptionalNullable[GetOnePromptProvider] = UNSET
 
     integration_id: OptionalNullable[str] = UNSET
     r"""The ID of the integration to use"""
@@ -699,201 +813,1530 @@ class GetOnePromptPromptConfig(BaseModel):
 
     @model_serializer(mode="wrap")
     def serialize_model(self, handler):
-        optional_fields = [
-            "stream",
-            "model",
-            "model_db_id",
-            "model_type",
-            "model_parameters",
-            "provider",
-            "integration_id",
-            "version",
-        ]
-        nullable_fields = ["model_db_id", "model_type", "integration_id"]
-        null_default_fields = []
-
+        optional_fields = set(
+            [
+                "stream",
+                "model",
+                "model_db_id",
+                "model_type",
+                "model_parameters",
+                "provider",
+                "integration_id",
+                "version",
+            ]
+        )
+        nullable_fields = set(
+            ["model", "model_db_id", "model_type", "provider", "integration_id"]
+        )
         serialized = handler(self)
-
         m = {}
 
         for n, f in type(self).model_fields.items():
             k = f.alias or n
             val = serialized.get(k)
-            serialized.pop(k, None)
-
-            optional_nullable = k in optional_fields and k in nullable_fields
-            is_set = (
-                self.__pydantic_fields_set__.intersection({n})
-                or k in null_default_fields
-            )  # pylint: disable=no-member
-
-            if val is not None and val != UNSET_SENTINEL:
-                m[k] = val
-            elif val != UNSET_SENTINEL and (
-                not k in optional_fields or (optional_nullable and is_set)
-            ):
-                m[k] = val
+            is_nullable_and_explicitly_set = (
+                k in nullable_fields
+                and (self.__pydantic_fields_set__.intersection({n}))  # pylint: disable=no-member
+            )
+
+            if val != UNSET_SENTINEL:
+                if (
+                    val is not None
+                    or k not in optional_fields
+                    or is_nullable_and_explicitly_set
+                ):
+                    m[k] = val
 
         return m
 
 
-GetOnePromptUseCases = Literal[
-    "Agents simulations",
-    "Agents",
-    "API interaction",
-    "Autonomous Agents",
-    "Chatbots",
-    "Classification",
-    "Code understanding",
-    "Code writing",
-    "Conversation",
-    "Documents QA",
-    "Evaluation",
-    "Extraction",
-    "Multi-modal",
-    "Self-checking",
-    "Sentiment analysis",
-    "SQL",
-    "Summarization",
-    "Tagging",
-    "Translation (document)",
-    "Translation (sentences)",
+GetOnePromptVoice = Literal[
+    "alloy",
+    "echo",
+    "fable",
+    "onyx",
+    "nova",
+    "shimmer",
 ]
+r"""The voice the model uses to respond. Supported voices are alloy, echo, fable, onyx, nova, and shimmer."""
 
 
-GetOnePromptLanguage = Literal[
-    "Chinese",
-    "Dutch",
-    "English",
-    "French",
-    "German",
-    "Russian",
-    "Spanish",
+GetOnePromptPromptsFormat = Literal[
+    "wav",
+    "mp3",
+    "flac",
+    "opus",
+    "pcm16",
 ]
-r"""The language that the prompt is written in. Use this field to categorize the prompt for your own purpose"""
+r"""Specifies the output audio format. Must be one of wav, mp3, flac, opus, or pcm16."""
 
 
-class GetOnePromptMetadataTypedDict(TypedDict):
-    use_cases: NotRequired[List[GetOnePromptUseCases]]
-    r"""A list of use cases that the prompt is meant to be used for. Use this field to categorize the prompt for your own purpose"""
-    language: NotRequired[Nullable[GetOnePromptLanguage]]
-    r"""The language that the prompt is written in. Use this field to categorize the prompt for your own purpose"""
+class GetOnePromptAudioTypedDict(TypedDict):
+    r"""Parameters for audio output. Required when audio output is requested with modalities: [\"audio\"]. Learn more."""
 
+    voice: GetOnePromptVoice
+    r"""The voice the model uses to respond. Supported voices are alloy, echo, fable, onyx, nova, and shimmer."""
+    format_: GetOnePromptPromptsFormat
+    r"""Specifies the output audio format. Must be one of wav, mp3, flac, opus, or pcm16."""
 
-class GetOnePromptMetadata(BaseModel):
-    use_cases: Optional[List[GetOnePromptUseCases]] = None
-    r"""A list of use cases that the prompt is meant to be used for. Use this field to categorize the prompt for your own purpose"""
 
-    language: OptionalNullable[GetOnePromptLanguage] = UNSET
-    r"""The language that the prompt is written in. Use this field to categorize the prompt for your own purpose"""
+class GetOnePromptAudio(BaseModel):
+    r"""Parameters for audio output. Required when audio output is requested with modalities: [\"audio\"]. Learn more."""
+
+    voice: GetOnePromptVoice
+    r"""The voice the model uses to respond. Supported voices are alloy, echo, fable, onyx, nova, and shimmer."""
+
+    format_: Annotated[GetOnePromptPromptsFormat, pydantic.Field(alias="format")]
+    r"""Specifies the output audio format. Must be one of wav, mp3, flac, opus, or pcm16."""
+
+
+GetOnePromptResponseFormatPromptsResponseType = Literal["json_schema",]
+
+
+class GetOnePromptResponseFormatJSONSchemaTypedDict(TypedDict):
+    name: str
+    r"""The name of the response format. Must be a-z, A-Z, 0-9, or contain underscores and dashes, with a maximum length of 64."""
+    description: NotRequired[str]
+    r"""A description of what the response format is for, used by the model to determine how to respond in the format."""
+    schema_: NotRequired[Any]
+    r"""The schema for the response format, described as a JSON Schema object."""
+    strict: NotRequired[bool]
+    r"""Whether to enable strict schema adherence when generating the output. If set to true, the model will always follow the exact schema defined in the schema field. Only a subset of JSON Schema is supported when strict is true."""
+
+
+class GetOnePromptResponseFormatJSONSchema(BaseModel):
+    name: str
+    r"""The name of the response format. Must be a-z, A-Z, 0-9, or contain underscores and dashes, with a maximum length of 64."""
+
+    description: Optional[str] = None
+    r"""A description of what the response format is for, used by the model to determine how to respond in the format."""
+
+    schema_: Annotated[Optional[Any], pydantic.Field(alias="schema")] = None
+    r"""The schema for the response format, described as a JSON Schema object."""
+
+    strict: Optional[bool] = False
+    r"""Whether to enable strict schema adherence when generating the output. If set to true, the model will always follow the exact schema defined in the schema field. Only a subset of JSON Schema is supported when strict is true."""
 
     @model_serializer(mode="wrap")
     def serialize_model(self, handler):
-        optional_fields = ["use_cases", "language"]
-        nullable_fields = ["language"]
-        null_default_fields = []
-
+        optional_fields = set(["description", "schema", "strict"])
         serialized = handler(self)
-
         m = {}
 
         for n, f in type(self).model_fields.items():
             k = f.alias or n
             val = serialized.get(k)
-            serialized.pop(k, None)
-
-            optional_nullable = k in optional_fields and k in nullable_fields
-            is_set = (
-                self.__pydantic_fields_set__.intersection({n})
-                or k in null_default_fields
-            )  # pylint: disable=no-member
 
-            if val is not None and val != UNSET_SENTINEL:
-                m[k] = val
-            elif val != UNSET_SENTINEL and (
-                not k in optional_fields or (optional_nullable and is_set)
-            ):
-                m[k] = val
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
 
         return m
 
 
-class GetOnePromptPromptTypedDict(TypedDict):
-    r"""A prompt entity with configuration, metadata, and versioning."""
+class GetOnePromptResponseFormatPromptsJSONSchemaTypedDict(TypedDict):
+    r"""
 
-    id: str
-    type: GetOnePromptType
-    owner: str
-    domain_id: str
-    created: str
-    updated: str
-    display_name: str
-    r"""The prompt’s name, meant to be displayable in the UI."""
-    prompt_config: GetOnePromptPromptConfigTypedDict
-    r"""A list of messages compatible with the openAI schema"""
-    created_by_id: NotRequired[Nullable[str]]
-    updated_by_id: NotRequired[Nullable[str]]
-    description: NotRequired[Nullable[str]]
-    r"""The prompt’s description, meant to be displayable in the UI. Use this field to optionally store a long form explanation of the prompt for your own purpose"""
-    metadata: NotRequired[GetOnePromptMetadataTypedDict]
+    JSON Schema response format. Used to generate structured JSON responses
+    """
 
+    type: GetOnePromptResponseFormatPromptsResponseType
+    json_schema: GetOnePromptResponseFormatJSONSchemaTypedDict
 
-class GetOnePromptPrompt(BaseModel):
-    r"""A prompt entity with configuration, metadata, and versioning."""
 
-    id: Annotated[str, pydantic.Field(alias="_id")]
+class GetOnePromptResponseFormatPromptsJSONSchema(BaseModel):
+    r"""
 
-    type: GetOnePromptType
+    JSON Schema response format. Used to generate structured JSON responses
+    """
 
-    owner: str
+    type: GetOnePromptResponseFormatPromptsResponseType
 
-    domain_id: str
+    json_schema: GetOnePromptResponseFormatJSONSchema
 
-    created: str
 
-    updated: str
+GetOnePromptResponseFormatPromptsType = Literal["json_object",]
 
-    display_name: str
-    r"""The prompt’s name, meant to be displayable in the UI."""
 
-    prompt_config: GetOnePromptPromptConfig
-    r"""A list of messages compatible with the openAI schema"""
+class GetOnePromptResponseFormatJSONObjectTypedDict(TypedDict):
+    r"""
 
-    created_by_id: OptionalNullable[str] = UNSET
+    JSON object response format. An older method of generating JSON responses. Using `json_schema` is recommended for models that support it. Note that the model will not generate JSON without a system or user message instructing it to do so.
+    """
 
-    updated_by_id: OptionalNullable[str] = UNSET
+    type: GetOnePromptResponseFormatPromptsType
 
-    description: OptionalNullable[str] = UNSET
-    r"""The prompt’s description, meant to be displayable in the UI. Use this field to optionally store a long form explanation of the prompt for your own purpose"""
 
-    metadata: Optional[GetOnePromptMetadata] = None
+class GetOnePromptResponseFormatJSONObject(BaseModel):
+    r"""
 
-    @model_serializer(mode="wrap")
-    def serialize_model(self, handler):
-        optional_fields = ["created_by_id", "updated_by_id", "description", "metadata"]
-        nullable_fields = ["created_by_id", "updated_by_id", "description"]
-        null_default_fields = []
+    JSON object response format. An older method of generating JSON responses. Using `json_schema` is recommended for models that support it. Note that the model will not generate JSON without a system or user message instructing it to do so.
+    """
 
-        serialized = handler(self)
+    type: GetOnePromptResponseFormatPromptsType
+
+
+GetOnePromptResponseFormatType = Literal["text",]
+
+
+class GetOnePromptResponseFormatTextTypedDict(TypedDict):
+    r"""
+
+    Default response format. Used to generate text responses
+    """
+
+    type: GetOnePromptResponseFormatType
+
+
+class GetOnePromptResponseFormatText(BaseModel):
+    r"""
+
+    Default response format. Used to generate text responses
+    """
+
+    type: GetOnePromptResponseFormatType
+
+
+GetOnePromptResponseFormatTypedDict = TypeAliasType(
+    "GetOnePromptResponseFormatTypedDict",
+    Union[
+        GetOnePromptResponseFormatTextTypedDict,
+        GetOnePromptResponseFormatJSONObjectTypedDict,
+        GetOnePromptResponseFormatPromptsJSONSchemaTypedDict,
+    ],
+)
+r"""An object specifying the format that the model must output"""
+
+
+GetOnePromptResponseFormat = Annotated[
+    Union[
+        Annotated[GetOnePromptResponseFormatText, Tag("text")],
+        Annotated[GetOnePromptResponseFormatJSONObject, Tag("json_object")],
+        Annotated[GetOnePromptResponseFormatPromptsJSONSchema, Tag("json_schema")],
+    ],
+    Discriminator(lambda m: get_discriminator(m, "type", "type")),
+]
+r"""An object specifying the format that the model must output"""
+
+
+GetOnePromptReasoningEffort = Literal[
+    "none",
+    "minimal",
+    "low",
+    "medium",
+    "high",
+    "xhigh",
+]
+r"""Constrains effort on reasoning for [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`. Reducing reasoning effort can result in faster responses and fewer tokens used on reasoning in a response.
+
+- `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls are supported for all reasoning values in gpt-5.1.
+- All models before `gpt-5.1` default to `medium` reasoning effort, and do not support `none`.
+- The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
+- `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+
+Any of \"none\", \"minimal\", \"low\", \"medium\", \"high\", \"xhigh\".
+"""
+
+
+GetOnePromptStopTypedDict = TypeAliasType(
+    "GetOnePromptStopTypedDict", Union[str, List[str]]
+)
+r"""Up to 4 sequences where the API will stop generating further tokens."""
+
+
+GetOnePromptStop = TypeAliasType("GetOnePromptStop", Union[str, List[str]])
+r"""Up to 4 sequences where the API will stop generating further tokens."""
+
+
+class GetOnePromptStreamOptionsTypedDict(TypedDict):
+    r"""Options for streaming response. Only set this when you set stream: true."""
 
+    include_usage: NotRequired[bool]
+    r"""If set, an additional chunk will be streamed before the data: [DONE] message. The usage field on this chunk shows the token usage statistics for the entire request, and the choices field will always be an empty array. All other chunks will also include a usage field, but with a null value."""
+
+
+class GetOnePromptStreamOptions(BaseModel):
+    r"""Options for streaming response. Only set this when you set stream: true."""
+
+    include_usage: Optional[bool] = None
+    r"""If set, an additional chunk will be streamed before the data: [DONE] message. The usage field on this chunk shows the token usage statistics for the entire request, and the choices field will always be an empty array. All other chunks will also include a usage field, but with a null value."""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["include_usage"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m
+
+
+GetOnePromptThinkingTypedDict = TypeAliasType(
+    "GetOnePromptThinkingTypedDict",
+    Union[ThinkingConfigDisabledSchemaTypedDict, ThinkingConfigEnabledSchemaTypedDict],
+)
+
+
+GetOnePromptThinking = Annotated[
+    Union[
+        Annotated[ThinkingConfigDisabledSchema, Tag("disabled")],
+        Annotated[ThinkingConfigEnabledSchema, Tag("enabled")],
+    ],
+    Discriminator(lambda m: get_discriminator(m, "type", "type")),
+]
+
+
+GetOnePromptToolChoiceType = Literal["function",]
+r"""The type of the tool. Currently, only function is supported."""
+
+
+class GetOnePromptToolChoiceFunctionTypedDict(TypedDict):
+    name: str
+    r"""The name of the function to call."""
+
+
+class GetOnePromptToolChoiceFunction(BaseModel):
+    name: str
+    r"""The name of the function to call."""
+
+
+class GetOnePromptToolChoice2TypedDict(TypedDict):
+    function: GetOnePromptToolChoiceFunctionTypedDict
+    type: NotRequired[GetOnePromptToolChoiceType]
+    r"""The type of the tool. Currently, only function is supported."""
+
+
+class GetOnePromptToolChoice2(BaseModel):
+    function: GetOnePromptToolChoiceFunction
+
+    type: Optional[GetOnePromptToolChoiceType] = None
+    r"""The type of the tool. Currently, only function is supported."""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["type"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m
+
+
+GetOnePromptToolChoice1 = Literal[
+    "none",
+    "auto",
+    "required",
+]
+
+
+GetOnePromptToolChoiceTypedDict = TypeAliasType(
+    "GetOnePromptToolChoiceTypedDict",
+    Union[GetOnePromptToolChoice2TypedDict, GetOnePromptToolChoice1],
+)
+r"""Controls which (if any) tool is called by the model."""
+
+
+GetOnePromptToolChoice = TypeAliasType(
+    "GetOnePromptToolChoice", Union[GetOnePromptToolChoice2, GetOnePromptToolChoice1]
+)
+r"""Controls which (if any) tool is called by the model."""
+
+
+GetOnePromptModalities = Literal[
+    "text",
+    "audio",
+]
+
+
+GetOnePromptID1 = Literal[
+    "orq_pii_detection",
+    "orq_sexual_moderation",
+    "orq_harmful_moderation",
+]
+r"""The key of the guardrail."""
+
+
+GetOnePromptIDTypedDict = TypeAliasType(
+    "GetOnePromptIDTypedDict", Union[GetOnePromptID1, str]
+)
+
+
+GetOnePromptID = TypeAliasType("GetOnePromptID", Union[GetOnePromptID1, str])
+
+
+GetOnePromptExecuteOn = Literal[
+    "input",
+    "output",
+]
+r"""Determines whether the guardrail runs on the input (user message) or output (model response)."""
+
+
+class GetOnePromptGuardrailsTypedDict(TypedDict):
+    id: GetOnePromptIDTypedDict
+    execute_on: GetOnePromptExecuteOn
+    r"""Determines whether the guardrail runs on the input (user message) or output (model response)."""
+
+
+class GetOnePromptGuardrails(BaseModel):
+    id: GetOnePromptID
+
+    execute_on: GetOnePromptExecuteOn
+    r"""Determines whether the guardrail runs on the input (user message) or output (model response)."""
+
+
+class GetOnePromptFallbacksTypedDict(TypedDict):
+    model: str
+    r"""Fallback model identifier"""
+
+
+class GetOnePromptFallbacks(BaseModel):
+    model: str
+    r"""Fallback model identifier"""
+
+
+class GetOnePromptRetryTypedDict(TypedDict):
+    r"""Retry configuration for the request"""
+
+    count: NotRequired[float]
+    r"""Number of retry attempts (1-5)"""
+    on_codes: NotRequired[List[float]]
+    r"""HTTP status codes that trigger retry logic"""
+
+
+class GetOnePromptRetry(BaseModel):
+    r"""Retry configuration for the request"""
+
+    count: Optional[float] = 3
+    r"""Number of retry attempts (1-5)"""
+
+    on_codes: Optional[List[float]] = None
+    r"""HTTP status codes that trigger retry logic"""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["count", "on_codes"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m
+
+
+GetOnePromptPromptsType = Literal["exact_match",]
+
+
+class GetOnePromptCacheTypedDict(TypedDict):
+    r"""Cache configuration for the request."""
+
+    type: GetOnePromptPromptsType
+    ttl: NotRequired[float]
+    r"""Time to live for cached responses in seconds. Maximum 259200 seconds (3 days)."""
+
+
+class GetOnePromptCache(BaseModel):
+    r"""Cache configuration for the request."""
+
+    type: GetOnePromptPromptsType
+
+    ttl: Optional[float] = 1800
+    r"""Time to live for cached responses in seconds. Maximum 259200 seconds (3 days)."""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["ttl"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m
+
+
+GetOnePromptLoadBalancerType = Literal["weight_based",]
+
+
+class GetOnePromptLoadBalancerModelsTypedDict(TypedDict):
+    model: str
+    r"""Model identifier for load balancing"""
+    weight: NotRequired[float]
+    r"""Weight assigned to this model for load balancing"""
+
+
+class GetOnePromptLoadBalancerModels(BaseModel):
+    model: str
+    r"""Model identifier for load balancing"""
+
+    weight: Optional[float] = 0.5
+    r"""Weight assigned to this model for load balancing"""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["weight"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m
+
+
+class GetOnePromptLoadBalancer1TypedDict(TypedDict):
+    type: GetOnePromptLoadBalancerType
+    models: List[GetOnePromptLoadBalancerModelsTypedDict]
+
+
+class GetOnePromptLoadBalancer1(BaseModel):
+    type: GetOnePromptLoadBalancerType
+
+    models: List[GetOnePromptLoadBalancerModels]
+
+
+GetOnePromptLoadBalancerTypedDict = GetOnePromptLoadBalancer1TypedDict
+r"""Load balancer configuration for the request."""
+
+
+GetOnePromptLoadBalancer = GetOnePromptLoadBalancer1
+r"""Load balancer configuration for the request."""
+
+
+class GetOnePromptTimeoutTypedDict(TypedDict):
+    r"""Timeout configuration to apply to the request. If the request exceeds the timeout, it will be retried or fallback to the next model if configured."""
+
+    call_timeout: float
+    r"""Timeout value in milliseconds"""
+
+
+class GetOnePromptTimeout(BaseModel):
+    r"""Timeout configuration to apply to the request. If the request exceeds the timeout, it will be retried or fallback to the next model if configured."""
+
+    call_timeout: float
+    r"""Timeout value in milliseconds"""
+
+
+GetOnePromptMessagesPromptsResponse200Role = Literal["tool",]
+r"""The role of the messages author, in this case tool."""
+
+
+GetOnePromptContentPromptsResponse2002TypedDict = TextContentPartSchemaTypedDict
+
+
+GetOnePromptContentPromptsResponse2002 = TextContentPartSchema
+
+
+GetOnePromptMessagesPromptsResponse200ContentTypedDict = TypeAliasType(
+    "GetOnePromptMessagesPromptsResponse200ContentTypedDict",
+    Union[str, List[GetOnePromptContentPromptsResponse2002TypedDict]],
+)
+r"""The contents of the tool message."""
+
+
+GetOnePromptMessagesPromptsResponse200Content = TypeAliasType(
+    "GetOnePromptMessagesPromptsResponse200Content",
+    Union[str, List[GetOnePromptContentPromptsResponse2002]],
+)
+r"""The contents of the tool message."""
+
+
+GetOnePromptMessagesPromptsType = Literal["ephemeral",]
+r"""Create a cache control breakpoint at this content block. Accepts only the value \"ephemeral\"."""
+
+
+GetOnePromptMessagesTTL = Literal[
+    "5m",
+    "1h",
+]
+r"""The time-to-live for the cache control breakpoint. This may be one of the following values:
+
+- `5m`: 5 minutes
+- `1h`: 1 hour
+
+Defaults to `5m`. Only supported by `Anthropic` Claude models.
+"""
+
+
+class GetOnePromptMessagesCacheControlTypedDict(TypedDict):
+    type: GetOnePromptMessagesPromptsType
+    r"""Create a cache control breakpoint at this content block. Accepts only the value \"ephemeral\"."""
+    ttl: NotRequired[GetOnePromptMessagesTTL]
+    r"""The time-to-live for the cache control breakpoint. This may be one of the following values:
+
+    - `5m`: 5 minutes
+    - `1h`: 1 hour
+
+    Defaults to `5m`. Only supported by `Anthropic` Claude models.
+    """
+
+
+class GetOnePromptMessagesCacheControl(BaseModel):
+    type: GetOnePromptMessagesPromptsType
+    r"""Create a cache control breakpoint at this content block. Accepts only the value \"ephemeral\"."""
+
+    ttl: Optional[GetOnePromptMessagesTTL] = "5m"
+    r"""The time-to-live for the cache control breakpoint. This may be one of the following values:
+
+    - `5m`: 5 minutes
+    - `1h`: 1 hour
+
+    Defaults to `5m`. Only supported by `Anthropic` Claude models.
+    """
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["ttl"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m
+
+
+class GetOnePromptMessagesToolMessageTypedDict(TypedDict):
+    role: GetOnePromptMessagesPromptsResponse200Role
+    r"""The role of the messages author, in this case tool."""
+    content: GetOnePromptMessagesPromptsResponse200ContentTypedDict
+    r"""The contents of the tool message."""
+    tool_call_id: Nullable[str]
+    r"""Tool call that this message is responding to."""
+    cache_control: NotRequired[GetOnePromptMessagesCacheControlTypedDict]
+
+
+class GetOnePromptMessagesToolMessage(BaseModel):
+    role: GetOnePromptMessagesPromptsResponse200Role
+    r"""The role of the messages author, in this case tool."""
+
+    content: GetOnePromptMessagesPromptsResponse200Content
+    r"""The contents of the tool message."""
+
+    tool_call_id: Nullable[str]
+    r"""Tool call that this message is responding to."""
+
+    cache_control: Optional[GetOnePromptMessagesCacheControl] = None
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["cache_control"])
+        nullable_fields = set(["tool_call_id"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+            is_nullable_and_explicitly_set = (
+                k in nullable_fields
+                and (self.__pydantic_fields_set__.intersection({n}))  # pylint: disable=no-member
+            )
+
+            if val != UNSET_SENTINEL:
+                if (
+                    val is not None
+                    or k not in optional_fields
+                    or is_nullable_and_explicitly_set
+                ):
+                    m[k] = val
+
+        return m
+
+
+GetOnePromptContentPromptsResponse2TypedDict = TypeAliasType(
+    "GetOnePromptContentPromptsResponse2TypedDict",
+    Union[
+        RefusalPartSchemaTypedDict,
+        RedactedReasoningPartSchemaTypedDict,
+        TextContentPartSchemaTypedDict,
+        ReasoningPartSchemaTypedDict,
+    ],
+)
+
+
+GetOnePromptContentPromptsResponse2 = Annotated[
+    Union[
+        Annotated[TextContentPartSchema, Tag("text")],
+        Annotated[RefusalPartSchema, Tag("refusal")],
+        Annotated[ReasoningPartSchema, Tag("reasoning")],
+        Annotated[RedactedReasoningPartSchema, Tag("redacted_reasoning")],
+    ],
+    Discriminator(lambda m: get_discriminator(m, "type", "type")),
+]
+
+
+GetOnePromptMessagesPromptsResponseContentTypedDict = TypeAliasType(
+    "GetOnePromptMessagesPromptsResponseContentTypedDict",
+    Union[str, List[GetOnePromptContentPromptsResponse2TypedDict]],
+)
+r"""The contents of the assistant message. Required unless `tool_calls` or `function_call` is specified."""
+
+
+GetOnePromptMessagesPromptsResponseContent = TypeAliasType(
+    "GetOnePromptMessagesPromptsResponseContent",
+    Union[str, List[GetOnePromptContentPromptsResponse2]],
+)
+r"""The contents of the assistant message. Required unless `tool_calls` or `function_call` is specified."""
+
+
+GetOnePromptMessagesPromptsResponseRole = Literal["assistant",]
+r"""The role of the messages author, in this case `assistant`."""
+
+
+class GetOnePromptMessagesAudioTypedDict(TypedDict):
+    r"""Data about a previous audio response from the model."""
+
+    id: str
+    r"""Unique identifier for a previous audio response from the model."""
+
+
+class GetOnePromptMessagesAudio(BaseModel):
+    r"""Data about a previous audio response from the model."""
+
+    id: str
+    r"""Unique identifier for a previous audio response from the model."""
+
+
+GetOnePromptMessagesType = Literal["function",]
+r"""The type of the tool. Currently, only `function` is supported."""
+
+
+class GetOnePromptMessagesFunctionTypedDict(TypedDict):
+    name: NotRequired[str]
+    r"""The name of the function to call."""
+    arguments: NotRequired[str]
+    r"""The arguments to call the function with, as generated by the model in JSON format. Note that the model does not always generate valid JSON, and may hallucinate parameters not defined by your function schema. Validate the arguments in your code before calling your function."""
+
+
+class GetOnePromptMessagesFunction(BaseModel):
+    name: Optional[str] = None
+    r"""The name of the function to call."""
+
+    arguments: Optional[str] = None
+    r"""The arguments to call the function with, as generated by the model in JSON format. Note that the model does not always generate valid JSON, and may hallucinate parameters not defined by your function schema. Validate the arguments in your code before calling your function."""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["name", "arguments"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m
+
+
+class GetOnePromptMessagesToolCallsTypedDict(TypedDict):
+    id: str
+    r"""The ID of the tool call."""
+    type: GetOnePromptMessagesType
+    r"""The type of the tool. Currently, only `function` is supported."""
+    function: GetOnePromptMessagesFunctionTypedDict
+    thought_signature: NotRequired[str]
+    r"""Encrypted representation of the model internal reasoning state during function calling. Required by Gemini 3 models when continuing a conversation after a tool call."""
+
+
+class GetOnePromptMessagesToolCalls(BaseModel):
+    id: str
+    r"""The ID of the tool call."""
+
+    type: GetOnePromptMessagesType
+    r"""The type of the tool. Currently, only `function` is supported."""
+
+    function: GetOnePromptMessagesFunction
+
+    thought_signature: Optional[str] = None
+    r"""Encrypted representation of the model internal reasoning state during function calling. Required by Gemini 3 models when continuing a conversation after a tool call."""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["thought_signature"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m
+
+
+class GetOnePromptMessagesAssistantMessageTypedDict(TypedDict):
+    role: GetOnePromptMessagesPromptsResponseRole
+    r"""The role of the messages author, in this case `assistant`."""
+    content: NotRequired[Nullable[GetOnePromptMessagesPromptsResponseContentTypedDict]]
+    r"""The contents of the assistant message. Required unless `tool_calls` or `function_call` is specified."""
+    refusal: NotRequired[Nullable[str]]
+    r"""The refusal message by the assistant."""
+    name: NotRequired[str]
+    r"""An optional name for the participant. Provides the model information to differentiate between participants of the same role."""
+    audio: NotRequired[Nullable[GetOnePromptMessagesAudioTypedDict]]
+    r"""Data about a previous audio response from the model."""
+    tool_calls: NotRequired[List[GetOnePromptMessagesToolCallsTypedDict]]
+    r"""The tool calls generated by the model, such as function calls."""
+
+
+class GetOnePromptMessagesAssistantMessage(BaseModel):
+    role: GetOnePromptMessagesPromptsResponseRole
+    r"""The role of the messages author, in this case `assistant`."""
+
+    content: OptionalNullable[GetOnePromptMessagesPromptsResponseContent] = UNSET
+    r"""The contents of the assistant message. Required unless `tool_calls` or `function_call` is specified."""
+
+    refusal: OptionalNullable[str] = UNSET
+    r"""The refusal message by the assistant."""
+
+    name: Optional[str] = None
+    r"""An optional name for the participant. Provides the model information to differentiate between participants of the same role."""
+
+    audio: OptionalNullable[GetOnePromptMessagesAudio] = UNSET
+    r"""Data about a previous audio response from the model."""
+
+    tool_calls: Optional[List[GetOnePromptMessagesToolCalls]] = None
+    r"""The tool calls generated by the model, such as function calls."""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["content", "refusal", "name", "audio", "tool_calls"])
+        nullable_fields = set(["content", "refusal", "audio"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+            is_nullable_and_explicitly_set = (
+                k in nullable_fields
+                and (self.__pydantic_fields_set__.intersection({n}))  # pylint: disable=no-member
+            )
+
+            if val != UNSET_SENTINEL:
+                if (
+                    val is not None
+                    or k not in optional_fields
+                    or is_nullable_and_explicitly_set
+                ):
+                    m[k] = val
+
+        return m
+
+
+GetOnePromptMessagesPromptsRole = Literal["user",]
+r"""The role of the messages author, in this case `user`."""
+
+
+GetOnePrompt2PromptsResponse200Type = Literal["file",]
+r"""The type of the content part. Always `file`."""
+
+
+GetOnePrompt2PromptsResponse200ApplicationJSONType = Literal["ephemeral",]
+r"""Create a cache control breakpoint at this content block. Accepts only the value \"ephemeral\"."""
+
+
+GetOnePrompt2TTL = Literal[
+    "5m",
+    "1h",
+]
+r"""The time-to-live for the cache control breakpoint. This may be one of the following values:
+
+- `5m`: 5 minutes
+- `1h`: 1 hour
+
+Defaults to `5m`. Only supported by `Anthropic` Claude models.
+"""
+
+
+class GetOnePrompt2CacheControlTypedDict(TypedDict):
+    type: GetOnePrompt2PromptsResponse200ApplicationJSONType
+    r"""Create a cache control breakpoint at this content block. Accepts only the value \"ephemeral\"."""
+    ttl: NotRequired[GetOnePrompt2TTL]
+    r"""The time-to-live for the cache control breakpoint. This may be one of the following values:
+
+    - `5m`: 5 minutes
+    - `1h`: 1 hour
+
+    Defaults to `5m`. Only supported by `Anthropic` Claude models.
+    """
+
+
+class GetOnePrompt2CacheControl(BaseModel):
+    type: GetOnePrompt2PromptsResponse200ApplicationJSONType
+    r"""Create a cache control breakpoint at this content block. Accepts only the value \"ephemeral\"."""
+
+    ttl: Optional[GetOnePrompt2TTL] = "5m"
+    r"""The time-to-live for the cache control breakpoint. This may be one of the following values:
+
+    - `5m`: 5 minutes
+    - `1h`: 1 hour
+
+    Defaults to `5m`. Only supported by `Anthropic` Claude models.
+    """
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["ttl"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m
+
+
+class GetOnePrompt24TypedDict(TypedDict):
+    type: GetOnePrompt2PromptsResponse200Type
+    r"""The type of the content part. Always `file`."""
+    file: FileContentPartSchemaTypedDict
+    r"""File data for the content part. Must contain either file_data or uri, but not both."""
+    cache_control: NotRequired[GetOnePrompt2CacheControlTypedDict]
+
+
+class GetOnePrompt24(BaseModel):
+    type: GetOnePrompt2PromptsResponse200Type
+    r"""The type of the content part. Always `file`."""
+
+    file: FileContentPartSchema
+    r"""File data for the content part. Must contain either file_data or uri, but not both."""
+
+    cache_control: Optional[GetOnePrompt2CacheControl] = None
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["cache_control"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m
+
+
+GetOnePromptContentPrompts2TypedDict = TypeAliasType(
+    "GetOnePromptContentPrompts2TypedDict",
+    Union[
+        AudioContentPartSchemaTypedDict,
+        TextContentPartSchemaTypedDict,
+        ImageContentPartSchemaTypedDict,
+        GetOnePrompt24TypedDict,
+    ],
+)
+
+
+GetOnePromptContentPrompts2 = Annotated[
+    Union[
+        Annotated[TextContentPartSchema, Tag("text")],
+        Annotated[ImageContentPartSchema, Tag("image_url")],
+        Annotated[AudioContentPartSchema, Tag("input_audio")],
+        Annotated[GetOnePrompt24, Tag("file")],
+    ],
+    Discriminator(lambda m: get_discriminator(m, "type", "type")),
+]
+
+
+GetOnePromptMessagesPromptsContentTypedDict = TypeAliasType(
+    "GetOnePromptMessagesPromptsContentTypedDict",
+    Union[str, List[GetOnePromptContentPrompts2TypedDict]],
+)
+r"""The contents of the user message."""
+
+
+GetOnePromptMessagesPromptsContent = TypeAliasType(
+    "GetOnePromptMessagesPromptsContent", Union[str, List[GetOnePromptContentPrompts2]]
+)
+r"""The contents of the user message."""
+
+
+class GetOnePromptMessagesUserMessageTypedDict(TypedDict):
+    role: GetOnePromptMessagesPromptsRole
+    r"""The role of the messages author, in this case `user`."""
+    content: GetOnePromptMessagesPromptsContentTypedDict
+    r"""The contents of the user message."""
+    name: NotRequired[str]
+    r"""An optional name for the participant. Provides the model information to differentiate between participants of the same role."""
+
+
+class GetOnePromptMessagesUserMessage(BaseModel):
+    role: GetOnePromptMessagesPromptsRole
+    r"""The role of the messages author, in this case `user`."""
+
+    content: GetOnePromptMessagesPromptsContent
+    r"""The contents of the user message."""
+
+    name: Optional[str] = None
+    r"""An optional name for the participant. Provides the model information to differentiate between participants of the same role."""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["name"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m
+
+
+GetOnePromptMessagesRole = Literal["system",]
+r"""The role of the messages author, in this case `system`."""
+
+
+GetOnePromptMessagesContentTypedDict = TypeAliasType(
+    "GetOnePromptMessagesContentTypedDict",
+    Union[str, List[TextContentPartSchemaTypedDict]],
+)
+r"""The contents of the system message."""
+
+
+GetOnePromptMessagesContent = TypeAliasType(
+    "GetOnePromptMessagesContent", Union[str, List[TextContentPartSchema]]
+)
+r"""The contents of the system message."""
+
+
+class GetOnePromptMessagesSystemMessageTypedDict(TypedDict):
+    r"""Developer-provided instructions that the model should follow, regardless of messages sent by the user."""
+
+    role: GetOnePromptMessagesRole
+    r"""The role of the messages author, in this case `system`."""
+    content: GetOnePromptMessagesContentTypedDict
+    r"""The contents of the system message."""
+    name: NotRequired[str]
+    r"""An optional name for the participant. Provides the model information to differentiate between participants of the same role."""
+
+
+class GetOnePromptMessagesSystemMessage(BaseModel):
+    r"""Developer-provided instructions that the model should follow, regardless of messages sent by the user."""
+
+    role: GetOnePromptMessagesRole
+    r"""The role of the messages author, in this case `system`."""
+
+    content: GetOnePromptMessagesContent
+    r"""The contents of the system message."""
+
+    name: Optional[str] = None
+    r"""An optional name for the participant. Provides the model information to differentiate between participants of the same role."""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["name"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m
+
+
+GetOnePromptPromptsMessagesTypedDict = TypeAliasType(
+    "GetOnePromptPromptsMessagesTypedDict",
+    Union[
+        GetOnePromptMessagesSystemMessageTypedDict,
+        GetOnePromptMessagesUserMessageTypedDict,
+        GetOnePromptMessagesToolMessageTypedDict,
+        GetOnePromptMessagesAssistantMessageTypedDict,
+    ],
+)
+
+
+GetOnePromptPromptsMessages = Annotated[
+    Union[
+        Annotated[GetOnePromptMessagesSystemMessage, Tag("system")],
+        Annotated[GetOnePromptMessagesUserMessage, Tag("user")],
+        Annotated[GetOnePromptMessagesAssistantMessage, Tag("assistant")],
+        Annotated[GetOnePromptMessagesToolMessage, Tag("tool")],
+    ],
+    Discriminator(lambda m: get_discriminator(m, "role", "role")),
+]
+
+
+class GetOnePromptPromptFieldTypedDict(TypedDict):
+    r"""Prompt configuration with model and messages. Use this instead of prompt_config."""
+
+    audio: NotRequired[Nullable[GetOnePromptAudioTypedDict]]
+    r"""Parameters for audio output. Required when audio output is requested with modalities: [\"audio\"]. Learn more."""
+    frequency_penalty: NotRequired[Nullable[float]]
+    r"""Number between -2.0 and 2.0. Positive values penalize new tokens based on their existing frequency in the text so far, decreasing the model's likelihood to repeat the same line verbatim."""
+    max_tokens: NotRequired[Nullable[int]]
+    r"""`[Deprecated]`. The maximum number of tokens that can be generated in the chat completion. This value can be used to control costs for text generated via API.
+
+    This value is now `deprecated` in favor of `max_completion_tokens`, and is not compatible with o1 series models.
+    """
+    max_completion_tokens: NotRequired[Nullable[int]]
+    r"""An upper bound for the number of tokens that can be generated for a completion, including visible output tokens and reasoning tokens"""
+    logprobs: NotRequired[Nullable[bool]]
+    r"""Whether to return log probabilities of the output tokens or not. If true, returns the log probabilities of each output token returned in the content of message."""
+    top_logprobs: NotRequired[Nullable[int]]
+    r"""An integer between 0 and 20 specifying the number of most likely tokens to return at each token position, each with an associated log probability. logprobs must be set to true if this parameter is used."""
+    n: NotRequired[Nullable[int]]
+    r"""How many chat completion choices to generate for each input message. Note that you will be charged based on the number of generated tokens across all of the choices. Keep n as 1 to minimize costs."""
+    presence_penalty: NotRequired[Nullable[float]]
+    r"""Number between -2.0 and 2.0. Positive values penalize new tokens based on whether they appear in the text so far, increasing the model's likelihood to talk about new topics."""
+    response_format: NotRequired[GetOnePromptResponseFormatTypedDict]
+    r"""An object specifying the format that the model must output"""
+    reasoning_effort: NotRequired[GetOnePromptReasoningEffort]
+    r"""Constrains effort on reasoning for [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`. Reducing reasoning effort can result in faster responses and fewer tokens used on reasoning in a response.
+
+    - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls are supported for all reasoning values in gpt-5.1.
+    - All models before `gpt-5.1` default to `medium` reasoning effort, and do not support `none`.
+    - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
+    - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+
+    Any of \"none\", \"minimal\", \"low\", \"medium\", \"high\", \"xhigh\".
+    """
+    verbosity: NotRequired[str]
+    r"""Adjusts response verbosity. Lower levels yield shorter answers."""
+    seed: NotRequired[Nullable[float]]
+    r"""If specified, our system will make a best effort to sample deterministically, such that repeated requests with the same seed and parameters should return the same result."""
+    stop: NotRequired[Nullable[GetOnePromptStopTypedDict]]
+    r"""Up to 4 sequences where the API will stop generating further tokens."""
+    stream_options: NotRequired[Nullable[GetOnePromptStreamOptionsTypedDict]]
+    r"""Options for streaming response. Only set this when you set stream: true."""
+    thinking: NotRequired[GetOnePromptThinkingTypedDict]
+    temperature: NotRequired[Nullable[float]]
+    r"""What sampling temperature to use, between 0 and 2. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic."""
+    top_p: NotRequired[Nullable[float]]
+    r"""An alternative to sampling with temperature, called nucleus sampling, where the model considers the results of the tokens with top_p probability mass."""
+    top_k: NotRequired[Nullable[float]]
+    r"""Limits the model to consider only the top k most likely tokens at each step."""
+    tool_choice: NotRequired[GetOnePromptToolChoiceTypedDict]
+    r"""Controls which (if any) tool is called by the model."""
+    parallel_tool_calls: NotRequired[bool]
+    r"""Whether to enable parallel function calling during tool use."""
+    modalities: NotRequired[Nullable[List[GetOnePromptModalities]]]
+    r"""Output types that you would like the model to generate. Most models are capable of generating text, which is the default: [\"text\"]. The gpt-4o-audio-preview model can also be used to generate audio. To request that this model generate both text and audio responses, you can use: [\"text\", \"audio\"]."""
+    guardrails: NotRequired[List[GetOnePromptGuardrailsTypedDict]]
+    r"""A list of guardrails to apply to the request."""
+    fallbacks: NotRequired[List[GetOnePromptFallbacksTypedDict]]
+    r"""Array of fallback models to use if primary model fails"""
+    retry: NotRequired[GetOnePromptRetryTypedDict]
+    r"""Retry configuration for the request"""
+    cache: NotRequired[GetOnePromptCacheTypedDict]
+    r"""Cache configuration for the request."""
+    load_balancer: NotRequired[GetOnePromptLoadBalancerTypedDict]
+    r"""Load balancer configuration for the request."""
+    timeout: NotRequired[GetOnePromptTimeoutTypedDict]
+    r"""Timeout configuration to apply to the request. If the request exceeds the timeout, it will be retried or fallback to the next model if configured."""
+    messages: NotRequired[List[GetOnePromptPromptsMessagesTypedDict]]
+    r"""Array of messages that make up the conversation. Each message has a role (system, user, assistant, or tool) and content."""
+    model: NotRequired[Nullable[str]]
+    r"""Model ID used to generate the response, like `openai/gpt-4o` or `anthropic/claude-3-5-sonnet-20241022`. For private models, use format: `{workspaceKey}@{provider}/{model}`."""
+    version: NotRequired[str]
+
+
+class GetOnePromptPromptField(BaseModel):
+    r"""Prompt configuration with model and messages. Use this instead of prompt_config."""
+
+    audio: OptionalNullable[GetOnePromptAudio] = UNSET
+    r"""Parameters for audio output. Required when audio output is requested with modalities: [\"audio\"]. Learn more."""
+
+    frequency_penalty: OptionalNullable[float] = UNSET
+    r"""Number between -2.0 and 2.0. Positive values penalize new tokens based on their existing frequency in the text so far, decreasing the model's likelihood to repeat the same line verbatim."""
+
+    max_tokens: OptionalNullable[int] = UNSET
+    r"""`[Deprecated]`. The maximum number of tokens that can be generated in the chat completion. This value can be used to control costs for text generated via API.
+
+    This value is now `deprecated` in favor of `max_completion_tokens`, and is not compatible with o1 series models.
+    """
+
+    max_completion_tokens: OptionalNullable[int] = UNSET
+    r"""An upper bound for the number of tokens that can be generated for a completion, including visible output tokens and reasoning tokens"""
+
+    logprobs: OptionalNullable[bool] = UNSET
+    r"""Whether to return log probabilities of the output tokens or not. If true, returns the log probabilities of each output token returned in the content of message."""
+
+    top_logprobs: OptionalNullable[int] = UNSET
+    r"""An integer between 0 and 20 specifying the number of most likely tokens to return at each token position, each with an associated log probability. logprobs must be set to true if this parameter is used."""
+
+    n: OptionalNullable[int] = UNSET
+    r"""How many chat completion choices to generate for each input message. Note that you will be charged based on the number of generated tokens across all of the choices. Keep n as 1 to minimize costs."""
+
+    presence_penalty: OptionalNullable[float] = UNSET
+    r"""Number between -2.0 and 2.0. Positive values penalize new tokens based on whether they appear in the text so far, increasing the model's likelihood to talk about new topics."""
+
+    response_format: Optional[GetOnePromptResponseFormat] = None
+    r"""An object specifying the format that the model must output"""
+
+    reasoning_effort: Optional[GetOnePromptReasoningEffort] = None
+    r"""Constrains effort on reasoning for [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`. Reducing reasoning effort can result in faster responses and fewer tokens used on reasoning in a response.
+
+    - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls are supported for all reasoning values in gpt-5.1.
+    - All models before `gpt-5.1` default to `medium` reasoning effort, and do not support `none`.
+    - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
+    - `xhigh` is currently only supported for `gpt-5.1-codex-max`.
+
+    Any of \"none\", \"minimal\", \"low\", \"medium\", \"high\", \"xhigh\".
+    """
+
+    verbosity: Optional[str] = None
+    r"""Adjusts response verbosity. Lower levels yield shorter answers."""
+
+    seed: OptionalNullable[float] = UNSET
+    r"""If specified, our system will make a best effort to sample deterministically, such that repeated requests with the same seed and parameters should return the same result."""
+
+    stop: OptionalNullable[GetOnePromptStop] = UNSET
+    r"""Up to 4 sequences where the API will stop generating further tokens."""
+
+    stream_options: OptionalNullable[GetOnePromptStreamOptions] = UNSET
+    r"""Options for streaming response. Only set this when you set stream: true."""
+
+    thinking: Optional[GetOnePromptThinking] = None
+
+    temperature: OptionalNullable[float] = UNSET
+    r"""What sampling temperature to use, between 0 and 2. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic."""
+
+    top_p: OptionalNullable[float] = UNSET
+    r"""An alternative to sampling with temperature, called nucleus sampling, where the model considers the results of the tokens with top_p probability mass."""
+
+    top_k: OptionalNullable[float] = UNSET
+    r"""Limits the model to consider only the top k most likely tokens at each step."""
+
+    tool_choice: Optional[GetOnePromptToolChoice] = None
+    r"""Controls which (if any) tool is called by the model."""
+
+    parallel_tool_calls: Optional[bool] = None
+    r"""Whether to enable parallel function calling during tool use."""
+
+    modalities: OptionalNullable[List[GetOnePromptModalities]] = UNSET
+    r"""Output types that you would like the model to generate. Most models are capable of generating text, which is the default: [\"text\"]. The gpt-4o-audio-preview model can also be used to generate audio. To request that this model generate both text and audio responses, you can use: [\"text\", \"audio\"]."""
+
+    guardrails: Optional[List[GetOnePromptGuardrails]] = None
+    r"""A list of guardrails to apply to the request."""
+
+    fallbacks: Optional[List[GetOnePromptFallbacks]] = None
+    r"""Array of fallback models to use if primary model fails"""
+
+    retry: Optional[GetOnePromptRetry] = None
+    r"""Retry configuration for the request"""
+
+    cache: Optional[GetOnePromptCache] = None
+    r"""Cache configuration for the request."""
+
+    load_balancer: Optional[GetOnePromptLoadBalancer] = None
+    r"""Load balancer configuration for the request."""
+
+    timeout: Optional[GetOnePromptTimeout] = None
+    r"""Timeout configuration to apply to the request. If the request exceeds the timeout, it will be retried or fallback to the next model if configured."""
+
+    messages: Optional[List[GetOnePromptPromptsMessages]] = None
+    r"""Array of messages that make up the conversation. Each message has a role (system, user, assistant, or tool) and content."""
+
+    model: OptionalNullable[str] = UNSET
+    r"""Model ID used to generate the response, like `openai/gpt-4o` or `anthropic/claude-3-5-sonnet-20241022`. For private models, use format: `{workspaceKey}@{provider}/{model}`."""
+
+    version: Optional[str] = None
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(
+            [
+                "audio",
+                "frequency_penalty",
+                "max_tokens",
+                "max_completion_tokens",
+                "logprobs",
+                "top_logprobs",
+                "n",
+                "presence_penalty",
+                "response_format",
+                "reasoning_effort",
+                "verbosity",
+                "seed",
+                "stop",
+                "stream_options",
+                "thinking",
+                "temperature",
+                "top_p",
+                "top_k",
+                "tool_choice",
+                "parallel_tool_calls",
+                "modalities",
+                "guardrails",
+                "fallbacks",
+                "retry",
+                "cache",
+                "load_balancer",
+                "timeout",
+                "messages",
+                "model",
+                "version",
+            ]
+        )
+        nullable_fields = set(
+            [
+                "audio",
+                "frequency_penalty",
+                "max_tokens",
+                "max_completion_tokens",
+                "logprobs",
+                "top_logprobs",
+                "n",
+                "presence_penalty",
+                "seed",
+                "stop",
+                "stream_options",
+                "temperature",
+                "top_p",
+                "top_k",
+                "modalities",
+                "model",
+            ]
+        )
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+            is_nullable_and_explicitly_set = (
+                k in nullable_fields
+                and (self.__pydantic_fields_set__.intersection({n}))  # pylint: disable=no-member
+            )
+
+            if val != UNSET_SENTINEL:
+                if (
+                    val is not None
+                    or k not in optional_fields
+                    or is_nullable_and_explicitly_set
+                ):
+                    m[k] = val
+
+        return m
+
+
+GetOnePromptUseCases = Literal[
+    "Agents simulations",
+    "Agents",
+    "API interaction",
+    "Autonomous Agents",
+    "Chatbots",
+    "Classification",
+    "Code understanding",
+    "Code writing",
+    "Conversation",
+    "Documents QA",
+    "Evaluation",
+    "Extraction",
+    "Multi-modal",
+    "Self-checking",
+    "Sentiment analysis",
+    "SQL",
+    "Summarization",
+    "Tagging",
+    "Translation (document)",
+    "Translation (sentences)",
+]
+
+
+GetOnePromptLanguage = Literal[
+    "Chinese",
+    "Dutch",
+    "English",
+    "French",
+    "German",
+    "Russian",
+    "Spanish",
+]
+r"""The language that the prompt is written in. Use this field to categorize the prompt for your own purpose"""
+
+
+class GetOnePromptMetadataTypedDict(TypedDict):
+    use_cases: NotRequired[List[GetOnePromptUseCases]]
+    r"""A list of use cases that the prompt is meant to be used for. Use this field to categorize the prompt for your own purpose"""
+    language: NotRequired[Nullable[GetOnePromptLanguage]]
+    r"""The language that the prompt is written in. Use this field to categorize the prompt for your own purpose"""
+
+
+class GetOnePromptMetadata(BaseModel):
+    use_cases: Optional[List[GetOnePromptUseCases]] = None
+    r"""A list of use cases that the prompt is meant to be used for. Use this field to categorize the prompt for your own purpose"""
+
+    language: OptionalNullable[GetOnePromptLanguage] = UNSET
+    r"""The language that the prompt is written in. Use this field to categorize the prompt for your own purpose"""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["use_cases", "language"])
+        nullable_fields = set(["language"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k)
+            is_nullable_and_explicitly_set = (
+                k in nullable_fields
+                and (self.__pydantic_fields_set__.intersection({n}))  # pylint: disable=no-member
+            )
+
+            if val != UNSET_SENTINEL:
+                if (
+                    val is not None
+                    or k not in optional_fields
+                    or is_nullable_and_explicitly_set
+                ):
+                    m[k] = val
+
+        return m
+
+
+class GetOnePromptPromptTypedDict(TypedDict):
+    r"""A prompt entity with configuration, metadata, and versioning."""
+
+    id: str
+    type: GetOnePromptType
+    owner: str
+    domain_id: str
+    created: str
+    updated: str
+    display_name: str
+    r"""The prompt’s name, meant to be displayable in the UI."""
+    prompt: GetOnePromptPromptFieldTypedDict
+    r"""Prompt configuration with model and messages. Use this instead of prompt_config."""
+    created_by_id: NotRequired[Nullable[str]]
+    updated_by_id: NotRequired[Nullable[str]]
+    description: NotRequired[Nullable[str]]
+    r"""The prompt’s description, meant to be displayable in the UI. Use this field to optionally store a long form explanation of the prompt for your own purpose"""
+    prompt_config: NotRequired[GetOnePromptPromptConfigTypedDict]
+    r"""[DEPRECATED] Use the `prompt` property instead. A list of messages compatible with the openAI schema."""
+    metadata: NotRequired[GetOnePromptMetadataTypedDict]
+
+
+class GetOnePromptPrompt(BaseModel):
+    r"""A prompt entity with configuration, metadata, and versioning."""
+
+    id: Annotated[str, pydantic.Field(alias="_id")]
+
+    type: GetOnePromptType
+
+    owner: str
+
+    domain_id: str
+
+    created: str
+
+    updated: str
+
+    display_name: str
+    r"""The prompt’s name, meant to be displayable in the UI."""
+
+    prompt: GetOnePromptPromptField
+    r"""Prompt configuration with model and messages. Use this instead of prompt_config."""
+
+    created_by_id: OptionalNullable[str] = UNSET
+
+    updated_by_id: OptionalNullable[str] = UNSET
+
+    description: OptionalNullable[str] = UNSET
+    r"""The prompt’s description, meant to be displayable in the UI. Use this field to optionally store a long form explanation of the prompt for your own purpose"""
+
+    prompt_config: Annotated[
+        Optional[GetOnePromptPromptConfig],
+        pydantic.Field(
+            deprecated="warning: ** DEPRECATED ** - This will be removed in a future release, please migrate away from it as soon as possible."
+        ),
+    ] = None
+    r"""[DEPRECATED] Use the `prompt` property instead. A list of messages compatible with the openAI schema."""
+
+    metadata: Optional[GetOnePromptMetadata] = None
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(
+            [
+                "created_by_id",
+                "updated_by_id",
+                "description",
+                "prompt_config",
+                "metadata",
+            ]
+        )
+        nullable_fields = set(["created_by_id", "updated_by_id", "description"])
+        serialized = handler(self)
         m = {}
 
         for n, f in type(self).model_fields.items():
             k = f.alias or n
             val = serialized.get(k)
-            serialized.pop(k, None)
-
-            optional_nullable = k in optional_fields and k in nullable_fields
-            is_set = (
-                self.__pydantic_fields_set__.intersection({n})
-                or k in null_default_fields
-            )  # pylint: disable=no-member
-
-            if val is not None and val != UNSET_SENTINEL:
-                m[k] = val
-            elif val != UNSET_SENTINEL and (
-                not k in optional_fields or (optional_nullable and is_set)
-            ):
-                m[k] = val
+            is_nullable_and_explicitly_set = (
+                k in nullable_fields
+                and (self.__pydantic_fields_set__.intersection({n}))  # pylint: disable=no-member
+            )
+
+            if val != UNSET_SENTINEL:
+                if (
+                    val is not None
+                    or k not in optional_fields
+                    or is_nullable_and_explicitly_set
+                ):
+                    m[k] = val
 
         return m