Fine Tuning - Create

Riferimento

Service:: Azure AI Services

API Version:: 2023-12-01-preview

Crea un processo che consente di modellare un modello specificato da un determinato file di training. La risposta include i dettagli del processo inqueued, tra cui lo stato del processo e i parametri hyper. Il nome del modello ottimizzato viene aggiunto alla risposta al termine.

POST {endpoint}/openai/fine_tuning/jobs?api-version=2023-12-01-preview

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
endpoint	path	True	string url	Endpoint di Servizi cognitivi supportati (protocollo e nome host, ad esempio: https://aoairesource.openai.azure.com. Sostituire "aoairesource" con il nome dell'account Azure OpenAI.
api-version	query	True	string	Versione dell'API richiesta.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
api-key	True	string	Specificare qui la chiave dell'account Azure OpenAI di Servizi cognitivi.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
model	True	string	Identificatore (model-id) del modello di base usato per questa ottimizzazione.
training_file	True	string	Identità file (id file) usata per il training di questo modello ottimizzato.
hyperparameters		FineTuningHyperParameters	FineTuningHyperParameters Le impostazioni dei parametri hyper usate in un processo di ottimizzazione fine.
suffix		string	Suffisso usato per identificare il modello ottimizzato. Il suffisso può contenere fino a 40 caratteri (a-z, A-Z, 0-9 e _) che verranno aggiunti al nome del modello ottimizzato.
validation_file		string	Identità file (id file) usata per valutare il modello ottimizzato durante il training.

Risposte

Nome	Tipo	Descrizione
201 Created	FineTuningJob	L'ottimizzazione è stata creata correttamente. Headers Location: string
Other Status Codes	ErrorResponse	Si è verificato un errore.

Nome

Tipo

Descrizione

201 Created

FineTuningJob

L'ottimizzazione è stata creata correttamente.

Headers

Location: string

Other Status Codes

ErrorResponse

Si è verificato un errore.

Sicurezza

api-key

Specificare qui la chiave dell'account Azure OpenAI di Servizi cognitivi.

Type: apiKey
In: header

Esempio

Creating a fine tune job.

Sample Request

HTTP

POST https://aoairesource.openai.azure.com/openai/fine_tuning/jobs?api-version=2023-12-01-preview


{
  "model": "curie",
  "training_file": "file-181a1cbdcdcf4677ada87f63a0928099"
}

Sample Response

Status code:: 201

location: https://aoairesource.openai.azure.com/openai/fine_tuning/jobs/ft-72a2792ef7d24ba7b82c7fe4a37e379f

Response Body

{
  "hyperparameters": {
    "n_epochs": 2
  },
  "model": "curie",
  "training_file": "file-181a1cbdcdcf4677ada87f63a0928099",
  "id": "ft-72a2792ef7d24ba7b82c7fe4a37e379f",
  "status": "notRunning",
  "created_at": 1646126127,
  "updated_at": 1646127311,
  "object": "fine_tuning.job"
}

Definizioni

Nome	Descrizione
Error	Errore
ErrorCode	ErrorCode
ErrorResponse	ErrorResponse
FineTuningHyperParameters	FineTuningHyperParameters
FineTuningJob	FineTuningJob
FineTuningJobCreation	FineTuningJobCreation
FineTuningState	FineTuningState
InnerError	InnerError
InnerErrorCode	InnerErrorCode
TypeDiscriminator	TypeDiscriminator

Error

Errore

Nome	Tipo	Descrizione
code	ErrorCode	ErrorCode Codici di errore definiti nelle linee guida REST Di Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
details	Error[]	Dettagli dell'errore, se disponibili.
innererror	InnerError	InnerError Errore interno, come definito nelle linee guida di Microsoft REST (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
message	string	Messaggio di questo errore.
target	string	Percorso in cui si è verificato l'errore, se disponibile.

ErrorCode

Nome	Tipo	Descrizione
conflict	string	L'operazione richiesta è in conflitto con lo stato della risorsa corrente.
contentFilter	string	La generazione di immagini non è riuscita a causa del nostro sistema di sicurezza.
fileImportFailed	string	Importazione del file non riuscita.
forbidden	string	L'operazione non è consentita per la chiave utente/API corrente.
internalFailure	string	Errore interno. Riprovare.
invalidPayload	string	I dati della richiesta non sono validi per questa operazione.
itemDoesAlreadyExist	string	L'elemento esiste già.
jsonlValidationFailed	string	La convalida dei dati jsonl non è riuscita.
notFound	string	La risorsa non viene trovata.
quotaExceeded	string	Quota superata.
serviceUnavailable	string	Il servizio non è attualmente disponibile.
tooManyRequests	string	Numero eccessivo di richieste. Riprovare più tardi.
unauthorized	string	La chiave utente/API corrente non è autorizzata per l'operazione.
unexpectedEntityState	string	L'operazione non può essere eseguita nello stato della risorsa corrente.

ErrorResponse

Nome	Tipo	Descrizione
error	Error	Errore Contenuto degli errori come definito nelle linee guida di Microsoft REST (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

FineTuningHyperParameters

Nome	Tipo	Descrizione
batch_size	integer	Dimensioni del batch da usare per il training. Le dimensioni del batch sono il numero di esempi di training usati per eseguire il training di un singolo passaggio avanti e indietro. In generale, è stato rilevato che le dimensioni dei batch più grandi tendono a funzionare meglio per set di dati di dimensioni maggiori. Il valore predefinito e il valore massimo per questa proprietà sono specifici di un modello di base.
learning_rate_multiplier	number	Moltiplicatore della frequenza di apprendimento da usare per il training. La velocità di apprendimento per l'ottimizzazione è la frequenza di apprendimento originale usata per il pre-training moltiplicato per questo valore. I tassi di apprendimento più elevati tendono a ottenere prestazioni migliori con dimensioni batch maggiori. È consigliabile sperimentare i valori nell'intervallo da 0,02 a 0,2 per vedere quali risultati producono i risultati migliori.
n_epochs	integer	Numero di periodi per cui eseguire il training del modello. Un periodo fa riferimento a un ciclo completo attraverso il set di dati di training.

FineTuningJob

Nome	Tipo	Descrizione
created_at	integer	Timestamp quando è stato creato questo processo o elemento (in periodi unix).
fine_tuned_model	string	Identificatore (model-id) del modello ottimizzato risultante. Questa proprietà viene popolata solo per le esecuzioni completate correttamente. Usare questo identificatore per creare una distribuzione per l'inferenza.
finished_at	integer	Timestamp al termine del processo o dell'elemento (in periodi unix).
hyperparameters	FineTuningHyperParameters	FineTuningHyperParameters Impostazioni del parametro hyper usate in un processo di ottimizzazione.
id	string	Identità dell'elemento.
model	string	Identificatore (model-id) del modello di base usato per l'ottimizzazione.
object	TypeDiscriminator	TypeDiscriminator Definisce il tipo di un oggetto .
organisation_id	string	Id organizzazione di questo lavoro di ottimizzazione. Non usato in Azure OpenAI; compatibilità solo per OpenAI.
result_files	string[]	Identità dei file risultanti (id file) contenenti metriche di training e valutazione in formato CSV. Il file è disponibile solo per le esecuzioni completate correttamente.
status	FineTuningState	FineTuningState Stato di un oggetto di finetunes o di un processo di ottimizzazione.
suffix	string	Suffisso usato per identificare il modello ottimizzato. Il suffisso può contenere fino a 40 caratteri (a-z, A-Z, 0-9 e _) che verranno aggiunti al nome del modello ottimizzato.
trained_tokens	integer	Numero totale di token fatturabili elaborati da questo processo di ottimizzazione.
training_file	string	File utilizzato per il training.
updated_at	integer	Timestamp quando il processo o l'elemento è stato modificato per ultimo (in periodi Unix).
validation_file	string	File utilizzato per valutare il modello ottimizzato durante il training.

FineTuningJobCreation

Nome	Tipo	Descrizione
hyperparameters	FineTuningHyperParameters	FineTuningHyperParameters Impostazioni del parametro hyper usate in un processo di ottimizzazione.
model	string	Identificatore (model-id) del modello di base usato per questa ottimizzazione.
suffix	string	Suffisso usato per identificare il modello ottimizzato. Il suffisso può contenere fino a 40 caratteri (a-z, A-Z, 0-9 e _) che verranno aggiunti al nome del modello ottimizzato.
training_file	string	Identità del file (id file) usata per il training di questo modello ottimizzato.
validation_file	string	Identità del file (id file) usata per valutare il modello ottimizzato durante il training.

FineTuningState

Nome	Tipo	Descrizione
cancelled	string	L'operazione è stata annullata ed è incompleta. Può essere categorizzato come stato terminale.
created	string	L'operazione è stata creata. Questo stato non viene restituito da Azure OpenAI ed esposto solo per la compatibilità. Può essere categorizzato come stato inattivo.
failed	string	L'operazione ha completato l'elaborazione con un errore e non può essere ulteriormente utilizzata. Può essere categorizzato come stato terminale.
pending	string	L'operazione non è ancora in coda da elaborare in futuro. Può essere categorizzato come stato inattivo.
running	string	L'operazione è stata avviata per l'elaborazione. Può essere categorizzato come stato attivo.
succeeded	string	L'operazione è stata elaborata correttamente ed è pronta per l'utilizzo. Può essere categorizzato come stato terminale.

InnerError

Nome	Tipo	Descrizione
code	InnerErrorCode	InnerErrorCode Codici di errore interni definiti nelle linee guida microsoft REST (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
innererror	InnerError	InnerError Errore interno, come definito nelle linee guida di Microsoft REST (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

InnerErrorCode

Nome	Tipo	Descrizione
invalidPayload	string	I dati della richiesta non sono validi per questa operazione.

TypeDiscriminator

Nome	Tipo	Descrizione
file	string	Questo oggetto rappresenta un file.
fine-tune	string	Questo oggetto rappresenta un processo di ottimizzazione.
fine-tune-event	string	Questo oggetto rappresenta un evento di un processo di ottimizzazione.
fine_tuning.job	string	Questo oggetto rappresenta un processo di ottimizzazione.
fine_tuning.job.event	string	Questo oggetto rappresenta un evento di un processo di ottimizzazione.
list	string	Questo oggetto rappresenta un elenco di altri oggetti.
model	string	Questo oggetto rappresenta un modello (può essere un modello di base o ottimizzare il risultato del processo).

Share via

Fine Tuning - Create

Parametri dell'URI

Intestazione della richiesta

Corpo della richiesta

Risposte

Sicurezza

api-key

Esempio

Creating a fine tune job.

Sample Request

Sample Response

Definizioni

Error

ErrorCode

ErrorResponse

FineTuningHyperParameters

FineTuningJob

FineTuningJobCreation

FineTuningState

InnerError

InnerErrorCode

TypeDiscriminator

Risorse aggiuntive