Fine Tuning - Create
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 |
||
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 |
Finjusteringen har skapats. Sidhuvuden Location: string |
|
Other Status Codes |
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
POST https://aoairesource.openai.azure.com/openai/fine_tuning/jobs?api-version=2023-12-01-preview
{
"model": "curie",
"training_file": "file-181a1cbdcdcf4677ada87f63a0928099"
}
Exempelsvar
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 |
Error |
Felkod |
Error |
ErrorResponse |
Fine |
FineTuningHyperParameters |
Fine |
FineTuningJob |
Fine |
FineTuningJobCreation |
Fine |
FineTuningState |
Inner |
InnerError |
Inner |
InnerErrorCode |
Type |
TypeDiscriminator |
Error
Fel
Name | Typ | Description |
---|---|---|
code |
Felkod |
|
details |
Error[] |
Felinformationen om den är tillgänglig. |
innererror |
InnerError |
|
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
ErrorResponse
Name | Typ | Description |
---|---|---|
error |
Fel |
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ä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
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 |
|
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 |
|
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 |
|
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
FineTuningJobCreation
Name | Typ | Description |
---|---|---|
hyperparameters |
FineTuningHyperParameters |
|
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
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
InnerError
Name | Typ | Description |
---|---|---|
code |
InnerErrorCode |
|
innererror |
InnerError |
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-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). |