Fine Tuning - Create

Referência

Serviço:: Azure AI Services

Versão da API:: 2023-12-01-preview

Cria uma tarefa que otimiza um modelo especificado a partir de um determinado ficheiro de preparação. A resposta inclui detalhes da tarefa em fila, incluindo o estado da tarefa e os parâmetros hyper. O nome do modelo otimizado é adicionado à resposta depois de concluído.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
endpoint	path	True	string url	Pontos finais dos Serviços Cognitivos suportados (protocolo e nome do anfitrião, por exemplo: https://aoairesource.openai.azure.com. Substitua "aoairesource" pelo nome da sua conta OpenAI do Azure).
api-version	query	True	string	A versão da API pedida.

Cabeçalho do Pedido

Name	Necessário	Tipo	Description
api-key	True	string	Forneça a sua chave de conta do Azure OpenAI dos Serviços Cognitivos aqui.

Corpo do Pedido

Name	Necessário	Tipo	Description
model	True	string	O identificador (model-id) do modelo base utilizado para esta otimização.
training_file	True	string	A identidade de ficheiro (file-id) utilizada para preparar este modelo otimizado.
hyperparameters		FineTuningHyperParameters	FineTuningHyperParameters As definições de hipermetrização utilizadas numa tarefa de otimização.
suffix		string	O sufixo utilizado para identificar o modelo otimizado. O sufixo pode conter até 40 carateres (a-z, A-Z, 0-9 e _) que serão adicionados ao seu nome de modelo otimizado.
validation_file		string	A identidade do ficheiro (file-id) utilizada para avaliar o modelo otimizado durante a preparação.

Respostas

Name	Tipo	Description
201 Created	FineTuningJob	A otimização foi criada com êxito. Cabeçalhos Location: string
Other Status Codes	ErrorResponse	Ocorreu um erro.

Name

Tipo

Description

201 Created

FineTuningJob

A otimização foi criada com êxito.

Cabeçalhos

Location: string

Other Status Codes

ErrorResponse

Ocorreu um erro.

Segurança

api-key

Forneça a sua chave de conta do Azure OpenAI dos Serviços Cognitivos aqui.

Tipo: apiKey
Em: header

Exemplos

Creating a fine tune job.

Pedido de amostra

HTTP

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


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

Resposta da amostra

Código de estado:: 201

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"
}

Definições

Name	Description
Error	Erro
ErrorCode	CódigoDoErro
ErrorResponse	ErrorResponse
FineTuningHyperParameters	FineTuningHyperParameters
FineTuningJob	FineTuningJob
FineTuningJobCreation	FineTuningJobCreation
FineTuningState	FineTuningState
InnerError	InnerError
InnerErrorCode	InnerErrorCode
TypeDiscriminator	TypeDiscriminator

Error

Erro

Name	Tipo	Description
code	ErrorCode	CódigoDoErro Códigos de erro conforme definido nas diretrizes REST da Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
details	Error[]	Os detalhes do erro, se disponíveis.
innererror	InnerError	InnerError Erro interno, conforme definido nas diretrizes REST da Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
message	string	A mensagem deste erro.
target	string	A localização onde ocorreu o erro, se disponível.

ErrorCode

CódigoDoErro

Name	Tipo	Description
conflict	string	A operação pedida entra em conflito com o estado atual do recurso.
contentFilter	string	A geração de imagens falhou devido ao nosso sistema de segurança.
fileImportFailed	string	Falha na importação do ficheiro.
forbidden	string	A operação é proibida para a chave de utilizador/api atual.
internalFailure	string	Erro interno. Tente novamente.
invalidPayload	string	Os dados do pedido são inválidos para esta operação.
itemDoesAlreadyExist	string	O item já existe.
jsonlValidationFailed	string	Falha na validação dos dados jsonl.
notFound	string	O recurso não foi encontrado.
quotaExceeded	string	Quota excedida.
serviceUnavailable	string	O serviço não está atualmente disponível.
tooManyRequests	string	Demasiados pedidos. Repita mais tarde.
unauthorized	string	A chave de utilizador/api atual não está autorizada para a operação.
unexpectedEntityState	string	Não é possível executar a operação no estado do recurso atual.

ErrorResponse

Name	Tipo	Description
error	Error	Erro Conteúdo do erro conforme definido nas diretrizes REST da Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

FineTuningHyperParameters

Name	Tipo	Description
batch_size	integer	O tamanho do lote a utilizar para preparação. O tamanho do lote é o número de exemplos de preparação utilizados para preparar uma única passagem para a frente e para trás. Em geral, descobrimos que tamanhos de lote maiores tendem a funcionar melhor para conjuntos de dados maiores. O valor predefinido, bem como o valor máximo desta propriedade, são específicos de um modelo base.
learning_rate_multiplier	number	O multiplicador da taxa de aprendizagem a utilizar para a preparação. A taxa de aprendizagem de otimização é a taxa de aprendizagem original utilizada para a pré-preparação multiplicada por este valor. As taxas de aprendizagem maiores tendem a ter um melhor desempenho com tamanhos de lote maiores. Recomendamos que experimente valores no intervalo de 0,02 a 0,2 para ver o que produz os melhores resultados.
n_epochs	integer	O número de épocas para a que preparar o modelo. Uma época refere-se a um ciclo completo através do conjunto de dados de preparação.

