IgKm ddlmZddlmZmZmZmZmZmZm Z ddl m Z ddl m Z ddlZddlmZddlmZmZmZmZmZdd lmZmZdd lmZdd lmZmZdd lm Z m!Z!dd l"m#Z#ddl$m%Z%ddl&m'Z'ddl(m)Z)m*Z+m,Z-m.Z/ddl0m1Z1ddl2m3Z3m4Z4ddl5m6Z6ddl7m8Z8ddl9m:Z:ddl;mZ>ddl?m@Z@ddlAmBZBddlCmDZDddlEmFZFddlGmHZHddgZIGddeZJGd deZKGd!d"ZLGd#d$ZMGd%d&ZNGd'd(ZOy))) annotations)DictListTypeUnionIterableOptionalcast)partial)LiteralN)_legacy_response) NOT_GIVENBodyQueryHeadersNotGiven)maybe_transformasync_maybe_transform)cached_property)SyncAPIResourceAsyncAPIResource)to_streamed_response_wrapper"async_to_streamed_response_wrapper)Stream)completion_create_params)make_request_options)ResponseFormatTvalidate_input_toolsparse_chat_completiontype_to_response_format_param) ChatModel)ChatCompletionStreamManager AsyncChatCompletionStreamManager)ChatCompletion)ChatCompletionChunk)ParsedChatCompletion)ChatCompletionModality)ChatCompletionToolParam)ChatCompletionAudioParam)ChatCompletionMessageParam) ChatCompletionStreamOptionsParam)$ChatCompletionPredictionContentParam)#ChatCompletionToolChoiceOptionParam CompletionsAsyncCompletionsceZdZeddZeddZeeeeeeeeeeeeeeeeeeeeeeeeeeddded d dZeeeeeeeeeeeeeeeeeeeeeeeeeeddded d dZy) r/ct|Sa This property can be used as a prefix for any HTTP method call to return the the raw response object instead of the parsed content. For more information, see https://www.github.com/openai/openai-python#accessing-raw-response-data-eg-headers )CompletionsWithRawResponseselfs c/var/www/html/answerous/venv/lib/python3.12/site-packages/openai/resources/beta/chat/completions.pywith_raw_responsezCompletions.with_raw_response+s*$//ct|Sz An alternative to `.with_raw_response` that doesn't eagerly read the response body. For more information, see https://www.github.com/openai/openai-python#with_streaming_response ) CompletionsWithStreamingResponser5s r7with_streaming_responsez#Completions.with_streaming_response5s055r9Naudioresponse_formatfrequency_penalty function_call functions logit_biaslogprobsmax_completion_tokens max_tokensmetadata modalitiesnparallel_tool_calls predictionpresence_penaltyseed service_tierstopstorestream_options temperature tool_choicetools top_logprobstop_puser extra_headers extra_query extra_bodytimeoutc tddi|xsi}dfd }!|jdtid|d|d|d|d |d |d |d | d | d| d| d| d|d|d|d|dt||||d||||||d tj t |||| |!tttttdS)aWrapper over the `client.chat.completions.create()` method that provides richer integrations with Python specific types & returns a `ParsedChatCompletion` object, which is a subclass of the standard `ChatCompletion` class. You can pass a pydantic model to this method and it will automatically convert the model into a JSON schema, send it to the API and parse the response content back into the given model. This method will also automatically parse `function` tool calls if: - You use the `openai.pydantic_function_tool()` helper method - You mark your tool schema with `"strict": True` Example usage: ```py from pydantic import BaseModel from openai import OpenAI class Step(BaseModel): explanation: str output: str class MathResponse(BaseModel): steps: List[Step] final_answer: str client = OpenAI() completion = client.beta.chat.completions.parse( model="gpt-4o-2024-08-06", messages=[ {"role": "system", "content": "You are a helpful math tutor."}, {"role": "user", "content": "solve 8x + 31 = 2"}, ], response_format=MathResponse, ) message = completion.choices[0].message if message.parsed: print(message.parsed.steps) print("answer: ", message.parsed.final_answer) ``` X-Stainless-Helper-Methodbeta.chat.completions.parsec t|SN)r@chat_completion input_tools_parse_chat_completionraw_completionr@rUs r7parserz!Completions.parse..parser) / .! r9/chat/completionsmessagesmodelr?rArBrCrDrErFrGrHrIrJrKrLrMr@F) rNrOrPrQstreamrRrSrTrUrVrWrXrYrZr[r\ post_parserbodyoptionscast_tormrgr%return%ParsedChatCompletion[ResponseFormatT]) _validate_input_tools_postr_type_to_response_formatrCompletionCreateParamsrr rr'rr%"r6rkrlr?r@rArBrCrDrErFrGrHrIrJrKrLrMrNrOrPrQrRrSrTrUrVrWrXrYrZr[r\rhs" ` ` r7parsezCompletions.parse>s` e$ ()F "  zz  UU():  $]    !*,-B!*!**+>!* '(8!"&'?'P#$!$0 "#&4#.#."$0" ;>)??A!D)+'%" 2?CDnU]/ / r9c nddi|xsi}t|jjjjfid|d|d|dddt |d |d |d |d |d | d| d| d| d| d|d|d|d|d|d|d|d|d|d|d|d|d|d|d |d!|d"|d#|d$| }!t |!||%S)&aWrapper over the `client.chat.completions.create(stream=True)` method that provides a more granular event API and automatic accumulation of each delta. This also supports all of the parsing utilities that `.parse()` does. Unlike `.create(stream=True)`, the `.stream()` method requires usage within a context manager to prevent accidental leakage of the response: ```py with client.beta.chat.completions.stream( model="gpt-4o-2024-08-06", messages=[...], ) as stream: for event in stream: if event.type == "content.delta": print(event.delta, flush=True, end="") ``` When the context manager is entered, a `ChatCompletionStream` instance is returned which, like `.create(stream=True)` is an iterator. The full list of events that are yielded by the iterator are outlined in [these docs](https://github.com/openai/openai-python/blob/main/helpers.md#chat-completions-events). When the context manager exits, the response will be closed, however the `stream` instance is still available outside the context manager. r^beta.chat.completions.streamrkrlr?rmTr@rArBrCrDrErFrGrHrIrJrKrLrMrNrOrQrPrRrSrTrUrVrWrXrYrZr[r\r@rc)r _clientchat completionscreateryr#"r6rkrlr?r@rArBrCrDrErFrGrHrIrJrKrLrMrNrOrPrQrRrSrTrUrVrWrXrYrZr[r\ api_requests" r7rmzCompletions.streamsz ()G " =D LL   ) ) 0 0#= #= #=  #=  #= 5_E #= 0#= (#=  #= "#= #= #8#= "#= #= "#= !#= "!4##= $"%#= &.'#= ()#= *&+#= ,-#= ./#= 0*1#= 2$3#= 4$5#= 67#= 8&9#= :;#= <=#= >(?#= @$A#= B"C#= DE#= H+ +  r9)rur4)rur<Brk$Iterable[ChatCompletionMessageParam]rlUnion[str, ChatModel]r?-Optional[ChatCompletionAudioParam] | NotGivenr@z type[ResponseFormatT] | NotGivenrAOptional[float] | NotGivenrB0completion_create_params.FunctionCall | NotGivenrC6Iterable[completion_create_params.Function] | NotGivenrD#Optional[Dict[str, int]] | NotGivenrEOptional[bool] | NotGivenrFOptional[int] | NotGivenrGrrH#Optional[Dict[str, str]] | NotGivenrI1Optional[List[ChatCompletionModality]] | NotGivenrJrrKbool | NotGivenrL9Optional[ChatCompletionPredictionContentParam] | NotGivenrMrrNrrO/Optional[Literal['auto', 'default']] | NotGivenrP*Union[Optional[str], List[str]] | NotGivenrQrrR5Optional[ChatCompletionStreamOptionsParam] | NotGivenrSrrT.ChatCompletionToolChoiceOptionParam | NotGivenrU,Iterable[ChatCompletionToolParam] | NotGivenrVrrWrrXstr | NotGivenrYHeaders | NonerZ Query | Noner[ Body | Noner\'float | httpx.Timeout | None | NotGivenrurv)Brkrrlrr?rr@Jcompletion_create_params.ResponseFormat | type[ResponseFormatT] | NotGivenrArrBrrCrrDrrErrFrrGrrHrrIrrJrrKrrLrrMrrNrrOrrPrrQrrRrrSrrTrrUrrVrrWrrXrrYrrZrr[rr\rruz,ChatCompletionStreamManager[ResponseFormatT] __name__ __module__ __qualname__rr8r=rr|rmr9r7r/r/*s0066@IG1:,5()-$("&;DIM 7M % M = M : M 6M HM JM 8M ,M  8M -M 6M FM $!M "-#M $N%M &5'M (')M *F+M ,9-M .)/M 0N1M 203M 4D5M 6<7M 8/9M :*;M <=M B&CM D"EM F GM H9IM J /KM h@Ifo8AJSLU:C.7:C/88AHQ&//8PY7@)2HQ;D+4PY2;FO>G1:,5()-$("&;DIi 7i % i = i d i 6i Hi Ji 8i ,i  8i -i 6i Fi $!i "-#i $N%i &5'i (')i *F+i ,9-i .)/i 0N1i 203i 4D5i 6<7i 8/9i :*;i <=i B&Ci D"Ei F Gi H9Ii J 6Ki r9ceZdZeddZeddZeeeeeeeeeeeeeeeeeeeeeeeeeeddded d dZeeeeeeeeeeeeeeeeeeeeeeeeeeddded d dZy) r0ct|Sr3)AsyncCompletionsWithRawResponser5s r7r8z"AsyncCompletions.with_raw_response:s/t44r9ct|Sr;)%AsyncCompletionsWithStreamingResponser5s r7r=z(AsyncCompletions.with_streaming_responseDs5T::r9Nr>c Ktddi|xsi}dfd }!|jdtid|d|d|d|d |d |d |d | d | d| d| d| d|d|d|d|dt||||d||||||d tj d{t |||| |!tttttdd{S7B7w)aWrapper over the `client.chat.completions.create()` method that provides richer integrations with Python specific types & returns a `ParsedChatCompletion` object, which is a subclass of the standard `ChatCompletion` class. You can pass a pydantic model to this method and it will automatically convert the model into a JSON schema, send it to the API and parse the response content back into the given model. This method will also automatically parse `function` tool calls if: - You use the `openai.pydantic_function_tool()` helper method - You mark your tool schema with `"strict": True` Example usage: ```py from pydantic import BaseModel from openai import AsyncOpenAI class Step(BaseModel): explanation: str output: str class MathResponse(BaseModel): steps: List[Step] final_answer: str client = AsyncOpenAI() completion = await client.beta.chat.completions.parse( model="gpt-4o-2024-08-06", messages=[ {"role": "system", "content": "You are a helpful math tutor."}, {"role": "user", "content": "solve 8x + 31 = 2"}, ], response_format=MathResponse, ) message = completion.choices[0].message if message.parsed: print(message.parsed.steps) print("answer: ", message.parsed.final_answer) ``` r^r_c t|Srardrfs r7rhz&AsyncCompletions.parse..parserrir9rjrkrlr?rArBrCrDrErFrGrHrIrJrKrLrMr@F) rNrOrQrPrmrRrSrTrUrVrWrXNrnrprt) rwrxrryrrzrr rr'rr%r{s" ` ` r7r|zAsyncCompletions.parseMs` e$ ()F "  ZZ ,UU():  $]    !*,-B!*!**+>!* '(8!"&'?'P#$!$0" #&4#.#."$0" ;>)??A!!D)+'%" 2?CDnU] / / / !/ s$BCC =CCCCc |t|ddi|xsi}|jjjjd&id|d|d|dddt |d |d |d |d |d | d| d| d| d| d|d|d|d|d|d|d|d|d|d|d|d|d|d|d |d!|d"|d#|d$| }!t |!||%S)'aWrapper over the `client.chat.completions.create(stream=True)` method that provides a more granular event API and automatic accumulation of each delta. This also supports all of the parsing utilities that `.parse()` does. Unlike `.create(stream=True)`, the `.stream()` method requires usage within a context manager to prevent accidental leakage of the response: ```py async with client.beta.chat.completions.stream( model="gpt-4o-2024-08-06", messages=[...], ) as stream: async for event in stream: if event.type == "content.delta": print(event.delta, flush=True, end="") ``` When the context manager is entered, an `AsyncChatCompletionStream` instance is returned which, like `.create(stream=True)` is an async iterator. The full list of events that are yielded by the iterator are outlined in [these docs](https://github.com/openai/openai-python/blob/main/helpers.md#chat-completions-events). When the context manager exits, the response will be closed, however the `stream` instance is still available outside the context manager. r^r~rkrlr?rmTr@rArBrCrDrErFrGrHrIrJrKrLrMrNrOrPrQrRrSrTrUrVrWrXrYrZr[r\rr)rwrrrrryr$rs" r7rmzAsyncCompletions.streamsx e$ ()G " ;dll''33::" " " "  " 5_E " 0 " ("  " "" " #8" "" " "" " !4!" ""#" $.%" &'" (&)" *+" ,-" .*/" 0$1" 2$3" 45" 6&7" 89" :;" <(=" >$?" @"A" BC" F0 +  r9)rur)rurr)Brkrrlrr?rr@rrArrBrrCrrDrrErrFrrGrrHrrIrrJrrKrrLrrMrrNrrOrrPrrQrrRrrSrrTrrUrrVrrWrrXrrYrrZrr[rr\rruz1AsyncChatCompletionStreamManager[ResponseFormatT]rrr9r7r0r09s55;;@IG1:,5()-$("&;DIM 7M % M = M : M 6M HM JM 8M ,M  8M -M 6M FM $!M "-#M $N%M &5'M (')M *F+M ,9-M .)/M 0N1M 203M 4D5M 6<7M 8/9M :*;M <=M B&CM D"EM F GM H9IM J /KM h@Ifo8AJSLU:C.7:C/88AHQ&//8PY7@)2HQ;D+4PY2;FO>G1:,5()-$("&;DIj 7j % j = j d j 6j Hj Jj 8j ,j  8j -j 6j Fj $!j "-#j $N%j &5'j (')j *F+j ,9-j .)/j 0N1j 203j 4D5j 6<7j 8/9j :*;j <=j B&Cj D"Ej F Gj H9Ij J ;Kj r9ceZdZddZy)r4cZ||_tj|j|_yN) _completionsrto_raw_response_wrapperr|r6rs r7__init__z#CompletionsWithRawResponse.__init__Js%'%==     r9Nrr/ruNonerrrrrr9r7r4r4I r9r4ceZdZddZy)rcZ||_tj|j|_yr)rrasync_to_raw_response_wrapperr|rs r7rz(AsyncCompletionsWithRawResponse.__init__Ss%'%CC     r9Nrr0rurrrr9r7rrRrr9rceZdZddZy)r<cF||_t|j|_yr)rrr|rs r7rz)CompletionsWithStreamingResponse.__init__\s'1     r9Nrrrr9r7r<r<[rr9r<ceZdZddZy)rcF||_t|j|_yr)rrr|rs r7rz.AsyncCompletionsWithStreamingResponse.__init__es'7     r9Nrrrr9r7rrdrr9r)P __future__rtypingrrrrrr r functoolsr typing_extensionsr httpxr_typesrrrrr_utilsrr_compatr _resourcerr _responserr _streamingr types.chatr _base_clientr lib._parsingrrrwr rer!rytypes.chat_modelr"lib.streaming.chatr#r$types.chat.chat_completionr% types.chat.chat_completion_chunkr&!types.chat.parsed_chat_completionr'#types.chat.chat_completion_modalityr(%types.chat.chat_completion_tool_paramr)&types.chat.chat_completion_audio_paramr*(types.chat.chat_completion_message_paramr+/types.chat.chat_completion_stream_options_paramr,3types.chat.chat_completion_prediction_content_paramr-3types.chat.chat_completion_tool_choice_option_paramr.__all__r/r0r4rr<rrr9r7rs#DDD% !@@=';Z!31 +`9DFJMOS`hg , -L /L ^M 'M `        r9