Fine Tuning - Create

Reference

Služba:: Azure AI Services

Verze rozhraní API:: 2024-10-21

Vytvoří úlohu, která jemně naladí zadaný model z daného trénovacího souboru. Odpověď obsahuje podrobnosti o výčtové úloze, včetně stavu úlohy a parametrů hyper. Po dokončení se do odpovědi přidá název jemně vyladěného modelu.

POST {endpoint}/openai/fine_tuning/jobs?api-version=2024-10-21

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
endpoint	path	True	string url	Podporované koncové body služeb Cognitive Services (protokol a název hostitele, například: https://aoairesource.openai.azure.com. Nahraďte "aoairesource" názvem účtu Azure OpenAI).
api-version	query	True	string	Požadovaná verze rozhraní API.

Hlavička požadavku

Name	Vyžadováno	Typ	Description
api-key	True	string	Tady zadejte svůj klíč účtu Azure OpenAI služeb Cognitive Services.

Text požadavku

Name	Vyžadováno	Typ	Description
model	True	string	Identifikátor (ID modelu) základního modelu, který se používá pro tuto vyladění.
training_file	True	string	Identita souboru (ID souboru), která se používá k trénování tohoto jemně vyladěného modelu.
hyperparameters		FineTuningHyperParameters	FineTuningHyperParameters Nastavení hyperparametru použitého v úloze vyladění.
seed		integer	Počáteční náprsní práce. Předání stejných počátečních parametrů a parametrů úlohy by mělo vést ke stejným výsledkům, ale ve výjimečných případech se může lišit. Pokud není zadaná počáteční hodnota, vygeneruje se za vás.
suffix		string	Přípona použitá k identifikaci jemně vyladěného modelu. Přípona může obsahovat až 40 znaků (a-z, A-Z, 0-9 a _), které se přidají do vašeho jemně vyladěného názvu modelu.
validation_file		string	Identita souboru (ID souboru), která se používá k vyhodnocení jemně vyladěného modelu během trénování.

Odpovědi

Name	Typ	Description
201 Created	FineTuningJob	Vyladění bylo úspěšně vytvořeno. Hlavičky Location: string
Other Status Codes	ErrorResponse	Došlo k chybě.

Name

Typ

Description

201 Created

FineTuningJob

Vyladění bylo úspěšně vytvořeno.

Hlavičky

Location: string

Other Status Codes

ErrorResponse

Došlo k chybě.

Zabezpečení

api-key

Tady zadejte svůj klíč účtu Azure OpenAI služeb Cognitive Services.

Typ: apiKey
V: header

Příklady

Creating a fine tuning job.

Ukázkový požadavek

HTTP

POST https://aoairesource.openai.azure.com/openai/fine_tuning/jobs?api-version=2024-10-21


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

Ukázková odpověď

Stavový kód:: 201

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

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

Definice

Name	Description
Error	Chyba
ErrorCode	Kód chyby
ErrorResponse	ErrorResponse
FineTuningHyperParameters	FineTuningHyperParameters
FineTuningJob	FineTuningJob
FineTuningJobCreation	FineTuningJobCreation
FineTuningJobError	FineTuningJobError
FineTuningState	FineTuningState
InnerError	Vnitřní chyba
InnerErrorCode	InnerErrorCode
TypeDiscriminator	Type Nábídka

Error

Chyba

Name	Typ	Description
code	ErrorCode	Kód chyby Kódy chyb definované v pokynech microsoft REST (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
details	Error[]	Podrobnosti o chybě, pokud jsou k dispozici.
innererror	InnerError	Vnitřní chyba Vnitřní chyba definovaná v pokynech microsoft REST (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
message	string	Zpráva o této chybě.
target	string	Umístění, kde k chybě došlo, pokud je k dispozici.

ErrorCode

Kód chyby

Name	Typ	Description
conflict	string	Požadovaná operace je v konfliktu s aktuálním stavem prostředku.
contentFilter	string	Generování obrázků selhalo v důsledku našeho bezpečnostního systému.
fileImportFailed	string	Import souboru se nezdařil.
forbidden	string	Operace je zakázaná pro aktuální klíč uživatele nebo rozhraní API.
internalFailure	string	Vnitřní chyba. Zkuste to prosím znovu.
invalidPayload	string	Data požadavku jsou pro tuto operaci neplatná.
itemDoesAlreadyExist	string	Položka již existuje.
jsonlValidationFailed	string	Ověření dat jsonl se nezdařilo.
notFound	string	Prostředek nebyl nalezen.
quotaExceeded	string	Kvóta byla překročena.
serviceUnavailable	string	Služba není aktuálně dostupná.
tooManyRequests	string	Příliš mnoho požadavků. Zkuste to prosím znovu později.
unauthorized	string	Aktuální klíč uživatele nebo rozhraní API není pro operaci autorizovaný.
unexpectedEntityState	string	Operaci nelze spustit ve stavu aktuálního prostředku.

ErrorResponse

Name	Typ	Description
error	Error	Chyba Obsah chyby definovaný v pokynech microsoft REST (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

FineTuningHyperParameters

Name	Typ	Description
batch_size	integer	Velikost dávky, která se má použít pro trénování. Velikost dávky je počet trénovacích příkladů, které se používají k trénování jednoho dopředu a dozadu. Obecně jsme zjistili, že větší velikosti dávek obvykle fungují lépe u větších datových sad. Výchozí hodnota a maximální hodnota této vlastnosti jsou specifické pro základní model.
learning_rate_multiplier	number	Násobitel rychlosti učení, který se má použít pro trénování. Míra doladění je původní míra učení používaná pro předtrénování vynásobenou touto hodnotou. Větší rychlost učení obvykle funguje lépe s většími velikostmi dávek. Doporučujeme experimentovat s hodnotami v rozsahu 0,02 až 0,2, abyste zjistili, co vede k dosažení nejlepších výsledků.
n_epochs	integer	Počet epoch pro trénování modelu. Epocha odkazuje na jeden celý cyklus prostřednictvím trénovací datové sady.

FineTuningJob

Name	Typ	Description
created_at	integer	Časové razítko při vytvoření této úlohy nebo položky (v epochách unixu)
error	FineTuningJobError	FineTuningJobError U úloh, které selhaly, se dolaďují, bude obsahovat další informace o příčině selhání.
estimated_finish	integer	Časové razítko unixu (v sekundách) pro dobu, kdy se odhaduje dokončení úlohy jemného ladění. Hodnota bude null, pokud není spuštěna úloha jemného ladění.
fine_tuned_model	string	Identifikátor (ID modelu) výsledného jemně vyladěného modelu. Tato vlastnost se vyplní pouze pro úspěšně dokončená spuštění vyladění. Tento identifikátor použijte k vytvoření nasazení pro odvozování.
finished_at	integer	Časové razítko po úspěšném dokončení této úlohy nebo položky (v epochách unixu)
hyperparameters	FineTuningHyperParameters	FineTuningHyperParameters Nastavení hyperparametru použitého v úloze vyladění.
id	string	Identita této položky.
model	string	Identifikátor (ID modelu) základního modelu, který se používá pro vyladění.
object	TypeDiscriminator	Type Nábídka Definuje typ objektu.
organisation_id	string	ID organizace této vyladěné práce. Nepoužívá se v Azure OpenAI; pouze pro OpenAI.
result_files	string[]	Identity výsledného souboru (id souboru) obsahující trénovací a vyhodnocovací metriky ve formátu CSV. Soubor je k dispozici pouze pro úspěšně dokončená spuštění dolaďování.
seed	integer	Počáteční náprsní práce.
status	FineTuningState	FineTuningState Stav jemně vyladěného objektu nebo jemného ladění.
suffix	string	Přípona použitá k identifikaci jemně vyladěného modelu. Přípona může obsahovat až 40 znaků (a-z, A-Z, 0-9 a _), které se přidají do vašeho jemně vyladěného názvu modelu.
trained_tokens	integer	Celkový počet fakturovatelnýchtokench
training_file	string	Soubor, který se používá pro trénování.
validation_file	string	Soubor, který se používá k vyhodnocení jemně vyladěného modelu během trénování.

FineTuningJobCreation

Name	Typ	Description
hyperparameters	FineTuningHyperParameters	FineTuningHyperParameters Nastavení hyperparametru použitého v úloze vyladění.
model	string	Identifikátor (ID modelu) základního modelu, který se používá pro tuto vyladění.
seed	integer	Počáteční náprsní práce. Předání stejných počátečních parametrů a parametrů úlohy by mělo vést ke stejným výsledkům, ale ve výjimečných případech se může lišit. Pokud není zadaná počáteční hodnota, vygeneruje se za vás.
suffix	string	Přípona použitá k identifikaci jemně vyladěného modelu. Přípona může obsahovat až 40 znaků (a-z, A-Z, 0-9 a _), které se přidají do vašeho jemně vyladěného názvu modelu.
training_file	string	Identita souboru (ID souboru), která se používá k trénování tohoto jemně vyladěného modelu.
validation_file	string	Identita souboru (ID souboru), která se používá k vyhodnocení jemně vyladěného modelu během trénování.

FineTuningJobError

Name	Typ	Description
code	string	Strojově čitelný kód chyby.
message	string	Chybová zpráva čitelná pro člověka
param	string	Parametr, který byl neplatný, obvykle training_file nebo validation_file. Pokud selhání nebylo specifické pro parametr, bude toto pole null.

FineTuningState

Name	Typ	Description
cancelled	string	Operace byla zrušena a je neúplná. Může být kategorizován jako stav terminálu.
created	string	Operace byla vytvořena. Azure OpenAI tento stav nevrátá a z důvodu kompatibility je vystavený. Může být kategorizován jako neaktivní stav.
failed	string	Operace dokončila zpracování s chybou a nelze ji dále využívat. Může být kategorizován jako stav terminálu.
pending	string	Operace ještě není zařazena do fronty ke zpracování v budoucnu. Může být kategorizován jako neaktivní stav.
running	string	Operace se začala zpracovávat. Může být kategorizován jako aktivní stav.
succeeded	string	Operace byla úspěšně zpracována a je připravená k použití. Může být kategorizován jako stav terminálu.

InnerError

Vnitřní chyba

Name	Typ	Description
code	InnerErrorCode	InnerErrorCode Vnitřní kódy chyb definované v pokynech microsoft REST (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
innererror	InnerError	Vnitřní chyba Vnitřní chyba definovaná v pokynech microsoft REST (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

InnerErrorCode

Name	Typ	Description
invalidPayload	string	Data požadavku jsou pro tuto operaci neplatná.

TypeDiscriminator

Type Nábídka

Name	Typ	Description
batch	string	Tento objekt představuje dávku.
file	string	Tento objekt představuje soubor.
fine_tuning.job	string	Tento objekt představuje doladění úlohy.
fine_tuning.job.checkpoint	string	Tento objekt představuje kontrolní bod úlohy jemného ladění.
fine_tuning.job.event	string	Tento objekt představuje událost úlohy jemného ladění.
list	string	Tento objekt představuje seznam dalších objektů.
model	string	Tento objekt představuje model (může to být základní model nebo vyladění výsledku úlohy).
upload	string	Tento objekt představuje nahrání souboru.
upload.part	string	Tento objekt představuje část nahrávání souboru.

Sdílet prostřednictvím

Fine Tuning - Create

Parametry identifikátoru URI

Hlavička požadavku

Text požadavku

Odpovědi

Zabezpečení

api-key

Příklady

Creating a fine tuning job.

Ukázkový požadavek

Ukázková odpověď

Definice

Error

ErrorCode

ErrorResponse

FineTuningHyperParameters

FineTuningJob

FineTuningJobCreation

FineTuningJobError

FineTuningState

InnerError

InnerErrorCode

TypeDiscriminator

Další materiály