Fine Tuning - Get

Referens

Tjänst:: Azure AI Services

API-version:: 2024-10-21

Hämtar information om ett enda finjusterat jobb som anges av det angivna finjusterings-ID:t. Informationen innehåller basmodellen, tränings- och valideringsfiler, hyperparametrar, tidsstämplar, status och händelser. Händelser skapas när jobbstatusen ändras, t.ex. körs eller slutförs och när resultaten laddas upp.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
endpoint	path	True	string url	Cognitive Services-slutpunkter som stöds (protokoll och värdnamn, till exempel: https://aoairesource.openai.azure.com. Ersätt "aoairesource" med ditt Azure OpenAI-kontonamn).
fine-tuning-job-id	path	True	string	Identifieraren för det finjusterade jobbet.
api-version	query	True	string	Den begärda API-versionen.

Begärandehuvud

Name	Obligatorisk	Typ	Description
api-key	True	string	Ange din Azure OpenAI-kontonyckel för Cognitive Services här.

Svar

Name	Typ	Description
200 OK	FineTuningJob	Framgång
Other Status Codes	ErrorResponse	Ett fel uppstod.

Säkerhet

api-key

Ange din Azure OpenAI-kontonyckel för Cognitive Services här.

Typ: apiKey
I: header

Exempel

Getting a fine tuning job.

Exempelbegäran

HTTP

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

Exempelsvar

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

Definitioner

Name	Description
Error	Fel
ErrorCode	ErrorCode
ErrorResponse	ErrorResponse
FineTuningHyperParameters	FineTuningHyperParameters
FineTuningJob	FineTuningJob
FineTuningJobError	FineTuningJobError
FineTuningState	FineTuningState
InnerError	InnerError
InnerErrorCode	InnerErrorCode
TypeDiscriminator	TypeDiscriminator

Error

Fel

Name	Typ	Description
code	ErrorCode	ErrorCode Felkoder enligt definitionen i Microsoft REST-riktlinjerna (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
details	Error[]	Felinformationen om den är tillgänglig.
innererror	InnerError	InnerError Inre fel enligt definitionen i Microsoft REST-riktlinjerna (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
message	string	Meddelandet om det här felet.
target	string	Platsen där felet inträffade om det var tillgängligt.

ErrorCode

Name	Typ	Description
conflict	string	Den begärda åtgärden står i konflikt med det aktuella resurstillståndet.
contentFilter	string	Bildgenereringen misslyckades till följd av vårt säkerhetssystem.
fileImportFailed	string	Det gick inte att importera filen.
forbidden	string	Åtgärden är förbjuden för den aktuella användaren/API-nyckeln.
internalFailure	string	Internt fel. Försök igen.
invalidPayload	string	Begärandedata är ogiltiga för den här åtgärden.
itemDoesAlreadyExist	string	Objektet finns redan.
jsonlValidationFailed	string	Verifieringen av jsonl-data misslyckades.
notFound	string	Det går inte att hitta resursen.
quotaExceeded	string	Kvoten har överskridits.
serviceUnavailable	string	Tjänsten är inte tillgänglig för närvarande.
tooManyRequests	string	För många begäranden. Försök igen senare.
unauthorized	string	Den aktuella användar-/API-nyckeln har inte behörighet för åtgärden.
unexpectedEntityState	string	Åtgärden kan inte köras i den aktuella resursens tillstånd.

ErrorResponse

Name	Typ	Description
error	Error	Fel Felinnehåll enligt definitionen i Microsoft REST-riktlinjerna (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

FineTuningHyperParameters

Name	Typ	Description
batch_size	integer	Batchstorleken som ska användas för träning. Batchstorleken är antalet träningsexempel som används för att träna ett enda framåt- och bakåtpass. I allmänhet har vi upptäckt att större batchstorlekar tenderar att fungera bättre för större datamängder. Standardvärdet samt det maximala värdet för den här egenskapen är specifika för en basmodell.
learning_rate_multiplier	number	Den inlärningsfrekvensmultiplikator som ska användas för träning. Den finjusterande inlärningsfrekvensen är den ursprungliga inlärningsfrekvensen som används för förträning multiplicerat med det här värdet. Större inlärningsfrekvenser tenderar att fungera bättre med större batchstorlekar. Vi rekommenderar att du experimenterar med värden i intervallet 0,02 till 0,2 för att se vad som ger bäst resultat.
n_epochs	integer	Antalet epoker som modellen ska tränas för. En epok refererar till en fullständig cykel genom träningsdatauppsättningen.

FineTuningJob

Name	Typ	Description
created_at	integer	En tidsstämpel när det här jobbet eller objektet skapades (i unix-epoker).
error	FineTuningJobError	FineTuningJobError För finjusteringsjobb som har misslyckats innehåller detta mer information om orsaken till felet.
estimated_finish	integer	Unix-tidsstämpeln (i sekunder) för när finjusteringsjobbet beräknas vara klart. Värdet är null om finjusteringsjobbet inte körs.
fine_tuned_model	string	Identifieraren (modell-ID) för den resulterande finjusterade modellen. Den här egenskapen fylls bara i för lyckade finjusterade körningar. Använd den här identifieraren för att skapa en distribution för slutsatsdragning.
finished_at	integer	En tidsstämpel när det här jobbet eller objektet har slutförts (i unix-epoker).
hyperparameters	FineTuningHyperParameters	FineTuningHyperParameters Hyperparameterinställningarna som används i ett finjusterat jobb.
id	string	Identiteten för det här objektet.
model	string	Identifieraren (modell-ID) för basmodellen som används för finjusteringen.
object	TypeDiscriminator	TypeDiscriminator Definierar typen av ett objekt.
organisation_id	string	Organisations-ID:t för detta finjusterande jobb. Används inte i Azure OpenAI. endast för OpenAI.
result_files	string[]	Resultatfilidentiteterna (fil-ID) som innehåller tränings- och utvärderingsmått i csv-format. Filen är endast tillgänglig för slutförda finjusteringskörningar.
seed	integer	Det frö som används för finjusteringsjobbet.
status	FineTuningState	FineTuningState Tillståndet för ett finjusterande objekt eller finjusteringsjobb.
suffix	string	Suffixet som används för att identifiera den finjusterade modellen. Suffixet kan innehålla upp till 40 tecken (a-z, A-Z, 0-9 och _) som läggs till i ditt finjusterade modellnamn.
trained_tokens	integer	Det totala antalet fakturerbara token som bearbetas av det här finjusteringsjobbet.
training_file	string	Filen som används för träning.
validation_file	string	Filen som används för att utvärdera den finjusterade modellen under träningen.

FineTuningJobError

Name	Typ	Description
code	string	Felkoden som kan läsas av datorn..
message	string	Det mänskliga läsbara felmeddelandet.
param	string	Parametern som var ogiltig, vanligtvis training_file eller validation_file. Det här fältet är null om felet inte var parameterspecifikt.

FineTuningState

Name	Typ	Description
cancelled	string	Åtgärden har avbrutits och är ofullständig. Den kan kategoriseras som ett terminaltillstånd.
created	string	Åtgärden skapades. Det här tillståndet returneras inte av Azure OpenAI och exponeras endast för kompatibilitet. Den kan kategoriseras som ett inaktivt tillstånd.
failed	string	Åtgärden har slutfört bearbetningen med ett fel och kan inte förbrukas ytterligare. Den kan kategoriseras som ett terminaltillstånd.
pending	string	Åtgärden har ännu inte placerats i kö för att bearbetas i framtiden. Den kan kategoriseras som ett inaktivt tillstånd.
running	string	Åtgärden har börjat bearbetas. Det kan kategoriseras som ett aktivt tillstånd.
succeeded	string	Åtgärden har bearbetats och är klar för förbrukning. Den kan kategoriseras som ett terminaltillstånd.

InnerError

Name	Typ	Description
code	InnerErrorCode	InnerErrorCode Inre felkoder enligt definitionen i Microsoft REST-riktlinjerna (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
innererror	InnerError	InnerError Inre fel enligt definitionen i Microsoft REST-riktlinjerna (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

InnerErrorCode

Name	Typ	Description
invalidPayload	string	Begärandedata är ogiltiga för den här åtgärden.

TypeDiscriminator

Name	Typ	Description
batch	string	Det här objektet representerar en batch.
file	string	Det här objektet representerar en fil.
fine_tuning.job	string	Det här objektet representerar ett finjusterat jobb.
fine_tuning.job.checkpoint	string	Det här objektet representerar en kontrollpunkt för ett finjusteringsjobb.
fine_tuning.job.event	string	Det här objektet representerar en händelse av ett finjusteringsjobb.
list	string	Det här objektet representerar en lista över andra objekt.
model	string	Det här objektet representerar en modell (kan vara en basmodell eller finjustera jobbresultatet).
upload	string	Det här objektet representerar en filuppladdning.
upload.part	string	Det här objektet representerar en del av en filuppladdning.

Dela via