Elenco modelli

Ottieni un elenco di tutti i modelli di IA accessibili all’utente corrente, inclusi ID modello, nomi, provider e informazioni dettagliate.

Informazioni su elenco modelli e gruppi di token

I modelli restituiti nell’elenco dipendono dal gruppo di token a cui appartiene la tua API KEY. Puoi selezionare il gruppo di token quando crei o modifichi i token in Console → API Tokens.

Endpoint

GET https://aiberm.com/v1/models

Esempio di richiesta

1curl -X GET "https://aiberm.com/v1/models" \
2-H "Authorization: Bearer sk-your-api-token-here" \
3-H "Content-Type: application/json"

Formato della risposta

Risposta di successo (200 OK)

1{
2"success": true,
3"data": [
4 {
5 "id": "gpt-4",
6 "object": "model",
7 "created": 1626777600,
8 "owned_by": "openai",
9 "supported_endpoint_types": [
10 "chat",
11 "completion"
12 ]
13 },
14 {
15 "id": "gpt-3.5-turbo",
16 "object": "model",
17 "created": 1626777600,
18 "owned_by": "openai",
19 "supported_endpoint_types": [
20 "chat",
21 "completion"
22 ]
23 },
24 {
25 "id": "claude-3-sonnet-20240229",
26 "object": "model",
27 "created": 1626777600,
28 "owned_by": "anthropic",
29 "supported_endpoint_types": [
30 "chat"
31 ]
32 }
33]
34}

Campi della risposta

Campi di primo livello:

  • success - Booleano, indica se la richiesta è andata a buon fine
  • data - Array di oggetti modello (restituito solo in caso di successo)
  • message - Messaggio di errore (restituito solo in caso di fallimento)

Campi dell’oggetto modello:

  • id - Identificatore univoco del modello
  • object - Tipo di oggetto, fisso come “model”
  • created - Timestamp di creazione del modello
  • owned_by - Provider del modello (ad es. openai, anthropic)
  • supported_endpoint_types - Array dei tipi di endpoint API supportati

Tipi di endpoint supportati

  • chat - Completamento chat
  • completion - Completamento testo
  • embedding - Embedding di testo
  • image - Generazione immagini
  • audio - Elaborazione audio
  • rerank - Rerank

Note importanti

Autenticazione obbligatoria

Deve essere fornito un token API valido. Il token determina a quali modelli l’utente può accedere.

Controllo dei permessi

L’elenco dei modelli restituito è filtrato in base ai gruppi utente e ai gruppi di token, mostrando solo i modelli a cui l’utente ha il permesso di accedere.

Errori comuni

  • 401 Unauthorized - Il token API non è valido o è scaduto
  • 403 Forbidden - L’utente non ha il permesso di accesso
  • 500 Internal Server Error - Errore interno del server