FineTuningJob

Name	Tipo	Description
created_at	integer	Um carimbo de data/hora quando esta tarefa ou item foi criado (em épocas unix).
fine_tuned_model	string	O identificador (model-id) do modelo otimizado resultante. Esta propriedade só é preenchida para execuções de otimização concluídas com êxito. Utilize este identificador para criar uma implementação para inferência.
finished_at	integer	Um carimbo de data/hora quando esta tarefa ou item tiver sido concluído com êxito (em épocas unix).
hyperparameters	FineTuningHyperParameters	FineTuningHyperParameters As definições de hipermetrização utilizadas numa tarefa de otimização.
id	string	A identidade deste item.
model	string	O identificador (model-id) do modelo base utilizado para otimizar.
object	TypeDiscriminator	TypeDiscriminator Define o tipo de um objeto.
organisation_id	string	O ID da organização deste trabalho de otimização. Não utilizado no Azure OpenAI; compatibilidade apenas para OpenAI.
result_files	string[]	As identidades de ficheiro de resultado (file-id) que contêm métricas de preparação e avaliação no formato csv. O ficheiro só está disponível para execuções de otimização concluídas com êxito.
status	FineTuningState	FineTuningState O estado de um objeto finetunes ou trabalho de otimização.
suffix	string	O sufixo utilizado para identificar o modelo otimizado. O sufixo pode conter até 40 carateres (a-z, A-Z, 0-9 e _) que serão adicionados ao seu nome de modelo otimizado.
trained_tokens	integer	O número total de tokens faturáveis processados por esta tarefa de otimização.
training_file	string	O ficheiro que é utilizado para preparação.
updated_at	integer	Um carimbo de data/hora em que esta tarefa ou item foi modificado pela última vez (em épocas unix).
validation_file	string	O ficheiro que é utilizado para avaliar o modelo otimizado durante a preparação.

FineTuningJobCreation

Name	Tipo	Description
hyperparameters	FineTuningHyperParameters	FineTuningHyperParameters As definições de hipermetrização utilizadas numa tarefa de otimização.
model	string	O identificador (model-id) do modelo base utilizado para esta otimização.
suffix	string	O sufixo utilizado para identificar o modelo otimizado. O sufixo pode conter até 40 carateres (a-z, A-Z, 0-9 e _) que serão adicionados ao seu nome de modelo otimizado.
training_file	string	A identidade de ficheiro (file-id) utilizada para preparar este modelo otimizado.
validation_file	string	A identidade do ficheiro (file-id) utilizada para avaliar o modelo otimizado durante a preparação.

FineTuningState

Name	Tipo	Description
cancelled	string	A operação foi cancelada e está incompleta. Pode ser categorizado como um estado terminal.
created	string	A operação foi criada. Este estado não é devolvido pelo Azure OpenAI e exposto apenas para compatibilidade. Pode ser categorizado como um estado inativo.
failed	string	A operação concluiu o processamento com uma falha e não pode ser consumida mais. Pode ser categorizado como um estado terminal.
pending	string	A operação ainda não está em fila para ser processada no futuro. Pode ser categorizado como um estado inativo.
running	string	A operação começou a ser processada. Pode ser categorizado como um estado ativo.
succeeded	string	A operação foi processada com êxito e está pronta para consumo. Pode ser categorizado como um estado terminal.

InnerError

Name	Tipo	Description
code	InnerErrorCode	InnerErrorCode Códigos de erro internos, conforme definido nas diretrizes REST da Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
innererror	InnerError	InnerError Erro interno, conforme definido nas diretrizes REST da Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

InnerErrorCode

Name	Tipo	Description
invalidPayload	string	Os dados do pedido são inválidos para esta operação.

TypeDiscriminator

Name	Tipo	Description
file	string	Este objeto representa um ficheiro.
fine-tune	string	Este objeto representa uma tarefa de otimização.
fine-tune-event	string	Este objeto representa um evento de uma tarefa de otimização.
fine_tuning.job	string	Este objeto representa uma tarefa de otimização.
fine_tuning.job.event	string	Este objeto representa um evento de uma tarefa de otimização.
list	string	Este objeto representa uma lista de outros objetos.
model	string	Este objeto representa um modelo (pode ser um modelo base ou otimizar o resultado da tarefa).

Partilhar via

Fine Tuning - Create

Parâmetros do URI

Cabeçalho do Pedido

Corpo do Pedido

Respostas

Segurança

api-key

Exemplos

Creating a fine tune job.

Pedido de amostra

Resposta da amostra

Definições

Error

ErrorCode

ErrorResponse

FineTuningHyperParameters

FineTuningJob

FineTuningJobCreation

FineTuningState

InnerError

InnerErrorCode

TypeDiscriminator

Recursos adicionais