Models - List

Odwołanie

Service:: Azure AI Services

API Version:: 2024-02-01

Pobiera listę wszystkich modeli, które są dostępne dla zasobu usługi Azure OpenAI. Obejmują one modele podstawowe, a także wszystkie pomyślnie dostosowane modele należące do zasobu usługi Azure OpenAI.

GET {endpoint}/openai/models?api-version=2024-02-01

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.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ModelList	Powodzenie
Other Status Codes	ErrorResponse	Wystąpił błąd.

Zabezpieczenia

api-key

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

Type: apiKey
In: header

Przykłady

Getting all models owned by account.

Sample Request

HTTP

GET https://aoairesource.openai.azure.com/openai/models?api-version=2024-02-01

Sample Response

Status code:: 200

{
  "data": [
    {
      "capabilities": {
        "fine_tune": true,
        "inference": true,
        "completion": true,
        "chat_completion": false,
        "embeddings": false
      },
      "lifecycle_status": "generally-available",
      "deprecation": {
        "fine_tune": 1677662127,
        "inference": 1709284527
      },
      "id": "curie",
      "status": "succeeded",
      "created_at": 1646126127,
      "object": "model"
    },
    {
      "model": "curie",
      "fine_tune": "ft-72a2792ef7d24ba7b82c7fe4a37e379f",
      "capabilities": {
        "fine_tune": false,
        "inference": true,
        "completion": true,
        "chat_completion": false,
        "embeddings": false
      },
      "lifecycle_status": "generally-available",
      "deprecation": {
        "inference": 1709284527
      },
      "id": "curie.ft-72a2792ef7d24ba7b82c7fe4a37e379f",
      "status": "succeeded",
      "created_at": 1646126127,
      "object": "model"
    }
  ],
  "object": "list"
}

Definicje

Nazwa	Opis
Capabilities	Możliwości
Deprecation	Przestarzałe
Error	Błąd
ErrorCode	ErrorCode
ErrorResponse	ErrorResponse
FineTuningState	FineTuningState
InnerError	Błąd wewnętrzny
InnerErrorCode	InnerErrorCode
LifeCycleStatus	LifeCycleStatus
Model	Model
ModelList	Lista modeli
TypeDiscriminator	TypeDiscriminator

Capabilities

Możliwości

Nazwa	Typ	Opis
chat_completion	boolean	Wartość wskazująca, czy model obsługuje uzupełnianie czatu.
completion	boolean	Wartość wskazująca, czy model obsługuje uzupełnianie.
embeddings	boolean	Wartość wskazująca, czy model obsługuje osadzanie.
fine_tune	boolean	Wartość wskazująca, czy model może być używany do dostrajania.
inference	boolean	Wartość wskazująca, czy można wdrożyć model.

Deprecation

Przestarzałe

Nazwa	Typ	Opis
fine_tune	integer	Data zakończenia dostrajania obsługi tego modelu. Będzie przeznaczony `null` do precyzyjnego dostrajania modeli.
inference	integer	Data zakończenia obsługi wnioskowania tego modelu.

Error

Błąd

Nazwa	Typ	Opis
code	ErrorCode	ErrorCode Kody błędów zgodnie z definicją 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	Błąd wewnętrzny Błąd wewnętrzny zgodnie z definicją 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

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. Spróbuj ponownie.
invalidPayload	string	Dane żądania są nieprawidłowe dla tej operacji.
itemDoesAlreadyExist	string	Element już istnieje.
jsonlValidationFailed	string	Weryfikacja danych jsonl nie powiodła 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 DOTYCZĄCYCH REST firmy Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

FineTuningState

Nazwa	Typ	Opis
cancelled	string	Operacja została anulowana i jest niekompletna. Można go sklasyfikować jako stan terminalu.
created	string	Operacja została utworzona. Ten stan nie jest zwracany przez usługę Azure OpenAI i uwidaczniany tylko w celu zachowania 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 sklasyfikować jako 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 stan aktywny.
succeeded	string	Operacja została pomyślnie przetworzona i jest gotowa do użycia. Można go sklasyfikować jako stan terminalu.

InnerError

Błąd wewnętrzny

Nazwa	Typ	Opis
code	InnerErrorCode	InnerErrorCode Kody błędów wewnętrznych zgodnie z definicją w wytycznych rest firmy Microsoft (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
innererror	InnerError	Błąd wewnętrzny Błąd wewnętrzny zgodnie z definicją 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.

LifeCycleStatus

Nazwa	Typ	Opis
generally-available	string	Model jest ogólnie dostępny.
preview	string	Model jest w wersji zapoznawczej i jest objęty warunkami wersji zapoznawczej usługi.

Model

Nazwa	Typ	Opis
capabilities	Capabilities	Możliwości Możliwości podstawowego lub precyzyjnego modelu dostrajania.
created_at	integer	Sygnatura czasowa utworzenia tego zadania lub elementu (w epokach unix).
deprecation	Deprecation	Przestarzałe Definiuje daty wycofania dla różnych przypadków użycia modelu. Zazwyczaj modele podstawowe obsługują 1 rok dostrajania po utworzeniu. Wnioskowanie jest zwykle obsługiwane 2 lata po utworzeniu podstawowych lub dostrojonych modeli. Dokładne daty są określone we właściwościach.
fine_tune	string	Dostrajanie tożsamości zadania (fine-tune-id), jeśli jest to precyzyjny model dostrajania; w przeciwnym razie `null`.
id	string	Tożsamość tego elementu.
lifecycle_status	LifeCycleStatus	LifeCycleStatus Stan cyklu życia modelu. Uwaga: model może być promowany z wersji zapoznawczej do "ogólnie dostępnej", ale nigdy z "ogólnie dostępnej" do "wersji zapoznawczej".
model	string	Tożsamość modelu podstawowego (model-id), jeśli jest to model dostrajania; w przeciwnym razie `null`.
object	TypeDiscriminator	TypeDiscriminator Definiuje typ obiektu.
status	FineTuningState	FineTuningState Stan obiektu finetunes lub zadania dostrajania.

ModelList

Lista modeli

Nazwa	Typ	Opis
data	Model[]	Lista elementów.
object	TypeDiscriminator	TypeDiscriminator Definiuje typ obiektu.

TypeDiscriminator

Nazwa	Typ	Opis
file	string	Ten obiekt reprezentuje plik.
fine-tune	string	Ten obiekt reprezentuje zadanie dostrajania.
fine-tune-event	string	Ten obiekt reprezentuje zdarzenie zadania dostrajania.
fine_tuning.job	string	Ten obiekt reprezentuje zadanie 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 podstawowym lub dostroić wynik zadania).

Share via