Fine Tuning - Create
Cria um trabalho que ajusta um modelo especificado a partir de um determinado arquivo de treinamento. A resposta inclui detalhes do trabalho enfileirado, incluindo status do trabalho e hiperparâmetros. O nome do modelo ajustado é adicionado à resposta depois de concluído.
POST {endpoint}/openai/fine_tuning/jobs?api-version=2024-10-21
Parâmetros URI
| Nome | Em | Necessário | Tipo | Descrição |
|---|---|---|---|---|
|
endpoint
|
path | True |
string (url) |
Pontos de extremidade de Serviços Cognitivos suportados (protocolo e nome do host, por exemplo: https://aoairesource.openai.azure.com. Substitua "aoairesource" pelo nome da sua conta do Azure OpenAI). |
|
api-version
|
query | True |
string |
A versão da API solicitada. |
Cabeçalho de Pedido
| Nome | Necessário | Tipo | Descrição |
|---|---|---|---|
| api-key | True |
string |
Forneça sua chave de conta do Azure OpenAI dos Serviços Cognitivos aqui. |
Órgão do Pedido
| Nome | Necessário | Tipo | Descrição |
|---|---|---|---|
| model | True |
string minLength: 1 |
O identificador (model-id) do modelo base usado para esse ajuste fino. |
| training_file | True |
string minLength: 1 |
A identidade do arquivo (file-id) que é usada para treinar esse modelo ajustado. |
| hyperparameters |
FineTuningHyperParameters |
||
| seed |
integer (int32) |
A semente usada para o trabalho de ajuste fino. Passar os mesmos parâmetros de semente e trabalho deve produzir os mesmos resultados, mas pode diferir em casos raros. Se uma semente não for especificada, uma será gerada para você. |
|
| suffix |
string |
O sufixo usado para identificar o modelo ajustado. O sufixo pode conter até 40 caracteres (a-z, A-Z, 0-9,- e _) que serão adicionados ao seu nome de modelo ajustado. |
|
| validation_file |
string |
A identidade do arquivo (file-id) usada para avaliar o modelo ajustado durante o treinamento. |
Respostas
| Nome | Tipo | Descrição |
|---|---|---|
| 201 Created |
O ajuste fino foi criado com sucesso. Cabeçalhos Location: string |
|
| Other Status Codes |
Ocorreu um erro. |
Segurança
api-key
Forneça sua chave de conta do Azure OpenAI dos Serviços Cognitivos aqui.
Tipo:
apiKey
Em:
header
Exemplos
Creating a fine tuning job.
Pedido de exemplo
POST https://aoairesource.openai.azure.com/openai/fine_tuning/jobs?api-version=2024-10-21
{
"model": "curie",
"training_file": "file-181a1cbdcdcf4677ada87f63a0928099"
}
Resposta de exemplo
location: https://aoairesource.openai.azure.com/openai/fine_tuning/jobs/ft-72a2792ef7d24ba7b82c7fe4a37e379f
{
"hyperparameters": {
"n_epochs": -1
},
"status": "pending",
"model": "curie",
"training_file": "file-181a1cbdcdcf4677ada87f63a0928099",
"id": "ft-72a2792ef7d24ba7b82c7fe4a37e379f",
"created_at": 1646126127,
"object": "fine_tuning.job"
}
Definições
| Nome | Descrição |
|---|---|
| Error |
Erro |
|
Error |
Código de erro |
|
Error |
ErrorResponse |
|
Fine |
FineTuningHyperParameters |
|
Fine |
FineTuningJob |
|
Fine |
FineTuningCriação de Empregos |
|
Fine |
FineTuningJobError |
|
Fine |
FineTuningState |
|
Inner |
InnerError |
|
Inner |
InnerErrorCode |
|
Type |
TipoDiscriminador |
Error
Erro
| Nome | Tipo | Descrição |
|---|---|---|
| code |
Código de erro |
|
| details |
Error[] |
Os detalhes do erro, se disponíveis. |
| innererror |
InnerError |
|
| message |
string minLength: 1 |
A mensagem deste erro. |
| target |
string |
O local onde o erro aconteceu, se disponível. |
ErrorCode
Código de erro
| Valor | Descrição |
|---|---|
| conflict |
A operação solicitada entra em conflito com o estado atual do recurso. |
| invalidPayload |
Os dados da solicitação são inválidos para esta operação. |
| forbidden |
A operação é proibida para a chave de usuário/api atual. |
| notFound |
O recurso não foi encontrado. |
| unexpectedEntityState |
A operação não pode ser executada no estado do recurso atual. |
| itemDoesAlreadyExist |
O item já existe. |
| serviceUnavailable |
O serviço não está disponível no momento. |
| internalFailure |
Erro interno. Por favor, tente novamente. |
| quotaExceeded |
Quota excedida. |
| jsonlValidationFailed |
Falha na validação dos dados jsonl. |
| fileImportFailed |
Falha na importação do arquivo. |
| tooManyRequests |
Demasiados pedidos. Tente novamente mais tarde. |
| unauthorized |
A chave de usuário/api atual não está autorizada para a operação. |
| contentFilter |
A geração de imagens falhou como resultado do nosso sistema de segurança. |
ErrorResponse
ErrorResponse
| Nome | Tipo | Descrição |
|---|---|---|
| error |
Erro |
FineTuningHyperParameters
FineTuningHyperParameters
| Nome | Tipo | Descrição |
|---|---|---|
| batch_size |
integer (int32) |
O tamanho do lote a ser usado para treinamento. O tamanho do lote é o número de exemplos de treinamento usados para treinar um único passe para frente e para trás. Em geral, descobrimos que lotes maiores tendem a funcionar melhor para conjuntos de dados maiores. O valor padrão, bem como o valor máximo para essa propriedade são específicos para um modelo base. |
| learning_rate_multiplier |
number (double) |
O multiplicador da taxa de aprendizagem a utilizar na formação. A taxa de aprendizagem de ajuste fino é a taxa de aprendizagem original usada para pré-treinamento multiplicada por esse valor. Taxas de aprendizagem maiores tendem a ter um melhor desempenho com lotes maiores. Recomendamos experimentar valores no intervalo de 0,02 a 0,2 para ver o que produz os melhores resultados. |
| n_epochs |
integer (int32) |
O número de épocas para treinar o modelo. Uma época refere-se a um ciclo completo através do conjunto de dados de treinamento. |
FineTuningJob
FineTuningJob
| Nome | Tipo | Descrição |
|---|---|---|
| created_at |
integer (unixtime) |
Um carimbo de data/hora quando este trabalho ou item foi criado (em épocas unix). |
| error |
FineTuningJobError |
|
| estimated_finish |
integer (int32) |
O carimbo de data/hora do Unix (em segundos) para quando o trabalho de ajuste fino é estimado para terminar. O valor será nulo se o trabalho de ajuste fino não estiver em execução. |
| fine_tuned_model |
string |
O identificador (model-id) do modelo ajustado resultante. Esta propriedade só é preenchida para execuções de ajuste fino concluídas com êxito. Use esse identificador para criar uma implantação para inferência. |
| finished_at |
integer (int32) |
Um carimbo de data/hora quando este trabalho ou item foi concluído com êxito (em épocas unix). |
| hyperparameters |
FineTuningHyperParameters |
|
| id |
string |
A identidade deste item. |
| model |
string minLength: 1 |
O identificador (model-id) do modelo base usado para o ajuste fino. |
| object |
TipoDiscriminador |
|
| organisation_id |
string |
A organização id deste trabalho de afinação. Não utilizado no Azure OpenAI; compatibilidade apenas para OpenAI. |
| result_files |
string[] |
As identidades do arquivo de resultado (file-id) contendo métricas de treinamento e avaliação no formato csv. O arquivo só está disponível para execuções de ajuste fino concluídas com êxito. |
| seed |
integer (int32) |
A semente usada para o trabalho de ajuste fino. |
| status |
FineTuningState |
|
| suffix |
string |
O sufixo usado para identificar o modelo ajustado. O sufixo pode conter até 40 caracteres (a-z, A-Z, 0-9,- e _) que serão adicionados ao seu nome de modelo ajustado. |
| trained_tokens |
integer (int32) |
O número total de tokens faturáveis processados por esse trabalho de ajuste fino. |
| training_file |
string minLength: 1 |
O arquivo que é usado para treinamento. |
| validation_file |
string |
O arquivo que é usado para avaliar o modelo ajustado durante o treinamento. |
FineTuningJobCreation
FineTuningCriação de Empregos
| Nome | Tipo | Descrição |
|---|---|---|
| hyperparameters |
FineTuningHyperParameters |
|
| model |
string minLength: 1 |
O identificador (model-id) do modelo base usado para esse ajuste fino. |
| seed |
integer (int32) |
A semente usada para o trabalho de ajuste fino. Passar os mesmos parâmetros de semente e trabalho deve produzir os mesmos resultados, mas pode diferir em casos raros. Se uma semente não for especificada, uma será gerada para você. |
| suffix |
string |
O sufixo usado para identificar o modelo ajustado. O sufixo pode conter até 40 caracteres (a-z, A-Z, 0-9,- e _) que serão adicionados ao seu nome de modelo ajustado. |
| training_file |
string minLength: 1 |
A identidade do arquivo (file-id) que é usada para treinar esse modelo ajustado. |
| validation_file |
string |
A identidade do arquivo (file-id) usada para avaliar o modelo ajustado durante o treinamento. |
FineTuningJobError
FineTuningJobError
| Nome | Tipo | Descrição |
|---|---|---|
| code |
string |
O código de erro legível por máquina.. |
| message |
string |
A mensagem de erro legível por humanos. |
| param |
string |
O parâmetro que era inválido, geralmente training_file ou validation_file. Este campo será nulo se a falha não for específica do parâmetro. |
FineTuningState
FineTuningState
| Valor | Descrição |
|---|---|
| created |
A operação foi criada. Esse estado não é retornado pelo Azure OpenAI e exposto apenas para compatibilidade. Pode ser categorizado como um estado inativo. |
| pending |
A operação ainda não está na fila para ser processada no futuro. Pode ser categorizado como um estado inativo. |
| running |
A operação já começou a ser processada. Pode ser categorizado como um estado ativo. |
| succeeded |
A operação foi processada com sucesso e está pronta para consumo. Pode ser categorizado como um estado terminal. |
| cancelled |
A operação foi cancelada e está incompleta. Pode ser categorizado como um estado terminal. |
| failed |
A operação concluiu o processamento com uma falha e não pode ser consumida mais. Pode ser categorizado como um estado terminal. |
InnerError
InnerError
| Nome | Tipo | Descrição |
|---|---|---|
| code |
InnerErrorCode |
|
| innererror |
InnerError |
InnerErrorCode
InnerErrorCode
| Valor | Descrição |
|---|---|
| invalidPayload |
Os dados da solicitação são inválidos para esta operação. |
TypeDiscriminator
TipoDiscriminador
| Valor | Descrição |
|---|---|
| list |
Este objeto representa uma lista de outros objetos. |
| fine_tuning.job |
Este objeto representa um trabalho de ajuste fino. |
| file |
Este objeto representa um arquivo. |
| fine_tuning.job.event |
Este objeto representa um evento de um trabalho de ajuste fino. |
| fine_tuning.job.checkpoint |
Este objeto representa um ponto de verificação de um trabalho de ajuste fino. |
| model |
Este objeto representa um modelo (pode ser um modelo base ou um resultado de trabalho de ajuste fino). |
| batch |
Este objeto representa um lote. |
| upload |
Este objeto representa um upload de arquivo. |
| upload.part |
Este objeto representa parte de um upload de arquivo. |