Fine Tuning - Get

Référence

Service:: Azure AI Services

API Version:: 2024-02-01

Obtient les détails d’un seul travail d’réglage précis spécifié par l’id de réglage précis donné. Les détails contiennent le modèle de base, les fichiers d’entraînement et de validation, les paramètres hyper, les horodatages, les status et les événements. Les événements sont créés lorsque le travail status change, par exemple en cours d’exécution ou terminé, et lorsque les résultats sont chargés.

GET {endpoint}/openai/fine_tuning/jobs/{fine-tuning-job-id}?api-version=2024-02-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
endpoint	path	True	string url	Points de terminaison Cognitive Services pris en charge (protocole et nom d’hôte, par exemple : https://aoairesource.openai.azure.com. Remplacez « aoairesource » par le nom de votre compte Azure OpenAI).
fine-tuning-job-id	path	True	string	Identificateur du travail d’optimisation.
api-version	query	True	string	Version de l’API demandée.

En-tête de la demande

Nom	Obligatoire	Type	Description
api-key	True	string	Fournissez votre clé de compte Azure OpenAI Cognitive Services ici.

Réponses

Nom	Type	Description
200 OK	FineTuningJob	Succès
Other Status Codes	ErrorResponse	Une erreur est survenue.

Sécurité

api-key

Fournissez votre clé de compte Azure OpenAI Cognitive Services ici.

Type: apiKey
In: header

Exemples

Getting a fine tune job.

Sample Request

HTTP

GET https://aoairesource.openai.azure.com/openai/fine_tuning/jobs/ft-72a2792ef7d24ba7b82c7fe4a37e379f?api-version=2024-02-01

Sample Response

Status code:: 200

{
  "hyperparameters": {
    "n_epochs": 2
  },
  "model": "curie",
  "fine_tuned_model": "curie.ft-72a2792ef7d24ba7b82c7fe4a37e379f",
  "training_file": "file-181a1cbdcdcf4677ada87f63a0928099",
  "result_files": [
    "file-181a1cbdcdcf4677ada87f63a0928099"
  ],
  "finished_at": 1646127311,
  "trained_tokens": 2342,
  "id": "ft-72a2792ef7d24ba7b82c7fe4a37e379f",
  "status": "succeeded",
  "created_at": 1646126127,
  "object": "fine_tuning.job"
}

Définitions

Nom	Description
Error	Erreur
ErrorCode	ErrorCode
ErrorResponse	ErrorResponse
FineTuningHyperParameters	FineTuningHyperParameters
FineTuningJob	FineTuningJob
FineTuningState	FineTuningState
InnerError	InnerError
InnerErrorCode	InnerErrorCode
TypeDiscriminator	TypeDiscriminator

Error

Erreur

Nom	Type	Description
code	ErrorCode	ErrorCode Codes d’erreur tels que définis dans les instructions REST de Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
details	Error[]	Détails de l’erreur, le cas échéant.
innererror	InnerError	InnerError Erreur interne telle que définie dans les instructions REST de Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
message	string	Message de cette erreur.
target	string	Emplacement où l’erreur s’est produite s’il est disponible.

ErrorCode

Nom	Type	Description
conflict	string	L’opération demandée est en conflit avec l’état actuel de la ressource.
contentFilter	string	La génération d’images a échoué en raison de notre système de sécurité.
fileImportFailed	string	Échec de l’importation du fichier.
forbidden	string	L’opération est interdite pour la clé utilisateur/API actuelle.
internalFailure	string	Erreur interne. Veuillez réessayer.
invalidPayload	string	Les données de demande ne sont pas valides pour cette opération.
itemDoesAlreadyExist	string	L’élément existe déjà.
jsonlValidationFailed	string	Échec de la validation des données jsonl.
notFound	string	La ressource est introuvable.
quotaExceeded	string	Quota dépassé.
serviceUnavailable	string	Le service n’est actuellement pas disponible.
tooManyRequests	string	Trop grand nombre de requêtes. Veuillez réessayer ultérieurement.
unauthorized	string	La clé utilisateur/API actuelle n’est pas autorisée pour l’opération.
unexpectedEntityState	string	L’opération ne peut pas être exécutée dans l’état actuel de la ressource.

ErrorResponse

Nom	Type	Description
error	Error	Erreur Contenu d’erreur tel que défini dans les instructions REST de Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

FineTuningHyperParameters

Nom	Type	Description
batch_size	integer	Taille de lot à utiliser pour la formation. La taille du lot est le nombre d’exemples de la formation utilisés pour entraîner un seul passage avant et arrière. En général, nous avons constaté que les tailles de lot plus grandes ont tendance à fonctionner mieux pour les jeux de données plus volumineux. La valeur par défaut ainsi que la valeur maximale de cette propriété sont spécifiques à un modèle de base.
learning_rate_multiplier	number	Multiplicateur de taux de formation à utiliser pour la formation. Le taux d’apprentissage de réglage est le taux d’apprentissage d’origine utilisé pour le pré-entraînement multiplié par cette valeur. Les taux d’apprentissage plus élevés ont tendance à mieux fonctionner avec des tailles de lots plus grandes. Nous vous recommandons d’expérimenter des valeurs comprises entre 0,02 et 0,2 pour voir ce qui produit les meilleurs résultats.
n_epochs	integer	Nombre d’époques pour lequel effectuer la formation du modèle. Une époque fait référence à un cycle complet dans le jeu de données de formation.

FineTuningJob

Nom	Type	Description
created_at	integer	Horodatage lors de la création de ce travail ou de cet élément (dans les époques Unix).
fine_tuned_model	string	Identificateur (model-id) du modèle affiné résultant. Cette propriété est renseignée uniquement pour les exécutions d’optimisation réussies. Utilisez cet identificateur pour créer un déploiement pour l’inférence.
finished_at	integer	Horodatage lorsque ce travail ou cet élément s’est terminé avec succès (dans les époques Unix).
hyperparameters	FineTuningHyperParameters	FineTuningHyperParameters Paramètres hyper utilisés dans un travail d’optimisation.
id	string	Identité de cet élément.
model	string	Identificateur (id de modèle) du modèle de base utilisé pour l’optimisation.
object	TypeDiscriminator	TypeDiscriminator Définit le type d’un objet.
organisation_id	string	L’id d’organisation de ce travail d’optimisation. Inutilisé sur Azure OpenAI ; compatibilité pour OpenAI uniquement.
result_files	string[]	Identités de fichier de résultat (file-id) contenant des métriques d’apprentissage et d’évaluation au format csv. Le fichier est uniquement disponible pour les exécutions d’optimisation réussies.
status	FineTuningState	FineTuningState État d’un objet ou d’un travail de réglage précis.
suffix	string	Suffixe utilisé pour identifier le modèle affiné. Le suffixe peut contenir jusqu’à 40 caractères (a-z, A-Z, 0-9 et _) qui seront ajoutés à votre nom de modèle affiné.
trained_tokens	integer	Nombre total de jetons facturables traités par ce travail de réglage précis.
training_file	string	Fichier utilisé pour l’entraînement.
validation_file	string	Fichier utilisé pour évaluer le modèle affiné pendant l’entraînement.

FineTuningState

Nom	Type	Description
cancelled	string	L’opération a été annulée et est incomplète. Il peut être classé comme état terminal.
created	string	L’opération a été créée. Cet état n’est pas retourné par Azure OpenAI et exposé uniquement à des fins de compatibilité. Il peut être classé comme un état inactif.
failed	string	L’opération s’est terminée avec un échec et ne peut pas être consommée. Il peut être classé comme état terminal.
pending	string	L’opération n’est pas encore mise en file d’attente pour être traitée ultérieurement. Il peut être classé comme un état inactif.
running	string	Le traitement de l’opération a commencé. Il peut être classé comme un état actif.
succeeded	string	L’opération a été traitée avec succès et est prête à être consommée. Il peut être classé comme état terminal.

InnerError

Nom	Type	Description
code	InnerErrorCode	InnerErrorCode Codes d’erreur internes tels que définis dans les instructions REST de Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
innererror	InnerError	InnerError Erreur interne telle que définie dans les instructions REST de Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

InnerErrorCode

Nom	Type	Description
invalidPayload	string	Les données de demande ne sont pas valides pour cette opération.

TypeDiscriminator

Nom	Type	Description
file	string	Cet objet représente un fichier.
fine-tune	string	Cet objet représente un travail d’optimisation.
fine-tune-event	string	Cet objet représente un événement d’un travail d’optimisation.
fine_tuning.job	string	Cet objet représente un travail d’optimisation.
fine_tuning.job.event	string	Cet objet représente un événement d’un travail de réglage précis.
list	string	Cet objet représente une liste d’autres objets.
model	string	Cet objet représente un modèle (il peut s’agir d’un modèle de base ou d’un résultat de travail d’optimisation).

Partager via