Fine Tuning - Create
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 |
Fine |
FineTuningHyperParameters |
|
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 |
Fine |
L'ottimizzazione è stata creata correttamente. Headers Location: string |
Other Status Codes |
Error |
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
POST https://aoairesource.openai.azure.com/openai/fine_tuning/jobs?api-version=2023-12-01-preview
{
"model": "curie",
"training_file": "file-181a1cbdcdcf4677ada87f63a0928099"
}
Sample Response
location: https://aoairesource.openai.azure.com/openai/fine_tuning/jobs/ft-72a2792ef7d24ba7b82c7fe4a37e379f
{
"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 |
Error |
ErrorCode |
Error |
ErrorResponse |
Fine |
FineTuningHyperParameters |
Fine |
FineTuningJob |
Fine |
FineTuningJobCreation |
Fine |
FineTuningState |
Inner |
InnerError |
Inner |
InnerErrorCode |
Type |
TypeDiscriminator |
Error
Errore
Nome | Tipo | Descrizione |
---|---|---|
code |
Error |
ErrorCode |
details |
Error[] |
Dettagli dell'errore, se disponibili. |
innererror |
Inner |
InnerError |
message |
string |
Messaggio di questo errore. |
target |
string |
Percorso in cui si è verificato l'errore, se disponibile. |
ErrorCode
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
ErrorResponse
Nome | Tipo | Descrizione |
---|---|---|
error |
Errore |
FineTuningHyperParameters
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
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 |
Fine |
FineTuningHyperParameters |
id |
string |
Identità dell'elemento. |
model |
string |
Identificatore (model-id) del modello di base usato per l'ottimizzazione. |
object |
Type |
TypeDiscriminator |
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 |
Fine |
FineTuningState |
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
FineTuningJobCreation
Nome | Tipo | Descrizione |
---|---|---|
hyperparameters |
Fine |
FineTuningHyperParameters |
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
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
InnerError
Nome | Tipo | Descrizione |
---|---|---|
code |
Inner |
InnerErrorCode |
innererror |
Inner |
InnerError |
InnerErrorCode
InnerErrorCode
Nome | Tipo | Descrizione |
---|---|---|
invalidPayload |
string |
I dati della richiesta non sono validi per questa operazione. |
TypeDiscriminator
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). |