Fine Tuning - Create

Odwołanie

Usługa:: Azure AI Services

Wersja interfejsu API:: 2024-10-21

Tworzy zadanie, które dostraja określony model z danego pliku szkoleniowego. Odpowiedź zawiera szczegóły zadania w kolejce, w tym stan zadania i parametry hyper. Nazwa dostrojonego modelu jest dodawana do odpowiedzi po zakończeniu.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
endpoint	path	True	string url	Obsługiwane punkty końcowe usług Cognitive Services (protokół i nazwa hosta, na przykład: https://aoairesource.openai.azure.com. Zastąp ciąg "aoairesource" nazwą konta usługi Azure OpenAI.
api-version	query	True	string	Żądana wersja interfejsu API.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
api-key	True	string	Tutaj podaj klucz konta usługi Azure OpenAI w usługach Cognitive Services.

Treść żądania

Nazwa	Wymagane	Typ	Opis
model	True	string	Identyfikator (model-id) modelu podstawowego używanego na potrzeby tej precyzyjnej melodii.
training_file	True	string	Tożsamość pliku (identyfikator pliku), która jest używana do trenowania tego dobrze dostosowanego modelu.
hyperparameters		FineTuningHyperParameters	FineTuningHyperParameters Ustawienia parametrów hyper używane w zadaniu dostrajania.
seed		integer	Nasion używany do pracy dostrajania. Przekazywanie tych samych parametrów inicjacji i zadania powinno generować te same wyniki, ale może się różnić w rzadkich przypadkach. Jeśli inicjator nie zostanie określony, zostanie on wygenerowany.
suffix		string	Sufiks używany do identyfikowania dostosowanego modelu. Sufiks może zawierać maksymalnie 40 znaków (a-z, A-Z, 0-9 i _), które zostaną dodane do nazwy dostosowanego modelu.
validation_file		string	Tożsamość pliku (identyfikator pliku), która jest używana do oceny dobrze dostosowanego modelu podczas trenowania.

Odpowiedzi

Nazwa	Typ	Opis
201 Created	FineTuningJob	Pomyślnie utworzono dostrojenie. Nagłówki Location: string
Other Status Codes	ErrorResponse	Wystąpił błąd.

Nazwa

Typ

Opis

201 Created

FineTuningJob

Pomyślnie utworzono dostrojenie.

Nagłówki

Location: string

Other Status Codes

ErrorResponse

Wystąpił błąd.

Zabezpieczenia

api-key

Tutaj podaj klucz konta usługi Azure OpenAI w usługach Cognitive Services.

Typ: apiKey
W: header

Przykłady

Creating a fine tuning job.

Przykładowe żądanie

HTTP

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


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

Przykładowa odpowiedź

Kod stanu:: 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"
}

Definicje

Nazwa	Opis
Error	Błąd
ErrorCode	Kod błędu
ErrorResponse	ErrorResponse
FineTuningHyperParameters	FineTuningHyperParameters
FineTuningJob	FineTuningJob
FineTuningJobCreation	FineTuningJobCreation
FineTuningJobError	FineTuningJobError
FineTuningState	FineTuningState
InnerError	InnerError
InnerErrorCode	InnerErrorCode
TypeDiscriminator	TypeDiscriminator

Error

Błąd

Nazwa	Typ	Opis
code	ErrorCode	Kod błędu Kody błędów zdefiniowane w wytycznych REST firmy Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
details	Error[]	Szczegóły błędu, jeśli są dostępne.
innererror	InnerError	InnerError Błąd wewnętrzny zdefiniowany w wytycznych REST firmy Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
message	string	Komunikat o tym błędzie.
target	string	Lokalizacja, w której wystąpił błąd, jeśli jest dostępny.

ErrorCode

Kod błędu

