Models - List

Riferimento

Servizio:: Azure AI Services

Versione API:: 2024-10-21

Ottiene un elenco di tutti i modelli accessibili dalla risorsa OpenAI di Azure. Questi includono modelli di base e tutti i modelli ottimizzati completati correttamente di proprietà della risorsa OpenAI di Azure.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
endpoint	path	True	string url	Endpoint di Servizi cognitivi supportati (protocollo e nome host, ad esempio: https://aoairesource.openai.azure.com. Sostituire "aoairesource" con il nome dell'account Azure OpenAI.
api-version	query	True	string	Versione dell'API richiesta.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
api-key	True	string	Specificare qui la chiave dell'account OpenAI di Servizi cognitivi di Azure.

Risposte

Nome	Tipo	Descrizione
200 OK	ModelList	Successo
Other Status Codes	ErrorResponse	Si è verificato un errore.

Sicurezza

api-key

Specificare qui la chiave dell'account OpenAI di Servizi cognitivi di Azure.

Tipo: apiKey
In: header

Esempio

Getting all models owned by account.

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:: 200

{
  "data": [
    {
      "status": "succeeded",
      "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",
      "created_at": 1646126127,
      "object": "model"
    },
    {
      "status": "succeeded",
      "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",
      "created_at": 1646126127,
      "object": "model"
    }
  ],
  "object": "list"
}

Definizioni

Nome	Descrizione
Capabilities	Funzionalità
Deprecation	Disapprovazione
Error	Errore
ErrorCode	ErrorCode
ErrorResponse	ErrorResponse
FineTuningState	FineTuningState
InnerError	InnerError
InnerErrorCode	InnerErrorCode
LifeCycleStatus	LifeCycleStatus
Model	Modello
ModelList	ModelList
TypeDiscriminator	TypeDiscriminator

Capabilities

Funzionalità

Nome	Tipo	Descrizione
chat_completion	boolean	Valore che indica se un modello supporta il completamento della chat.
completion	boolean	Valore che indica se un modello supporta il completamento.
embeddings	boolean	Valore che indica se un modello supporta gli incorporamenti.
fine_tune	boolean	Valore che indica se un modello può essere utilizzato per l'ottimizzazione.
inference	boolean	Valore che indica se è possibile distribuire un modello.

Deprecation

Disapprovazione

Nome	Tipo	Descrizione
fine_tune	integer	Data di fine del supporto di questo modello. Verranno `null` per ottimizzare i modelli.
inference	integer	Data di fine del supporto dell'inferenza di questo modello.

Error

Errore

Nome	Tipo	Descrizione
code	ErrorCode	ErrorCode Codici di errore definiti nelle linee guida di Microsoft REST (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
details	Error[]	Dettagli dell'errore, se disponibile.
innererror	InnerError	InnerError Errore interno come definito nelle linee guida di Microsoft REST (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
message	string	Messaggio di questo errore.
target	string	Posizione in cui si è verificato l'errore, se disponibile.

ErrorCode

Nome	Tipo	Descrizione
conflict	string	L'operazione richiesta è in conflitto con lo stato della risorsa corrente.
contentFilter	string	La generazione di immagini non è riuscita a causa del nostro sistema di sicurezza.
fileImportFailed	string	Importazione del file non riuscita.
forbidden	string	L'operazione non è consentita per la chiave utente/API corrente.
internalFailure	string	Errore interno. Riprovare.
invalidPayload	string	I dati della richiesta non sono validi per questa operazione.
itemDoesAlreadyExist	string	L'elemento esiste già.
jsonlValidationFailed	string	La convalida dei dati jsonl non è riuscita.
notFound	string	La risorsa non viene trovata.
quotaExceeded	string	Quota superata.
serviceUnavailable	string	Il servizio non è attualmente disponibile.
tooManyRequests	string	Troppe richieste. Riprovare più tardi.
unauthorized	string	La chiave utente/API corrente non è autorizzata per l'operazione.
unexpectedEntityState	string	L'operazione non può essere eseguita nello stato della risorsa corrente.

ErrorResponse

Nome	Tipo	Descrizione
error	Error	Errore Contenuto degli errori come definito nelle linee guida microsoft REST (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

FineTuningState

Nome	Tipo	Descrizione
cancelled	string	L'operazione è stata annullata ed è incompleta. Può essere categorizzato come stato terminale.
created	string	L'operazione è stata creata. Questo stato non viene restituito da Azure OpenAI ed esposto solo per la compatibilità. Può essere categorizzato come stato inattivo.
failed	string	L'operazione ha completato l'elaborazione con un errore e non può essere ulteriormente utilizzata. Può essere categorizzato come stato terminale.
pending	string	L'operazione non è ancora in coda da elaborare in futuro. Può essere categorizzato come stato inattivo.
running	string	L'operazione è stata avviata per l'elaborazione. Può essere categorizzato come stato attivo.
succeeded	string	L'operazione è stata elaborata correttamente ed è pronta per l'utilizzo. Può essere categorizzato come stato terminale.

InnerError

Nome	Tipo	Descrizione
code	InnerErrorCode	InnerErrorCode Codici di errore interni definiti nelle linee guida di Microsoft REST (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).
innererror	InnerError	InnerError Errore interno come definito nelle linee guida di Microsoft REST (https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses).

InnerErrorCode

Nome	Tipo	Descrizione
invalidPayload	string	I dati della richiesta non sono validi per questa operazione.

LifeCycleStatus

Nome	Tipo	Descrizione
generally-available	string	Il modello è disponibile a livello generale.
preview	string	Il modello è disponibile in anteprima e coperto dalle condizioni di anteprima del servizio.

Model

Modello

Nome	Tipo	Descrizione
capabilities	Capabilities	Funzionalità Funzionalità di un modello di base o di ottimizzazione.
created_at	integer	Timestamp quando questo processo o elemento è stato creato (in periodi UNIX).
deprecation	Deprecation	Disapprovazione Definisce le date di deprecazione per i diversi casi d'uso di un modello. I modelli di base supportano in genere 1 anno di ottimizzazione dopo la creazione. L'inferenza è in genere supportata 2 anni dopo la creazione di modelli di base o ottimizzati. Le date esatte vengono specificate nelle proprietà .
fine_tune	string	L'identità del processo di ottimizzazione (fine-tune-id) se si tratta di un modello di ottimizzazione; in caso contrario, `null`.
id	string	Identità dell'elemento.
lifecycle_status	LifeCycleStatus	LifeCycleStatus Stato del ciclo di vita di un modello. Nota: un modello può essere promosso da "anteprima" a "disponibile a livello generale", ma mai da "disponibile a livello generale" a "anteprima".
model	string	Identità del modello di base (model-id) se si tratta di un modello di ottimizzazione; in caso contrario, `null`.
object	TypeDiscriminator	TypeDiscriminator Definisce il tipo di un oggetto .
status	FineTuningState	FineTuningState Stato di un oggetto di finetunes o di un processo di ottimizzazione.

ModelList

Nome	Tipo	Descrizione
data	Model[]	Elenco di elementi.
object	TypeDiscriminator	TypeDiscriminator Definisce il tipo di un oggetto .

TypeDiscriminator

Nome	Tipo	Descrizione
batch	string	Questo oggetto rappresenta un batch.
file	string	Questo oggetto rappresenta un file.
fine_tuning.job	string	Questo oggetto rappresenta un processo di ottimizzazione.
fine_tuning.job.checkpoint	string	Questo oggetto rappresenta un checkpoint di un processo di ottimizzazione.
fine_tuning.job.event	string	Questo oggetto rappresenta un evento di un processo di ottimizzazione fine.
list	string	Questo oggetto rappresenta un elenco di altri oggetti.
model	string	Questo oggetto rappresenta un modello (può essere un modello di base o ottimizzare il risultato del processo).
upload	string	Questo oggetto rappresenta un caricamento di file.
upload.part	string	Questo oggetto rappresenta parte di un caricamento di file.

Condividi tramite