Fine Tuning - Create

Referens

Tjänst:: Azure AI Services

API-version:: 2023-12-01-preview

Skapar ett jobb som finjusterar en angiven modell från en viss träningsfil. Svaret innehåller information om det köade jobbet, inklusive jobbstatus och hyperparametrar. Namnet på den finjusterade modellen läggs till i svaret när det är klart.

POST {endpoint}/openai/fine_tuning/jobs?api-version=2023-12-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).
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.

Begärandetext

Name	Obligatorisk	Typ	Description
model	True	string	Identifieraren (modell-ID) för basmodellen som används för den här finjustera.
training_file	True	string	Filidentiteten (fil-ID) som används för att träna den här finjusterade modellen.
hyperparameters		FineTuningHyperParameters	FineTuningHyperParameters Hyperparameterinställningarna som används i ett finjusterat jobb.
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.
validation_file		string	Den filidentitet (fil-id) som används för att utvärdera den finjusterade modellen under träningen.

Svar

Name	Typ	Description
201 Created	FineTuningJob	Finjusteringen har skapats. Sidhuvuden Location: string
Other Status Codes	ErrorResponse	Ett fel inträffade.

Name

Typ

Description

201 Created

FineTuningJob

Finjusteringen har skapats.

Sidhuvuden

Location: string

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

Creating a fine tune job.

Exempelbegäran

HTTP

POST https://aoairesource.openai.azure.com/openai/fine_tuning/jobs?api-version=2023-12-01-preview


{
  "model": "curie",
  "training_file": "file-181a1cbdcdcf4677ada87f63a0928099"
}

Exempelsvar

Statuskod:: 201

location: https://aoairesource.openai.azure.com/openai/fine_tuning/jobs/ft-72a2792ef7d24ba7b82c7fe4a37e379f

{
  "hyperparameters": {
    "n_epochs": 2
  },
  "model": "curie",
  "training_file": "file-181a1cbdcdcf4677ada87f63a0928099",
  "id": "ft-72a2792ef7d24ba7b82c7fe4a37e379f",
  "status": "notRunning",
  "created_at": 1646126127,
  "updated_at": 1646127311,
  "object": "fine_tuning.job"
}

Definitioner

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

Error

Fel

Name	Typ	Description
code	ErrorCode	Felkod Felkoder enligt definitionen i Microsofts REST-riktlinjer (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 Microsofts REST-riktlinjer (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 är 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 på grund 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

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 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ärningstakten är den ursprungliga inlärningstakten som används för förträning multiplicerat med det här värdet. Större inlärningsfrekvenser tenderar att prestera 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äningsdatamängden.

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 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 finjusterade jobb. Oanvänd på Azure OpenAI; 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.
status	FineTuningState	FineTuningState Status för ett finjusterande objekt eller finjusteringsjobb.
suffix	string	Det suffix 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.
updated_at	integer	En tidsstämpel när det här jobbet eller objektet ändrades senast (i unix-epoker).
validation_file	string	Filen som används för att utvärdera den finjusterade modellen under träningen.

FineTuningJobCreation

Name	Typ	Description
hyperparameters	FineTuningHyperParameters	FineTuningHyperParameters Hyperparameterinställningarna som används i ett finjusterat jobb.
model	string	Identifieraren (modell-id) för basmodellen som används för den här finjusteringen.
suffix	string	Det suffix 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.
training_file	string	Den filidentitet (fil-ID) som används för att träna den här finjusterade modellen.
validation_file	string	Den filidentitet (fil-id) som används för att utvärdera den finjusterade modellen under träningen.

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. Det 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. 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. 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 Microsofts REST-riktlinjer (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
file	string	Det här objektet representerar en fil.
fine-tune	string	Det här objektet representerar ett finjusterat jobb.
fine-tune-event	string	Det här objektet representerar en händelse av ett finjusterat jobb.
fine_tuning.job	string	Det här objektet representerar ett finjusterat jobb.
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).

Dela via

Fine Tuning - Create

URI-parametrar

Begärandehuvud

Begärandetext

Svar

Säkerhet

api-key

Exempel

Creating a fine tune job.

Exempelbegäran

Exempelsvar

Definitioner

Error

ErrorCode

ErrorResponse

FineTuningHyperParameters

FineTuningJob

FineTuningJobCreation

FineTuningState

InnerError

InnerErrorCode

TypeDiscriminator

Ytterligare resurser