o {$fnk@shddlmZddlmZmZmZddlmZddlZddl m Z ddl m Z m Z mZmZmZddlmZmZdd lmZd d lmZmZmZmZmZmZdd lmZmZdd l m!Z!m"Z"ddl#m$Z$m%Z%ddl&m'Z'm(Z(ddl)m*Z*m+Z+m,Z,ddl-m.Z.ddl/m0Z0ddgZ1GdddeZ2GdddeZ3GdddZ4GdddZ5GdddZ6GdddZ7dS)) annotations)UnionIterableOptional)LiteralN)_legacy_response) NOT_GIVENBodyQueryHeadersNotGiven)maybe_transformasync_maybe_transform)cached_property) CheckpointsAsyncCheckpointsCheckpointsWithRawResponseAsyncCheckpointsWithRawResponse CheckpointsWithStreamingResponse%AsyncCheckpointsWithStreamingResponse)SyncAPIResourceAsyncAPIResource)to_streamed_response_wrapper"async_to_streamed_response_wrapper)SyncCursorPageAsyncCursorPage)AsyncPaginatormake_request_options)job_list_paramsjob_create_paramsjob_list_events_params) FineTuningJob)FineTuningJobEventJobs AsyncJobsc @eZdZed6ddZed7ddZed8d d Zeeeeed d d ed d9d#d$Zd d d ed%d:d'd(Z eed d d ed)d;d/d0Z d d d ed%d:d1d2Z eed d d ed)dHeaders | Noner? Query | Noner@ Body | NonerA'float | httpx.Timeout | None | NotGivenr#c Cs6|jdt|||||||dtjt|| | | dtdS) Creates a fine-tuning job which begins the process of creating a new model from a given dataset. Response includes details of the enqueued job including job status and the name of the fine-tuned models once complete. [Learn more about fine-tuning](https://platform.openai.com/docs/guides/fine-tuning) Args: model: The name of the model to fine-tune. You can select one of the [supported models](https://platform.openai.com/docs/guides/fine-tuning/which-models-can-be-fine-tuned). training_file: The ID of an uploaded file that contains training data. See [upload file](https://platform.openai.com/docs/api-reference/files/create) for how to upload a file. Your dataset must be formatted as a JSONL file. Additionally, you must upload your file with the purpose `fine-tune`. The contents of the file should differ depending on if the model uses the [chat](https://platform.openai.com/docs/api-reference/fine-tuning/chat-input) or [completions](https://platform.openai.com/docs/api-reference/fine-tuning/completions-input) format. See the [fine-tuning guide](https://platform.openai.com/docs/guides/fine-tuning) for more details. hyperparameters: The hyperparameters used for the fine-tuning job. integrations: A list of integrations to enable for your fine-tuning job. seed: The seed controls the reproducibility of the job. Passing in the same seed and job parameters should produce the same results, but may differ in rare cases. If a seed is not specified, one will be generated for you. suffix: A string of up to 18 characters that will be added to your fine-tuned model name. For example, a `suffix` of "custom-model-name" would produce a model name like `ft:gpt-4o-mini:openai:custom-model-name:7p4lURel`. validation_file: The ID of an uploaded file that contains validation data. If you provide this file, the data is used to generate validation metrics periodically during fine-tuning. These metrics can be viewed in the fine-tuning results file. The same data should not be present in both train and validation files. Your dataset must be formatted as a JSONL file. You must upload your file with the purpose `fine-tune`. See the [fine-tuning guide](https://platform.openai.com/docs/guides/fine-tuning) for more details. extra_headers: Send extra headers extra_query: Add additional query parameters to the request extra_body: Add additional JSON properties to the request timeout: Override the client-level default timeout for this request, in seconds /fine_tuning/jobsrBrDr9r:r;r<r=r>r?r@rAbodyoptionscast_to)_postrr!JobCreateParamsrr# r-rBrDr9r:r;r<r=r>r?r@rAr.r.r/create4s$Q  z Jobs.createrQfine_tuning_job_idcCs4|s td||jd|t||||dtdS) Get info about a fine-tuning job. [Learn more about fine-tuning](https://platform.openai.com/docs/guides/fine-tuning) Args: extra_headers: Send extra headers extra_query: Add additional query parameters to the request extra_body: Add additional JSON properties to the request timeout: Override the client-level default timeout for this request, in seconds AExpected a non-empty value for `fine_tuning_job_id` but received /fine_tuning/jobs/rQrTrU ValueError_getrr#r-rZr>r?r@rAr.r.r/retrievesz Jobs.retrieveafterlimitr>r?r@rArestr | NotGivenrfint | NotGivenSyncCursorPage[FineTuningJob]c C2|jdttt||||t||dtjdtdSa List your organization's fine-tuning jobs Args: after: Identifier for the last job from the previous pagination request. limit: Number of fine-tuning jobs to retrieve. extra_headers: Send extra headers extra_query: Add additional query parameters to the request extra_body: Add additional JSON properties to the request timeout: Override the client-level default timeout for this request, in seconds rOrerfr>r?r@rAquerypagerTrB) _get_api_listrr#rrr JobListParamsr-rerfr>r?r@rAr.r.r/list" z Jobs.listcCs6|s td||jd|dt||||dtdS)W Immediately cancel a fine-tune job. Args: extra_headers: Send extra headers extra_query: Add additional query parameters to the request extra_body: Add additional JSON properties to the request timeout: Override the client-level default timeout for this request, in seconds r\r]/cancelrQr^r`rVrr#rbr.r.r/cancels z Jobs.cancel"SyncCursorPage[FineTuningJobEvent]c CL|s td||jd|dttt||||t||dtjdtdSa Get status updates for a fine-tuning job. Args: after: Identifier for the last event from the previous pagination request. limit: Number of events to retrieve. extra_headers: Send extra headers extra_query: Add additional query parameters to the request extra_body: Add additional JSON properties to the request timeout: Override the client-level default timeout for this request, in seconds r\r]z/eventsrlrmro)r`rqrr$rrr"JobListEventsParamsr-rZrerfr>r?r@rAr.r.r/ list_events &  zJobs.list_events)r(r)r(r2)r(r6rBrCrDrEr9rFr:rGr;rHr<rIr=rIr>rJr?rKr@rLrArMr(r# rZrEr>rJr?rKr@rLrArMr(r#)rergrfrhr>rJr?rKr@rLrArMr(ri)rZrErergrfrhr>rJr?rKr@rLrArMr(rz __name__ __module__ __qualname__rr0r4r7r rYrcrtryrr.r.r.r/r%'R   k&5%c @r')=r&r(rcCr)r*)rr+r,r.r.r/r0@r1zAsyncJobs.checkpointsAsyncJobsWithRawResponsecCr3r*)rr,r.r.r/r4Dr5zAsyncJobs.with_raw_responseAsyncJobsWithStreamingResponsecCr3r*)rr,r.r.r/r7Hr5z!AsyncJobs.with_streaming_responseNr8rBrCrDrEr9rFr:rGr;rHr<rIr=r>rJr?rKr@rLrArMr#c sD|jdt|||||||dtjIdHt|| | | dtdIdHS)rNrOrPNrQrR)rVrr!rWrr#rXr.r.r/rYLs&Q   zAsyncJobs.createrQrZcs<|s td||jd|t||||dtdIdHS)r[r\r]rQr^Nr_rbr.r.r/rcs zAsyncJobs.retrieverdrergrfrh=AsyncPaginator[FineTuningJob, AsyncCursorPage[FineTuningJob]]c Crjrk)rqrr#rrr rrrsr.r.r/rtruzAsyncJobs.listcs>|s td||jd|dt||||dtdIdHS)rvr\r]rwrQr^Nrxrbr.r.r/rys  zAsyncJobs.cancelGAsyncPaginator[FineTuningJobEvent, AsyncCursorPage[FineTuningJobEvent]]c Cr{r|)r`rqrr$rrr"r}r~r.r.r/r$rzAsyncJobs.list_events)r(r)r(r)r(rrr)rergrfrhr>rJr?rKr@rLrArMr(r)rZrErergrfrhr>rJr?rKr@rLrArMr(rrr.r.r.r/r&?rc@$eZdZd ddZed dd Zd S) r2jobsr%r(NonecCP||_t|j|_t|j|_t|j|_t|j|_t|j|_dSr*)_jobsrto_raw_response_wrapperrYrcrtryrr-rr.r.r/__init__X  zJobsWithRawResponse.__init__rcC t|jjSr*)rrr0r,r.r.r/r0k zJobsWithRawResponse.checkpointsNrr%r(r)r(rrrrrrr0r.r.r.r/r2W r2c@r) rrr&r(rcCrr*)rrasync_to_raw_response_wrapperrYrcrtryrrr.r.r/rqrz!AsyncJobsWithRawResponse.__init__rcCrr*)rrr0r,r.r.r/r0rz$AsyncJobsWithRawResponse.checkpointsNrr&r(r)r(rrr.r.r.r/rprrc@r) r6rr%r(rcCF||_t|j|_t|j|_t|j|_t|j|_t|j|_dSr*)rrrYrcrtryrrr.r.r/r  z"JobsWithStreamingResponse.__init__rcCrr*)rrr0r,r.r.r/r0rz%JobsWithStreamingResponse.checkpointsNr)r(rrr.r.r.r/r6rr6c@r) rrr&r(rcCrr*)rrrYrcrtryrrr.r.r/rrz'AsyncJobsWithStreamingResponse.__init__rcCrr*)rrr0r,r.r.r/r0rz*AsyncJobsWithStreamingResponse.checkpointsNr)r(rrr.r.r.r/rrr)8 __future__rtypingrrrtyping_extensionsrhttpxr_typesr r r r r _utilsrr_compatrr0rrrrrr _resourcerr _responserr paginationrr _base_clientrrtypes.fine_tuningr r!r"!types.fine_tuning.fine_tuning_jobr#'types.fine_tuning.fine_tuning_job_eventr$__all__r%r&r2rr6rr.r.r.r/s6