Fine Tuning - Get

Referenz

Dienst:: Azure AI Services

API-Version:: 2024-05-01-preview

Ruft Details für einen einzelnen Feinabstimmungsauftrag ab, der durch die angegebene Fine-Tune-ID angegeben wird. Die Details enthalten das Basismodell, Trainings- und Validierungsdateien, Hyperparameter, Zeitstempel, status und Ereignisse. Ereignisse werden erstellt, wenn sich der Auftrag status ändert, z. B. ausgeführt oder abgeschlossen, und wenn Ergebnisse hochgeladen werden.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
endpoint	path	True	string url	Unterstützte Cognitive Services-Endpunkte (Protokoll und Hostname, z. B. . https://aoairesource.openai.azure.com Ersetzen Sie "aoairesource" durch den Namen Ihres Azure OpenAI-Kontos.
fine-tuning-job-id	path	True	string	Der Bezeichner des Feinabstimmungsauftrags.
api-version	query	True	string	Die angeforderte API-Version.

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
api-key	True	string	Geben Sie hier Ihren Azure OpenAI-Kontoschlüssel für Cognitive Services an.

Antworten

Name	Typ	Beschreibung
200 OK	FineTuningJob	Erfolg
Other Status Codes	ErrorResponse	Ein Fehler ist aufgetreten.

Sicherheit

api-key

Geben Sie hier Ihren Azure OpenAI-Kontoschlüssel für Cognitive Services an.

Typ: apiKey
In: header

Beispiele

Getting a fine tuning job.

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

Statuscode:: 200

{
  "hyperparameters": {
    "n_epochs": -1
  },
  "status": "succeeded",
  "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",
  "created_at": 1646126127,
  "object": "fine_tuning.job"
}

Definitionen

Name	Beschreibung
Error	Fehler
ErrorCode	ErrorCode
ErrorResponse	ErrorResponse
FineTuningHyperParameters	FineTuningHyperParameters
FineTuningJob	FineTuningJob
FineTuningState	FineTuningState
InnerError	InnerError
InnerErrorCode	InnerErrorCode
TypeDiscriminator	TypeDiscriminator

Error

Fehler

Name	Typ	Beschreibung
code	ErrorCode	ErrorCode Fehlercodes gemäß der Definition in den Microsoft REST-Richtlinien (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
details	Error[]	Die Fehlerdetails, falls verfügbar.
innererror	InnerError	InnerError Innerer Fehler, wie in den Microsoft REST-Richtlinien (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses) definiert.
message	string	Die Meldung dieses Fehlers.
target	string	Der Speicherort, an dem der Fehler aufgetreten ist, falls verfügbar.

ErrorCode

Name	Typ	Beschreibung
conflict	string	Der angeforderte Vorgang ist in Konflikt mit dem aktuellen Ressourcenzustand.
contentFilter	string	Die Bildgenerierung ist aufgrund unseres Sicherheitssystems fehlgeschlagen.
fileImportFailed	string	Fehler beim Importieren der Datei.
forbidden	string	Der Vorgang ist für den aktuellen Benutzer-/API-Schlüssel unzulässig.
internalFailure	string	Interner Fehler. Versuchen Sie es erneut.
invalidPayload	string	Die Anforderungsdaten sind für diesen Vorgang ungültig.
itemDoesAlreadyExist	string	Das Element ist bereits vorhanden.
jsonlValidationFailed	string	Fehler bei der Überprüfung von JSONL-Daten.
notFound	string	Die Ressource wurde nicht gefunden.
quotaExceeded	string	Kontingent überschritten.
serviceUnavailable	string	Der Dienst ist derzeit nicht verfügbar.
tooManyRequests	string	Too many requests. (Zu viele Anforderungen.) Versuchen Sie es später noch mal.
unauthorized	string	Der aktuelle Benutzer-/API-Schlüssel ist nicht für den Vorgang autorisiert.
unexpectedEntityState	string	Der Vorgang kann nicht im Zustand der aktuellen Ressource ausgeführt werden.

ErrorResponse

Name	Typ	Beschreibung
error	Error	Fehler Fehlerinhalt gemäß der Definition in den Microsoft REST-Richtlinien (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

FineTuningHyperParameters

Name	Typ	Beschreibung
batch_size	integer	Die für das Training zu verwendende Batchgröße. Die Batchgröße ist die Anzahl der Trainingsbeispiele, die zum Trainieren eines einzelnen Vorwärts- und Rückwärtsdurchlaufs verwendet werden. Im Allgemeinen haben wir festgestellt, dass größere Batchgrößen für größere Datasets besser funktionieren. Der Standardwert sowie der Maximalwert für diese Eigenschaft sind spezifisch für ein Basismodell.
learning_rate_multiplier	number	Der Lernratenmultiplikator, der für das Training verwendet werden soll. Die Optimierungslernrate ist die ursprüngliche Lernrate, die für das Vorabtraining verwendet wird, mit diesem Wert multipliziert. Größere Lernraten sind bei größeren Batchgrößen tendenziell besser. Es empfiehlt sich, mit Werten im Bereich 0,02 bis 0,2 zu experimentieren, um zu sehen, was die besten Ergebnisse erzeugt.
n_epochs	integer	Die Anzahl der Epochen zum Trainieren des Modells. Eine Epoche bezeichnet einen vollständigen Zyklus über das Trainingsdataset.

FineTuningJob

Name	Typ	Beschreibung
created_at	integer	Ein Zeitstempel, wenn dieser Auftrag oder dieses Element erstellt wurde (in Unix-Epochen).
fine_tuned_model	string	Der Bezeichner (Modell-ID) des resultierenden, fein abgestimmten Modells. Diese Eigenschaft wird nur für erfolgreich abgeschlossene Feinabstimmungsausführungen aufgefüllt. Verwenden Sie diesen Bezeichner, um eine Bereitstellung für Rückschlüsse zu erstellen.
finished_at	integer	Ein Zeitstempel, wenn dieser Auftrag oder dieses Element erfolgreich abgeschlossen wurde (in Unix-Epochen).
hyperparameters	FineTuningHyperParameters	FineTuningHyperParameters Die Hyperparametereinstellungen, die in einem Feinabstimmungsauftrag verwendet werden.
id	string	Die Identität dieses Elements.
model	string	Der Bezeichner (Model-ID) des Basismodells, das für die Feinabstimmung verwendet wird.
object	TypeDiscriminator	TypeDiscriminator Definiert den Typ eines Objekts.
organisation_id	string	Die Organisations-ID dieses Feinabstimmungsauftrags. In Azure OpenAI nicht verwendet; Nur für OpenAI kompatibel.
result_files	string[]	Die Ergebnisdateiidentitäten (File-ID), die Trainings- und Auswertungsmetriken im CSV-Format enthalten. Die Datei ist nur für erfolgreich abgeschlossene Feinabstimmungsausführungen verfügbar.
seed	integer	Der Für den Feinabstimmungsauftrag verwendete Seed.
status	FineTuningState	FineTuningState Der Zustand eines Feinabstimmungsobjekts oder eines Feinabstimmungsauftrags.
suffix	string	Das Suffix, das zum Identifizieren des optimierten Modells verwendet wird. Das Suffix kann bis zu 40 Zeichen (a-z, A-Z, 0-9, und _) enthalten, die Ihrem optimierten Modellnamen hinzugefügt werden.
trained_tokens	integer	Die Gesamtanzahl der abrechenbaren Token, die von diesem Feinabstimmungsauftrag verarbeitet werden.
training_file	string	Die Datei, die für das Training verwendet wird.
validation_file	string	Die Datei, die zum Auswerten des fein abgestimmten Modells während des Trainings verwendet wird.

FineTuningState

Name	Typ	Beschreibung
cancelled	string	Der Vorgang wurde abgebrochen und ist unvollständig. Es kann als Endzustand kategorisiert werden.
created	string	Der Vorgang wurde erstellt. Dieser Zustand wird von Azure OpenAI nicht zurückgegeben und nur aus Kompatibilitätsgründen verfügbar gemacht. Es kann als inaktiver Zustand kategorisiert werden.
failed	string	Der Vorgang hat die Verarbeitung mit einem Fehler abgeschlossen und kann nicht weiter genutzt werden. Es kann als Endzustand kategorisiert werden.
pending	string	Der Vorgang ist noch nicht in die Warteschlange eingereiht, um in Zukunft verarbeitet zu werden. Es kann als inaktiver Zustand kategorisiert werden.
running	string	Die Verarbeitung des Vorgangs wurde gestartet. Es kann als aktiver Zustand kategorisiert werden.
succeeded	string	Der Vorgang wurde erfolgreich verarbeitet und kann verwendet werden. Es kann als Endzustand kategorisiert werden.

InnerError

Name	Typ	Beschreibung
code	InnerErrorCode	InnerErrorCode Interne Fehlercodes, wie in den Microsoft REST-Richtlinien definiert (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
innererror	InnerError	InnerError Innerer Fehler, wie in den Microsoft REST-Richtlinien (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses) definiert.

InnerErrorCode

Name	Typ	Beschreibung
invalidPayload	string	Die Anforderungsdaten sind für diesen Vorgang ungültig.

TypeDiscriminator

Name	Typ	Beschreibung
file	string	Dieses Objekt stellt eine Datei dar.
fine_tuning.job	string	Dieses Objekt stellt einen Feinabstimmungsauftrag dar.
fine_tuning.job.checkpoint	string	Dieses Objekt stellt einen Prüfpunkt eines Feinoptimierungsauftrags dar.
fine_tuning.job.event	string	Dieses Objekt stellt ein Ereignis eines Feinoptimierungsauftrags dar.
list	string	Dieses Objekt stellt eine Liste anderer Objekte dar.
model	string	Dieses Objekt stellt ein Modell dar (kann ein Basismodell oder ein Feinabstimmungsauftragsergebnis sein).

Freigeben über