Fine Tuning - Get

Referenz

Dienst:: Azure AI Services

API-Version:: 2024-10-21

Ruft Details für einen einzelnen Feinabstimmungsauftrag ab, der durch die angegebene Feinabstimmungs-ID angegeben wird. Die Details enthalten die Basismodell-, Schulungs- und Validierungsdateien, Hyperparameter, Zeitstempel, Status und Ereignisse. Ereignisse werden erstellt, wenn sich der Auftragsstatus ä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-10-21

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 Ihren Azure OpenAI-Kontonamen.
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	Stellen Sie hier Ihren Azure OpenAI-Kontoschlüssel für Cognitive Services bereit.

Antworten

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

Sicherheit

api-key

Stellen Sie hier Ihren Azure OpenAI-Kontoschlüssel für Cognitive Services bereit.

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-10-21

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
FineTuningJobError	FineTuningJobError
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 gemäß den Microsoft REST-Richtlinien (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
message	string	Die Meldung dieses Fehlers.
target	string	Der Ort, an dem der Fehler aufgetreten ist, falls verfügbar.

ErrorCode

Name	Typ	Beschreibung
conflict	string	Der angeforderte Vorgang ist mit dem aktuellen Ressourcenstatus in Konflikt.
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 verboten.
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	Das Kontingent wurde überschritten.
serviceUnavailable	string	Der Dienst ist derzeit nicht verfügbar.
tooManyRequests	string	Zu viele Anforderungen. Versuchen Sie es später erneut.
unauthorized	string	Der aktuelle Benutzer-/API-Schlüssel ist für den Vorgang nicht autorisiert.
unexpectedEntityState	string	Der Vorgang kann nicht im Zustand der aktuellen Ressource ausgeführt werden.

ErrorResponse

Name	Typ	Beschreibung
error	Error	Fehler Fehlerinhalte gemäß 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 batchgröße, die für die Schulung verwendet werden soll. Die Batchgröße ist die Anzahl der Schulungsbeispiele, die zum Trainieren eines einzelnen Vorwärts- und Rückwärtsdurchlaufs verwendet werden. Im Allgemeinen haben wir festgestellt, dass größere Batchgrößen tendenziell besser für größere Datasets funktionieren. Der Standardwert sowie der Maximalwert für diese Eigenschaft sind spezifisch für ein Basismodell.
learning_rate_multiplier	number	Der Lernrate-Multiplizierer, der für die Schulung verwendet werden soll. Die Feinabstimmung der Lernrate ist die ursprüngliche Lernrate, die für die Vorschulung multipliziert mit diesem Wert verwendet wird. Größere Lernraten führen bei größeren Batchgrößen tendenziell besser aus. Es wird empfohlen, mit Werten im Bereich von 0,02 bis 0,2 zu experimentieren, um zu sehen, was die besten Ergebnisse liefert.
n_epochs	integer	Die Anzahl der Epochen, für die das Modell trainiert werden soll. Eine Epoche bezieht sich auf einen vollständigen Zyklus durch das Schulungsdatensatz.

FineTuningJob

Name	Typ	Beschreibung
created_at	integer	Ein Zeitstempel, zu dem dieser Auftrag oder dieses Element erstellt wurde (in Unix-Epochen).
error	FineTuningJobError	FineTuningJobError Bei fehlgeschlagenen Feinabstimmungsaufträgen enthält dies weitere Informationen zur Ursache des Fehlers.
estimated_finish	integer	Der Unix-Zeitstempel (in Sekunden) für den Abschluss des Feinabstimmungsauftrags. Der Wert ist NULL, wenn der Feinabstimmungsauftrag nicht ausgeführt wird.
fine_tuned_model	string	Der Bezeichner (Modell-ID) des resultierenden fein abgestimmten Modells. Diese Eigenschaft wird nur für erfolgreich abgeschlossene Feinabstimmungen aufgefüllt. Verwenden Sie diesen Bezeichner, um eine Bereitstellung für die Ableitung zu erstellen.
finished_at	integer	Ein Zeitstempel, wenn dieser Auftrag oder 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 (Modell-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. Nicht verwendet auf Azure OpenAI; Nur Kompatibilität für OpenAI.
result_files	string[]	Die Ergebnisdateiidentitäten (Datei-ID), die Schulungs- und Auswertungsmetriken im CSV-Format enthalten. Die Datei ist nur für erfolgreich abgeschlossene Feinabstimmungen verfügbar.
seed	integer	Der Samen, der für den Feinabstimmungsauftrag verwendet wird.
status	FineTuningState	FineTuningState Der Zustand eines Feinabstimmungsobjekts oder Feinabstimmungsauftrags.
suffix	string	Das Suffix, das zum Identifizieren des fein abgestimmten Modells verwendet wird. Das Suffix kann bis zu 40 Zeichen (a-z, A-Z, 0-9,- und _) enthalten, die ihrem fein abgestimmten Modellnamen hinzugefügt werden.
trained_tokens	integer	Die Gesamtzahl der von diesem Feinabstimmungsauftrag verarbeiteten abrechnenden Token.
training_file	string	Die Datei, die für schulungen verwendet wird.
validation_file	string	Die Datei, die zum Auswerten des fein abgestimmten Modells während der Schulung verwendet wird.

FineTuningJobError

Name	Typ	Beschreibung
code	string	Der computerlesbare Fehlercode..
message	string	Die menschlichen lesbaren Fehlermeldungen.
param	string	Der Ungültige Parameter, in der Regel training_file oder validation_file. Dieses Feld ist NULL, wenn der Fehler nicht parameterspezifisch war.

FineTuningState

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

InnerError

Name	Typ	Beschreibung
code	InnerErrorCode	InnerErrorCode Innere Fehlercodes gemäß den Microsoft REST-Richtlinien (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
innererror	InnerError	InnerError Innerer Fehler gemäß den Microsoft REST-Richtlinien (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

InnerErrorCode

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

TypeDiscriminator

Name	Typ	Beschreibung
batch	string	Dieses Objekt stellt einen Batch dar.
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 Feinabstimmungsauftrags dar.
fine_tuning.job.event	string	Dieses Objekt stellt ein Ereignis eines Feinabstimmungsauftrags 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).
upload	string	Dieses Objekt stellt einen Dateiupload dar.
upload.part	string	Dieses Objekt stellt einen Teil eines Dateiuploads dar.

Freigeben über