Nazwa	Typ	Opis
conflict	string	Żądana operacja powoduje konflikt z bieżącym stanem zasobu.
contentFilter	string	Generowanie obrazu nie powiodło się w wyniku naszego systemu bezpieczeństwa.
fileImportFailed	string	Importowanie pliku nie powiodło się.
forbidden	string	Operacja jest zabroniona dla bieżącego klucza użytkownika/interfejsu API.
internalFailure	string	Błąd wewnętrzny. Ponów próbę.
invalidPayload	string	Dane żądania są nieprawidłowe dla tej operacji.
itemDoesAlreadyExist	string	Element już istnieje.
jsonlValidationFailed	string	Sprawdzanie poprawności danych jsonl nie powiodło się.
notFound	string	Nie można odnaleźć zasobu.
quotaExceeded	string	Przekroczono limit przydziału.
serviceUnavailable	string	Usługa jest obecnie niedostępna.
tooManyRequests	string	Zbyt wiele żądań. Spróbuj ponownie później.
unauthorized	string	Bieżący klucz użytkownika/interfejsu API nie jest autoryzowany dla operacji.
unexpectedEntityState	string	Nie można wykonać operacji w stanie bieżącego zasobu.

ErrorResponse

Nazwa	Typ	Opis
error	Error	Błąd Zawartość błędu zdefiniowana w wytycznych REST firmy Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

FineTuningHyperParameters

Nazwa	Typ	Opis
batch_size	integer	Rozmiar partii do użycia do trenowania. Rozmiar partii to liczba przykładów trenowania używanych do trenowania pojedynczego przebiegu do przodu i do tyłu. Ogólnie rzecz biorąc, odkryliśmy, że większe rozmiary partii zwykle działają lepiej w przypadku większych zestawów danych. Wartość domyślna, a także maksymalna wartość tej właściwości są specyficzne dla modelu podstawowego.
learning_rate_multiplier	number	Mnożnik szybkości nauki używany do trenowania. Współczynnik dostrajania uczenia to oryginalny współczynnik uczenia używany do wstępnego trenowania pomnożonego przez tę wartość. Większe wskaźniki uczenia się mają tendencję do lepszej pracy z większymi rozmiarami partii. Zalecamy eksperymentowanie z wartościami z zakresu od 0,02 do 0,2, aby zobaczyć, co daje najlepsze wyniki.
n_epochs	integer	Liczba epok trenowania modelu dla. Epoka odnosi się do jednego pełnego cyklu za pośrednictwem zestawu danych trenowania.

FineTuningJob

Nazwa	Typ	Opis
created_at	integer	Sygnatura czasowa utworzenia tego zadania lub elementu (w epokach unix).
error	FineTuningJobError	FineTuningJobError W przypadku zadań dostrajania, które zakończyły się niepowodzeniem, będzie to zawierać więcej informacji na temat przyczyny awarii.
estimated_finish	integer	Sygnatura czasowa systemu Unix (w sekundach) dla momentu zakończenia zadania dostrajania. Wartość będzie mieć wartość null, jeśli zadanie dostrajania szczegółowego nie jest uruchomione.
fine_tuned_model	string	Identyfikator (model-id) wynikowego, dostosowanego modelu. Ta właściwość jest wypełniana tylko dla pomyślnie ukończonych przebiegów dostosowywania. Użyj tego identyfikatora, aby utworzyć wdrożenie na potrzeby wnioskowania.
finished_at	integer	Sygnatura czasowa pomyślnego zakończenia tego zadania lub elementu (w epokach unix).
hyperparameters	FineTuningHyperParameters	FineTuningHyperParameters Ustawienia parametrów hyper używane w zadaniu dostrajania.
id	string	Tożsamość tego elementu.
model	string	Identyfikator (model-id) modelu podstawowego używanego do dostosowania.
object	TypeDiscriminator	TypeDiscriminator Definiuje typ obiektu.
organisation_id	string	Identyfikator organizacji tej dobrze dostrojonej pracy. Nieużywane w usłudze Azure OpenAI; zgodność tylko z funkcją OpenAI.
result_files	string[]	Tożsamości plików wynikowych (file-id) zawierające metryki trenowania i oceny w formacie csv. Plik jest dostępny tylko dla pomyślnie ukończonych przebiegów dostosowywania.
seed	integer	Nasion używany do pracy dostrajania.
status	FineTuningState	FineTuningState Stan obiektu finetunes lub zadania dostrajania.
suffix	string	Sufiks używany do identyfikowania dostosowanego modelu. Sufiks może zawierać maksymalnie 40 znaków (a-z, A-Z, 0-9 i _), które zostaną dodane do nazwy dostosowanego modelu.
trained_tokens	integer	Łączna liczba rozliczanych tokenów przetworzonych przez to zadanie dostrajania.
training_file	string	Plik, który jest używany do trenowania.
validation_file	string	Plik, który jest używany do oceny dobrze dostosowanego modelu podczas trenowania.

