Fine Tuning - Create

Referencia

Service:: Azure AI Services

API Version:: 2023-12-01-preview

Crea un trabajo que ajusta un modelo especificado a partir de un archivo de entrenamiento determinado. La respuesta incluye detalles del trabajo en cola, incluidos el estado del trabajo y los hiperparámetres. El nombre del modelo ajustado se agrega a la respuesta una vez completada.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
endpoint	path	True	string url	Puntos de conexión de Cognitive Services admitidos (protocolo y nombre de host, por ejemplo: https://aoairesource.openai.azure.com. Reemplace "aoairesource" por el nombre de la cuenta de Azure OpenAI).
api-version	query	True	string	La versión de API solicitada.

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
api-key	True	string	Proporcione la clave de cuenta de Azure OpenAI de Cognitive Services aquí.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
model	True	string	Identificador (model-id) del modelo base que se usa para esta optimización.
training_file	True	string	La identidad del archivo (file-id) que se usa para entrenar este modelo ajustado.
hyperparameters		FineTuningHyperParameters	FineTuningHyperParameters Configuración de hiperparámetr usada en un trabajo de ajuste preciso.
suffix		string	Sufijo usado para identificar el modelo ajustado. El sufijo puede contener hasta 40 caracteres (a-z, A-Z, 0-9 y _) que se agregarán al nombre del modelo ajustado.
validation_file		string	La identidad del archivo (file-id) que se usa para evaluar el modelo ajustado durante el entrenamiento.

Respuestas

Nombre	Tipo	Description
201 Created	FineTuningJob	La optimización se ha creado correctamente. Headers Location: string
Other Status Codes	ErrorResponse	Se produjo un error.

Nombre

Tipo

Description

201 Created

FineTuningJob

La optimización se ha creado correctamente.

Headers

Location: string

Other Status Codes

ErrorResponse

Se produjo un error.

Seguridad

api-key

Proporcione la clave de cuenta de Azure OpenAI de Cognitive Services aquí.

Type: apiKey
In: header

Ejemplos

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

Definiciones

Nombre	Description
Error	Error
ErrorCode	ErrorCode
ErrorResponse	ErrorResponse
FineTuningHyperParameters	FineTuningHyperParameters
FineTuningJob	FineTuningJob
FineTuningJobCreation	FineTuningJobCreation
FineTuningState	FineTuningState
InnerError	InnerError
InnerErrorCode	InnerErrorCode
TypeDiscriminator	TypeDiscriminator

Error

Nombre	Tipo	Description
code	ErrorCode	ErrorCode Códigos de error tal y como se definen en las directrices de REST de Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
details	Error[]	Detalles del error si está disponible.
innererror	InnerError	InnerError Error interno tal como se define en las directrices rest de Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
message	string	Mensaje de este error.
target	string	Ubicación donde se produjo el error si está disponible.

ErrorCode

Nombre	Tipo	Description
conflict	string	La operación solicitada entra en conflicto con el estado de recurso actual.
contentFilter	string	Se produjo un error en la generación de imágenes como resultado de nuestro sistema de seguridad.
fileImportFailed	string	Error en la importación del archivo.
forbidden	string	La operación está prohibida para la clave de usuario o API actual.
internalFailure	string	Error interno. Inténtelo de nuevo.
invalidPayload	string	Los datos de solicitud no son válidos para esta operación.
itemDoesAlreadyExist	string	El elemento ya existe.
jsonlValidationFailed	string	Error en la validación de datos jsonl.
notFound	string	No se encuentra el recurso.
quotaExceeded	string	Cuota superada.
serviceUnavailable	string	El servicio no está disponible actualmente.
tooManyRequests	string	Demasiadas solicitudes. Inténtelo de nuevo más tarde.
unauthorized	string	La clave de usuario o API actual no está autorizada para la operación.
unexpectedEntityState	string	La operación no se puede ejecutar en el estado del recurso actual.

ErrorResponse

Nombre	Tipo	Description
error	Error	Error Contenido de error tal y como se define en las directrices de REST de Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

FineTuningHyperParameters

Nombre	Tipo	Description
batch_size	integer	El tamaño del lote a usar para el entrenamiento. El tamaño del lote es el número de ejemplos de entrenamiento usados para entrenar una sola pasada hacia adelante y hacia atrás. En general, hemos comprobado que los tamaños de lote más grandes tienden a funcionar mejor para conjuntos de datos más grandes. El valor predeterminado, así como el valor máximo de esta propiedad, son específicos de un modelo base.
learning_rate_multiplier	number	El multiplicador de la tasa de aprendizaje que se usará para el entrenamiento. La tasa de aprendizaje de ajuste es la tasa de aprendizaje original que se usó para el preentrenamiento multiplicada por este valor. Las tasas de aprendizaje más grandes tienden a mejorar con tamaños de lote más grandes. Se recomienda experimentar con valores en el rango de 0,02 a 0,2 para ver qué produce los mejores resultados.
n_epochs	integer	El número de épocas para entrenar el modelo. Una época se refiere a un ciclo completo a través del conjunto de datos de entrenamiento.

FineTuningJob

Nombre	Tipo	Description
created_at	integer	Marca de tiempo en la que se creó este trabajo o elemento (en épocas unix).
fine_tuned_model	string	Identificador (id.de modelo) del modelo ajustado resultante. Esta propiedad solo se rellena para ejecuciones de ajuste completadas correctamente. Use este identificador para crear una implementación para la inferencia.
finished_at	integer	Marca de tiempo cuando este trabajo o elemento ha finalizado correctamente (en épocas unix).
hyperparameters	FineTuningHyperParameters	FineTuningHyperParameters La configuración de hiperparámetr usada en un trabajo de ajuste preciso.
id	string	Identidad de este elemento.
model	string	Identificador (model-id) del modelo base que se usa para ajustar.
object	TypeDiscriminator	TypeDiscriminator Define el tipo de un objeto .
organisation_id	string	El identificador de la organización de este trabajo de ajuste. Sin usar en Azure OpenAI; compatibilidad solo con OpenAI.
result_files	string[]	Identidades de archivo de resultados (file-id) que contienen métricas de entrenamiento y evaluación en formato csv. El archivo solo está disponible para ejecuciones de ajuste completadas correctamente.
status	FineTuningState	FineTuningState Estado de un objeto finetunes o un trabajo de ajuste fino.
suffix	string	Sufijo usado para identificar el modelo ajustado. El sufijo puede contener hasta 40 caracteres (a-z, A-Z, 0-9- y _) que se agregarán al nombre del modelo ajustado.
trained_tokens	integer	El número total de tokens facturables procesados por este trabajo de ajuste preciso.
training_file	string	Archivo que se usa para el entrenamiento.
updated_at	integer	Marca de tiempo en la que este trabajo o elemento se modificó por última vez (en épocas unix).
validation_file	string	Archivo que se usa para evaluar el modelo ajustado durante el entrenamiento.

FineTuningJobCreation

Nombre	Tipo	Description
hyperparameters	FineTuningHyperParameters	FineTuningHyperParameters La configuración de hiperparámetr usada en un trabajo de ajuste preciso.
model	string	Identificador (id.de modelo) del modelo base que se usa para esta optimización.
suffix	string	Sufijo usado para identificar el modelo ajustado. El sufijo puede contener hasta 40 caracteres (a-z, A-Z, 0-9- y _) que se agregarán al nombre del modelo ajustado.
training_file	string	La identidad de archivo (file-id) que se usa para entrenar este modelo ajustado.
validation_file	string	Identidad de archivo (file-id) que se usa para evaluar el modelo ajustado durante el entrenamiento.

FineTuningState

Nombre	Tipo	Description
cancelled	string	La operación se ha cancelado y está incompleta. Se puede clasificar como un estado terminal.
created	string	Se creó la operación. Azure OpenAI no devuelve este estado y solo se expone por motivos de compatibilidad. Se puede clasificar como un estado inactivo.
failed	string	La operación ha completado el procesamiento con un error y no se puede consumir más. Se puede clasificar como un estado terminal.
pending	string	La operación aún no está en cola para procesarse en el futuro. Se puede clasificar como un estado inactivo.
running	string	La operación se ha iniciado para procesarse. Se puede clasificar como un estado activo.
succeeded	string	La operación se ha procesado correctamente y está lista para su consumo. Se puede clasificar como un estado terminal.

InnerError

Nombre	Tipo	Description
code	InnerErrorCode	InnerErrorCode Códigos de error internos, tal como se define en las directrices de REST de Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
innererror	InnerError	InnerError Error interno tal como se define en las directrices rest de Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

InnerErrorCode

Nombre	Tipo	Description
invalidPayload	string	Los datos de solicitud no son válidos para esta operación.

TypeDiscriminator

Nombre	Tipo	Description
file	string	Este objeto representa un archivo.
fine-tune	string	Este objeto representa un trabajo de ajuste preciso.
fine-tune-event	string	Este objeto representa un evento de un trabajo de ajuste fino.
fine_tuning.job	string	Este objeto representa un trabajo de ajuste preciso.
fine_tuning.job.event	string	Este objeto representa un evento de un trabajo de ajuste fino.
list	string	Este objeto representa una lista de otros objetos.
model	string	Este objeto representa un modelo (puede ser un modelo base o ajustar el resultado del trabajo).

Share via

Fine Tuning - Create

Parámetros de identificador URI

Encabezado de la solicitud

Cuerpo de la solicitud

Respuestas

Seguridad

api-key

Ejemplos

Creating a fine tune job.

Sample Request

Sample Response

Definiciones

Error

ErrorCode

ErrorResponse

FineTuningHyperParameters

FineTuningJob

FineTuningJobCreation

FineTuningState

InnerError

InnerErrorCode

TypeDiscriminator

Recursos adicionales