Fine Tuning - List

Odwołanie

Usługa:: Azure AI Services

Wersja interfejsu API:: 2024-10-21

Pobiera listę wszystkich zadań dostrajania należących do zasobu usługi Azure OpenAI. Szczegóły zwracane dla każdego zadania dostrajania zawierają oprócz jego identyfikatora podstawowy model, pliki trenowania i walidacji, parametry funkcji hyper, sygnatury czasowe, stan i zdarzenia. Zdarzenia są tworzone po zmianie stanu zadania, np. uruchomieniu lub zakończeniu, oraz po przekazaniu wyników.

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

Z parametrami opcjonalnymi:

GET {endpoint}/openai/fine_tuning/jobs?after={after}&limit={limit}&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.
after	query		string	Identyfikator ostatniego zdarzenia z poprzedniego żądania stronicowania.
limit	query		integer int32	Liczba zdarzeń do pobrania. Wartość domyślna to 20.

Nagłówek żądania

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

Odpowiedzi

Nazwa	Typ	Opis
200 OK	FineTuningJobList	Sukces
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

Getting all fine tuning jobs owned by this account.

Przykładowe żądanie

HTTP

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

Przykładowa odpowiedź

Kod stanu:: 200

{
  "has_more": false,
  "data": [
    {
      "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"
    }
  ],
  "object": "list"
}

Definicje

Nazwa	Opis
Error	Błąd
ErrorCode	Kod błędu
ErrorResponse	ErrorResponse
FineTuningHyperParameters	FineTuningHyperParameters
FineTuningJob	FineTuningJob
FineTuningJobError	FineTuningJobError
FineTuningJobList	FineTuningJobList
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.

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.

FineTuningJobList

Nazwa	Typ	Opis
data	FineTuningJob[]	Lista elementów.
has_more	boolean	Wartość wskazująca, czy lista zawiera więcej elementów niż zwracane.
object	TypeDiscriminator	TypeDiscriminator Definiuje typ obiektu.

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