FineTuningJobCreation

Nazwa	Typ	Opis
hyperparameters	FineTuningHyperParameters	FineTuningHyperParameters Ustawienia parametrów hyper używane w zadaniu dostrajania.
model	string	Identyfikator (model-id) modelu podstawowego używanego na potrzeby tej precyzyjnej melodii.
seed	integer	Nasion używany do pracy dostrajania. Przekazywanie tych samych parametrów inicjacji i zadania powinno generować te same wyniki, ale może się różnić w rzadkich przypadkach. Jeśli inicjator nie zostanie określony, zostanie on wygenerowany.
suffix	string	Sufiks używany do identyfikowania dostosowanego modelu. Sufiks może zawierać maksymalnie 40 znaków (a-z, A-Z, 0-9 i _), które zostaną dodane do nazwy dostosowanego modelu.
training_file	string	Tożsamość pliku (identyfikator pliku), która jest używana do trenowania tego dobrze dostosowanego modelu.
validation_file	string	Tożsamość pliku (identyfikator pliku), która jest używana do oceny dobrze dostosowanego modelu podczas trenowania.

FineTuningJobError

Nazwa	Typ	Opis
code	string	Kod błędu z możliwością odczytu maszyny.
message	string	Czytelny dla człowieka komunikat o błędzie.
param	string	Parametr, który był nieprawidłowy, zwykle training_file lub validation_file. To pole będzie miało wartość null, jeśli błąd nie był specyficzny dla parametru.

FineTuningState

Nazwa	Typ	Opis
cancelled	string	Operacja została anulowana i jest niekompletna. Można go podzielić na stan terminalu.
created	string	Operacja została utworzona. Ten stan nie jest zwracany przez usługę Azure OpenAI i uwidaczniany tylko pod kątem zgodności. Można go sklasyfikować jako stan nieaktywny.
failed	string	Operacja zakończyła przetwarzanie z powodu błędu i nie może być jeszcze bardziej zużywana. Można go podzielić na stan terminalu.
pending	string	Operacja nie jest jeszcze w kolejce do przetworzenia w przyszłości. Można go sklasyfikować jako stan nieaktywny.
running	string	Operacja została rozpoczęta do przetworzenia. Można go sklasyfikować jako aktywny stan.
succeeded	string	Operacja została pomyślnie przetworzona i jest gotowa do użycia. Można go podzielić na stan terminalu.

InnerError

Nazwa	Typ	Opis
code	InnerErrorCode	InnerErrorCode Wewnętrzne kody błędów zdefiniowane w wytycznych REST firmy Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
innererror	InnerError	InnerError Błąd wewnętrzny zdefiniowany w wytycznych REST firmy Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

InnerErrorCode

Nazwa	Typ	Opis
invalidPayload	string	Dane żądania są nieprawidłowe dla tej operacji.

TypeDiscriminator

Nazwa	Typ	Opis
batch	string	Ten obiekt reprezentuje partię.
file	string	Ten obiekt reprezentuje plik.
fine_tuning.job	string	Ten obiekt reprezentuje zadanie dostrajania.
fine_tuning.job.checkpoint	string	Ten obiekt reprezentuje punkt kontrolny zadania dostrajania.
fine_tuning.job.event	string	Ten obiekt reprezentuje zdarzenie zadania dostrajania.
list	string	Ten obiekt reprezentuje listę innych obiektów.
model	string	Ten obiekt reprezentuje model (może być modelem bazowym lub dostrajać wynik zadania).
upload	string	Ten obiekt reprezentuje przekazywanie pliku.
upload.part	string	Ten obiekt reprezentuje część przekazywania plików.

Udostępnij za pośrednictwem

Fine Tuning - Create

Parametry identyfikatora URI

Nagłówek żądania

Treść żądania

Odpowiedzi

Zabezpieczenia

api-key

Przykłady

Creating a fine tuning job.

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

Error

ErrorCode

ErrorResponse

FineTuningHyperParameters

FineTuningJob

FineTuningJobCreation

FineTuningJobError

FineTuningState

InnerError

InnerErrorCode

TypeDiscriminator

Dodatkowe zasoby