Dela via


Fine Tuning - Get

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-05-01-preview

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

Klart

Other Status Codes

ErrorResponse

Ett fel inträffade.

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

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

Exempelsvar

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

Felkod

ErrorResponse

ErrorResponse

FineTuningHyperParameters

FineTuningHyperParameters

FineTuningJob

FineTuningJob

FineTuningState

FineTuningState

InnerError

InnerError

InnerErrorCode

InnerErrorCode

TypeDiscriminator

TypeDiscriminator

Error

Fel

Name Typ Description
code

ErrorCode

Felkod
Felkoder som definieras 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

Felkod

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

Det går inte att utföra åtgärden i den aktuella resursens tillstånd.

ErrorResponse

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

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 en enda framåt- och bakåtpassning. 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ärningstaktsmultiplikator 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 brukar 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

FineTuningJob

Name Typ Description
created_at

integer

En tidsstämpel när det här jobbet eller objektet skapades (i unix-epoker).

fine_tuned_model

string

Identifieraren (modell-id) för den resulterande finjusterade modellen. Den här egenskapen fylls bara i för slutförda finjusteringskö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 det här finjusteringsjobbet. Oanvänd i Azure OpenAI; kompatibilitet endast för OpenAI.

result_files

string[]

Resultatfilens identiteter (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 finetuning-jobbet.

status

FineTuningState

FineTuningState
Tillståndet för ett finjusteringsobjekt 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 det finjusterade modellnamnet.

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.

FineTuningState

FineTuningState

Name Typ Description
cancelled

string

Åtgärden har avbrutits och är ofullständig. Det 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. Det kan kategoriseras som ett inaktivt tillstånd.

failed

string

Åtgärden har slutfört bearbetningen med ett fel och kan inte användas ytterligare. Det kan kategoriseras som ett terminaltillstånd.

pending

string

Åtgärden har ännu inte placerats i kö för att bearbetas i framtiden. Det 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. Det kan kategoriseras som ett terminaltillstånd.

InnerError

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

InnerErrorCode

Name Typ Description
invalidPayload

string

Begärandedata är ogiltiga för den här åtgärden.

TypeDiscriminator

TypeDiscriminator

Name Typ Description
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).